3DS Tamamlama
iyzico'da kayıtlı bir işlemin detayına ulaşmak için ödeme sorgulama hizmetini kullanabilirsiniz.
Servise gönderilmesi gereken parametreler aşağıdaki gibidir:
3D doğrulama tamamlandıktan sonra ödemeyi sonuçlandırır.
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: Initialize çağrısından dönen ödeme ID’si.
25149157
İstek/yanıt eşleştirme ID’si.
conversationId
3DS sonucunda post edilen data. Dolu dönerse gönderilmesi zorunludur.
Başarılı yanıt (ödeme tamamlandı)
Hatalı istek / doğrulama hatası
POST https://api.iyzipay.com/payment/3dsecure/auth
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"locale": "tr",
"paymentId": "25149157",
"conversationId": "conversationId",
"conversationData": ""
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755198001941,
"conversationId": "conversationId",
"price": 1,
"paidPrice": 1,
"installment": 1,
"paymentId": "25149157",
"fraudStatus": 1,
"merchantCommissionRate": 0,
"merchantCommissionRateAmount": 0,
"iyziCommissionRateAmount": 0.0349,
"iyziCommissionFee": 0.25,
"cardType": "CREDIT_CARD",
"cardAssociation": "MASTER_CARD",
"cardFamily": "Paraf",
"binNumber": "552879",
"lastFourDigits": "0008",
"basketId": "basketId",
"currency": "TRY",
"itemTransactions": [
{
"itemId": "BI101",
"paymentTransactionId": "27138714",
"transactionStatus": 2,
"price": 0.4,
"paidPrice": 0.4,
"merchantCommissionRate": 0,
"merchantCommissionRateAmount": 0,
"iyziCommissionRateAmount": 0.01396,
"iyziCommissionFee": 0.1,
"blockageRate": 0,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"blockageResolvedDate": "2025-08-22 00:00:00",
"subMerchantPrice": 0,
"subMerchantPayoutRate": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.28604,
"convertedPayout": {
"paidPrice": 0.4,
"iyziCommissionRateAmount": 0.01396,
"iyziCommissionFee": 0.1,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.28604,
"iyziConversionRate": 0,
"iyziConversionRateAmount": 0,
"currency": "TRY"
}
},
{
"itemId": "BI102",
"paymentTransactionId": "27138715",
"transactionStatus": 2,
"price": 0.3,
"paidPrice": 0.3,
"merchantCommissionRate": 0,
"merchantCommissionRateAmount": 0,
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRate": 0,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"blockageResolvedDate": "2025-08-22 00:00:00",
"subMerchantPrice": 0,
"subMerchantPayoutRate": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.21453,
"convertedPayout": {
"paidPrice": 0.3,
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.21453,
"iyziConversionRate": 0,
"iyziConversionRateAmount": 0,
"currency": "TRY"
}
},
{
"itemId": "BI103",
"paymentTransactionId": "27138716",
"transactionStatus": 2,
"price": 0.3,
"paidPrice": 0.3,
"merchantCommissionRate": 0,
"merchantCommissionRateAmount": 0,
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRate": 0,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"blockageResolvedDate": "2025-08-22 00:00:00",
"subMerchantPrice": 0,
"subMerchantPayoutRate": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.21453,
"convertedPayout": {
"paidPrice": 0.3,
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.21453,
"iyziConversionRate": 0,
"iyziConversionRateAmount": 0,
"currency": "TRY"
}
}
],
"authCode": "214525",
"phase": "AUTH",
"mdStatus": 1,
"hostReference": "mock00001iyzihostrfn",
"signature": "5f510cd92b4b9c50a39b617cda228f4159f290860a4c20a965c55b119c9e9052"
}
Örnek Kodlar
3DS Tamamlama v2 - Geliştirilmiş Ödeme Güvenliği
iyzico'da, yakın zamanda gerçekleştirilen HMACSHA256 güncellemesinin ardından, mevcut payment/v2/3dsecure/auth
endpoint’ine ek olarak payment/3dsecure/auth
endpoint'ini devreye aldık. Bu endpoint, kayıtlı 3D ödemelerini tamamlamak ve müşterinin kartından çekilen nihai tutar, ilgili ödemenin conversationId ve paymentId bilgilerini içeren detayları elde etmek için kullanılır.
Bununla birlikte, ilgili ödemenin tamamlanması için daha güvenilir doğrulama teknikleri kullanılabilir. İmza Yanıtının Doğrulanması'nda belirtildiği gibi, ödeme isteği sonucunda döndürülen ve istek tablosunda listelenen değişkenler bu süreçte önemli bir rol oynar.
İmza Yanıtının Doğrulanması'nda gösterildiği gibi, şifrelenmiş payload için her iki tarafta imza üretildiğinde ve bu imzalar eşit olduğunda, ilgili ödeme başarıyla tamamlanır.
3D Secure doğrulaması sonrası 3DS v2 ödemesini sonuçlandırır.
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: 3DS başlatma sonrasında dönen ödeme ID’si.
25146302
İstek/yanıt eşleştirme ID’si.
conversationId
3DS v2 tamamlamada kullanılacak tahsilat tutarı. INIT 3DS aşamasında gönderilen paidPrice değeri ile uyumlu olmalı.
1
Sepet ID’si (INIT 3DS basketId ile eşleşmelidir).
basketId
Para birimi. Varsayılan; TRY (INIT 3DS'de gönderilen değer ile eşleşmelidir.)
TRY
Possible values: Başarılı yanıt (ödeme tamamlandı)
Hatalı istek / doğrulama hatası
POST https://api.iyzipay.com/payment/v2/3dsecure/auth
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"locale": "tr",
"paymentId": "25146302",
"conversationId": "conversationId",
"paidPrice": 1.0,
"basketId": "basketId",
"currency": "TRY"
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755203584577,
"conversationId": "conversationId",
"price": 1,
"paidPrice": 1,
"installment": 1,
"paymentId": "25149538",
"fraudStatus": 1,
"merchantCommissionRate": 0,
"merchantCommissionRateAmount": 0,
"iyziCommissionRateAmount": 0.0349,
"iyziCommissionFee": 0.25,
"cardType": "CREDIT_CARD",
"cardAssociation": "MASTER_CARD",
"cardFamily": "Paraf",
"binNumber": "552879",
"lastFourDigits": "0008",
"basketId": "basketId",
"currency": "TRY",
"paymentChannel": "WEB",
"itemTransactions": [
{
"itemId": "BI101",
"paymentTransactionId": "27139066",
"transactionStatus": 2,
"price": 0.4,
"paidPrice": 0.4,
"merchantCommissionRate": 0,
"merchantCommissionRateAmount": 0,
"iyziCommissionRateAmount": 0.01396,
"iyziCommissionFee": 0.1,
"blockageRate": 0,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"blockageResolvedDate": "2025-08-22 00:00:00",
"subMerchantPrice": 0,
"subMerchantPayoutRate": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.28604,
"convertedPayout": {
"paidPrice": 0.4,
"iyziCommissionRateAmount": 0.01396,
"iyziCommissionFee": 0.1,
"blockageRateAmountMerchant": 0,
"blockageRateAmountSubMerchant": 0,
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.28604,
"iyziConversionRate": 0,
"iyziConversionRateAmount": 0,
"currency": "TRY"
}
}
],
"authCode": "847162",
"phase": "AUTH",
"mdStatus": 1,
"hostReference": "mock00001iyzihostrfn",
"signature": "f95c9246235c30cad41169bb1df7381b7ffe42bf1ea1226c2dd211e83dfe40f7"
}
Örnek Kodlar
Auth 3DS vs Auth v2 3DS
Daha önce geliştirilmiş olan payment/3dsecure/auth
endpoint’i, standart 3D Secure 1.0 protokolünü kullanır ve daha basit bir yapı sunarak eski sistemlerin entegrasyonunu kolaylaştırır. Buna karşılık, payment/v2/3dsecure/auth
endpointendpoint’i, daha gelişmiş 3D Secure 2.0 protokolü üzerine inşa edilmiştir. Bu yeni protokol, risk analizi için daha zengin veri noktaları sunarak güvenliği artırır ve modern sistemlerle daha akıcı bir entegrasyon sağlar. payment/3dsecure/auth
istemel işlemler için güvenilir bir seçenek olsa da, payment/v2/3dsecure/auth
daha üstün güvenlik, geliştirilmiş kullanıcı deneyimi ve gelişen ödeme düzenlemeleriyle daha iyi uyumluluk sunar. Bu avantajlar için payment/v2/3dsecure/auth
geçiş yapmanızı öneririz.
Last updated