3DS Başlatma
3DS Başlatma API’si müşterinin kart ödemelerinin 3DS ile işlenmesinden sorumludur.
NON-3DS entegrasyonunda olduğu gibi;
TROY, MASTERCARD, VISA ve AMEX markalı kartlarla yapılan işlemleri destekler.
BONUS, WORLD, MAXIMUM, AXESS, CARDFINANS, PARAF, ADVANTAGE gibi taksit programlarına katılmış olan kartlara 2, 3, 6, 9 ve 12 taksit seçenekleri sunulmaktadır.
Panelde başarılı işlemler yeşil renkte, başarısız işlemler ise kırmızı renkte görüntülenir.
Üye iş yeri, conversationId ve basketId parametrelerini kendi tarafında sipariş numarası olarak kullanabilir.
Bu özellikleri birleştirerek müşterilerinize, işlemlerinin başarısı veya başarısızlığı hakkında gerçek zamanlı geri bildirim sağlayarak kusursuz bir ödeme deneyimi sağlayabilirsiniz.
3D Secure oturumu başlatır ve 3DS doğrulama için htmlContent değeri döner.
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 aXBzaWduYXR1cmU...
Content-Type değeri.
application/json
Dil kodu. Varsayılan; tr
tr
Possible values: İstek/yanıt eşleştirme ID’si.
conversationId
Sepet toplamı.
1
Tahsil edilecek nihai tutar.
1
Para birimi. Varsayılan; TRY.
TRY
Possible values: Taksit sayısı (gönderilmezse tek çekim olarak işlem gerçekleşir).
1
Possible values: Ödeme kanalı.
WEB
Possible values: Sepet ID.
basketId
Ödeme grubu. Varsayılan; PRODUCT.
PRODUCT
Possible values: 3DS işlem sonrası yönlenecek dönüş URL’si.
https://callbackurl.com
Başarılı yanıt (3DS başlatıldı)
Hatalı istek / doğrulama hatası
POST https://api.iyzipay.com/payment/3dsecure/initialize
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"locale": "tr",
"conversationId": "conversationId",
"price": 1.0,
"paidPrice": 1.0,
"currency": "TRY",
"installment": 1,
"paymentChannel": "WEB",
"basketId": "basketId",
"paymentGroup": "PRODUCT",
"callbackUrl": "callbackUrl",
"paymentCard": {
"cardHolderName": "John Doe",
"cardNumber": "5528790000000008",
"expireYear": "28",
"expireMonth": "12",
"cvc": "123"
},
"buyer": {
"id": "1",
"name": "John",
"surname": "Doe",
"identityNumber": "1234512345123125213125213",
"email": "[email protected]",
"gsmNumber": "+905350000000",
"registrationDate": "2013-04-21 15:12:09",
"lastLoginDate": "2015-10-05 12:43:35",
"registrationAddress": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
"city": "İstanbul",
"country": "Turkey",
"zipCode": "34732",
"ip": "85.34.78.112"
},
"shippingAddress": {
"address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
"zipCode": "34742",
"contactName": "Jane Doe",
"city": "Istanbul",
"country": "Turkey"
},
"billingAddress": {
"address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
"zipCode": "34742",
"contactName": "Jane Doe",
"city": "Istanbul",
"country": "Turkey"
},
"basketItems": [
{ "id": "BI101", "price": 0.4, "name": "Binocular", "category1": "Collectibles", "category2": "Accessories", "itemType": "PHYSICAL" },
{ "id": "BI102", "price": 0.3, "name": "Game code", "category1": "Game", "category2": "Online Game Items", "itemType": "VIRTUAL" },
{ "id": "BI103", "price": 0.3, "name": "Usb", "category1": "Electronics", "category2": "Usb / Cable", "itemType": "PHYSICAL" }
]
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755197726218,
"conversationId": "conversationId",
"threeDSHtmlContent": "PCFkb2N0eXBlIGh0bWw+...",
"paymentId": "25149157",
"signature": "c8964a1878f9dae20741209dea6749d16bac4a8760775ae69b0b2420d9dc024b"
}
Örnek Kodlar
Son olarak aşağıdaki başlıkları analiz ederek, ödeme sorgusunun sonucunu etkili bir şekilde yönetebilir ve yanıtlayabilirsiniz, böylece müşterileriniz için sorunsuz ve güvenilir bir ödeme süreci sağlayabilirsiniz.
status
parametresi işlemin durumu hakkında bilgi sağlar.success
, işlemin başarıyla tamamlandığını ve ödemenin işlendiğini gösterir.failure
, işlemin başarısız olduğunu belirtir ve başarısızlığın nedenine ilişkin bir hata mesajı verilir.Bu hizmet için
paymentStatus
parametresi boştur.paymentId
vepaymentTransactionId
değerleri, ileride referans noktası olarak kullanılabileceği için saklanmalıdır.Başarısız bir işlem durumunda (
failure
durumu),errorCode
,errorMessage
veerrorGroup
parametreleri, hatayla ilgili ayrıntıları sağlayarak ilgili değerlerle birlikte döndürülür.
Last updated