v1

latestOpenAPI 3.0.32026-07-232073105.4 KB

3DS Payment

Create 3DS Payment

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.

post/payment/3dsecure/auth

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

paymentIdstring required

Initialize çağrısından dönen ödeme ID’si.

conversationIdstring

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

conversationDatastring

3DS sonucunda post edilen data. Dolu dönerse gönderilmesi zorunludur.

Response

Başarılı yanıt (ödeme tamamlandı)

status'success' | 'failure'

Yapılan işleminin sonucunu bildirir. success dönmesi taktirinde ödeme işlemi başarılı anlamına gelir.

localestring

Yanıt dili (tr/en).

systemTimeinteger

İşlem zamanı (epoch ms).

conversationIdstring

İstek ile eşleşen ID.

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

{"stackTrail":"components:schemas:PaymentResponse:properties:paidPrice","oasType":"schema","type":"unknown","description":"Tahsil edilen toplam tutar."}

installmentinteger

Taksit sayısı.

paymentIdstring

Ödeme ID’si.

fraudStatus0 | -1 | 1

Fraud filtrelerine göre ödeme durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir, eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.

1: Onaylandı
0: İncelemede
-1: Reddedildi

{"stackTrail":"components:schemas:PaymentResponse:properties:merchantCommissionRate","oasType":"schema","type":"unknown","description":"Üye işyerinin uyguladığı vade/komisyon oranı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon oranı %10’dur. Bilgi amaçlıdır."}

{"stackTrail":"components:schemas:PaymentResponse:properties:merchantCommissionRateAmount","oasType":"schema","type":"unknown","description":"Üye işyerinin uyguladığı vade/komisyon tutarı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon tutarı 10’dur. Bilgi amaçlıdır."}

{"stackTrail":"components:schemas:PaymentResponse:properties:iyziCommissionRateAmount","oasType":"schema","type":"unknown","description":"Ödemeye ait iyzico işlem komisyon tutarı."}

{"stackTrail":"components:schemas:PaymentResponse:properties:iyziCommissionFee","oasType":"schema","type":"unknown","description":"Ödemeye ait iyzico işlem ücreti."}

cardTypestring

Kart tipi.

cardAssociation'VISA' | 'MASTER_CARD' | 'AMERICAN_EXPRESS' | 'TROY'

Kart markası.

cardFamilystring

Kart ailesi/ürünü.

binNumberstring

BIN (ilk 8 hane).

lastFourDigitsstring

Kartın son 4 hanesi.

basketIdstring

Sepet ID.

currencystring

Para birimi.

authCodestring

Bankadan dönen authCode değeri.

phasestring

Ödeme Fazı.

mdStatus-1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

3DS doğrulama sonucu (1 ise başarılı).

hostReferencestring

Ödemeye ilişkin banka tarafından verilen hostReference değeri.

signaturestring

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