xiyzico'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:
Create 3DS Payment
post
3DS doğrulaması sonrasında, ödeme işleminin sonlandırılması için bu endpoint’e istek yapılmalıdır. Bu servis, doğrulama adımından sonra alınan bilgilerle çalıştırılır ve işlemi başarılı ya da başarısız olarak sonuçlandırır.
Header parameters
AuthorizationstringRequired
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
Example: IYZWSv2 aXBzaWduYXR1cmU...
Content-TypestringRequired
Content-Type değeri.
Example: application/json
Body
localestring · enumOptional
Dil kodu. Varsayılan; tr
Example: trPossible values:
paymentIdstringRequired
Initialize çağrısından dönen ödeme ID’si.
Example: 25149157
conversationIdstringOptional
İstek/yanıt eşleştirme ID’si.
Example: conversationId
conversationDatastringOptional
3DS sonucunda post edilen data. Dolu dönerse gönderilmesi zorunludur.
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.
Create 3DS v2 Payment
post
Doğrulama sonrası ödeme sonucunun alınması için hem v1 hem de yeni nesil v2 endpoint’i kullanılabilir. Daha güncel teknolojilere uyum sağlamak adına v2 endpoint’inin kullanılmasını öneririz.
Header parameters
AuthorizationstringRequired
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
Example: IYZWSv2 aXBzaWduYXR1cmU...
Content-TypestringRequired
Content-Type değeri.
Example: application/json
Body
localestring · enumOptional
Dil kodu. Varsayılan; tr
Example: trPossible values:
paymentIdstringRequired
3DS başlatma sonrasında dönen ödeme ID’si.
Example: 25146302
conversationIdstringOptional
İstek/yanıt eşleştirme ID’si.
Example: conversationId
paidPricedecimalRequired
3DS v2 tamamlamada kullanılacak tahsilat tutarı. INIT 3DS aşamasında gönderilen paidPrice değeri ile uyumlu olmalı.
Example: 1
basketIdstringRequired
Sepet ID’si (INIT 3DS basketId ile eşleşmelidir).
Example: basketId
currencystring · enumRequired
Para birimi. Varsayılan; TRY (INIT 3DS'de gönderilen değer ile eşleşmelidir.)
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.
