3D Secure İle Ödeme Alma

3D Secure ile yapılan ödemelerin tamamlanabilmesi için 2 endpoint'e istek atılması gerekmektedir.

• 3d Secure Ödeme Başlatma

• 3d Secure Ödeme Onaylama

Bu iki adımda gönderilen isteklerden herhangi birinde sorun olması durumunda ödeme tamamlanmayacaktır.

*3d Secure Ödeme Başlatma* adımda ödeme işlemi başlatılarak çekim işlemi hazır duruma getirilir.

*3d Secure Ödeme Onaylama* adımında ise ilk adımda başlatılan işlem onaylanarak ücretin tahsil edilmesi sağlanır.

URL

3d Secure Ödeme Başlatma için kullanılan endpoint ve http metod bilgisi aşağıda yer aldığı gibidir.

HTTP Metod	URL
POST	https://www.siteadi.com/api/v1/gateway/payment_3d

İstek Parametreleri

Çekim işlemleri listeleme işlemi için isteklerde gönderilmesi beklenen parametreler ve sorgu örneği aşağıda belirtilmiştir.

Parametre Adı	Tipi	Zorunlu	Açıklama
pos_alias	string	Hayır	Çekim işleminin yapılacağı pos kimliği.Gönderilmemmesi durumundayönetim panelinde yer alan veriler kullanılarak 'Akıllı Pos Yönlendirme' özelliği ile en uygun pos üzerinden çekim işlemi gerçekleştirilecektir.
card_brand	string	Hayır	Çekim işleminin yapılacağı pos'un kart ailesi bilgisidir.Bankaya air pos_alias gönderildiğinde bu parametrenin gönderilmesine gerek yoktur.Ödeme kuruluşuna ait pos_alias gönderildiğinde,birden fazla kart ailesi kayıtlı olması durumunda card_brand parametresi gönderilerek hangi kart ailesine çekim yapılacağı seçilebilir.Ödeme kuruluşu pos_alias gönderilmesine rağmen card_branc gönderilmemişse en düşük komisyonlu card_brand üzerinden işlem sağlanır.
price	decimal	Evet	Sepet tutarı.item parametresi altında yer alan tutarların toplamı ile eşit olmalıdır.
paid_price	decimal	Evet	Komisyon ve vade farkı gibi tutarlar sepet tutarına dahil edilerek gönderilmesi gereken nihai çekim tutarıdır.
installment_count	integer	Evet	Taksit sayısı.Tek çekim için 1 gönderilmelidir.
currency_type	integer	Evet	Para birimi; TRY,USD,EUR
customer_id	integer	Hayır	Ödüyo üzerindeki cari id'dir.
buyer_member_id	integer	Hayır	Üye oluşturma endpoint'i üzerinden oluşturduğunuz üyenin İd bilgisidir.
name	string	Hayır	Ödemeyi yapan müşteri adı
surname	string	Hayır	Ödemeyi yapan müşteri soyadı
client_ip	string	Evet	Ödemeyi yapan müşteri ip adresi
callback_url	string	Evet	Ödeme işlemi sonucunun bildireceği dönüş url
card	array	Evet	Ödeme işleminin yapılacağı kart bilgileridir; Parametreler -> holder_name(string) =Kart sahibi, number(integer)=Kart numarası, expiry_month(string)=Kart SKT ay,expiry_year(string)=Kart SKT yıl, cvc(string)=Kart güvenlik kodu
items	array	Evet	Ödeme işlemine dahil edilen ürün/hizmet; Parametreler -> name(string) =ürün/hizmet adı, price(decimal)=tutar,quantity(integer)=adet

Sonuç Parametreleri

Ödeme Başlatma işlemine ait detaylar data parametresi altında dizi olarak dönülmektedir.

Parametre Adı	Tipi	Açıklama
html_form	string	base64_encode ile şifrelenmiş html form bilgisi.
payment_id	integer	Başlatılan ödeme işleminin benzersiz id'si.
pos_alias	string	Ödemenin başlatıldığı pos kimlik bilgisi.
card_brand	string	İşlemin yapıldığı kart ailesi.
commission_rate	string	İşlemin yapılacağı komisyon oranı.