v1

latestOpenAPI 3.0.32026-07-232073105.4 KB

3DS Payment

Initialize 3DS Payment

3D Secure oturumu başlatır ve 3DS doğrulama için htmlContent değeri döner.

post/payment/3dsecure/initialize

Headers

Authorizationstring required

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Content-Typestring required

Content-Type değeri.

Request body

locale'tr' | 'en'

Dil kodu. Varsayılan; tr

conversationIdstring

İstek/yanıt eşleştirme ID’si.

{"stackTrail":"components:schemas:ThreeDSInitializeRequest:properties:price","oasType":"schema","type":"unknown","description":"Sepet toplamı."}

{"stackTrail":"components:schemas:ThreeDSInitializeRequest:properties:paidPrice","oasType":"schema","type":"unknown","description":"Tahsil edilecek nihai tutar."}

currency'TRY' | 'USD' | 'EUR' | 'GBP' | 'NOK' | 'CHF'

Para birimi. Varsayılan; TRY.

installment1 | 2 | 3 | 4 | 6 | 9 | 12

Taksit sayısı (gönderilmezse tek çekim olarak işlem gerçekleşir).

Ödeme kanalı.

basketIdstring

Sepet ID.

paymentGroup'PRODUCT' | 'LISTING' | 'SUBSCRIPTION'

Ödeme grubu. Varsayılan; PRODUCT.

callbackUrlstring required

3DS işlem sonrası yönlenecek dönüş URL’si.

paymentSourcestring

Bu alan, partner firmalar tarafından iletilen ödeme kaynağı bilgisidir. Eğer bir altyapı sağlayıcısıysanız ve iyzico ile entegrasyon/iş birliğiniz bulunuyorsa bu parametreyi gönderebilirsiniz.

Response

Başarılı yanıt (3DS başlatıldı)

status'success' | 'failure'

Yapılan isteğin sonucunu bildirir.

localestring

Yanıt dili (tr/en).

systemTimeinteger

İşlem zamanı (epoch ms).

conversationIdstring

İstek ile eşleşen ID.

threeDSHtmlContentstring

3DS doğrulama ekranının Base64 kodlu HTML içeriği.

paymentIdstring

iyzico tarafından dönen uniq paymentId bilgisi.

signaturestring

İmza doğrulaması için kullanılabilecek signature değeri.