v1

latestOpenAPI 3.0.32026-07-232073105.4 KB

Non3D Payment

Create Non3D Payment

3D Secure olmadan ödeme başlatır.

post/payment/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

conversationIdstring

İstek/yanıt eşleştirmesi için benzersiz ID.

locale'tr' | 'en'

Dil kodu. Alabileceği değerler; tr, en. Default; tr

{"stackTrail":"paths:/payment/auth:post:requestBody:content:application/json:schema:properties:paidPrice","oasType":"schema","type":"unknown","description":"Kullanıcıdan tahsil edilecek toplam tutar."}

{"stackTrail":"paths:/payment/auth:post:requestBody:content:application/json:schema:properties:price","oasType":"schema","type":"unknown","description":"Sepet toplam tutarı."}

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

Ödeme grubu. Default; PRODUCT.

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

Para birimi. Default; TRY.

installment1 | 2 | 3 | 6 | 9 | 12

Taksit sayısı. Gönderilmezse tek çekim (1) olarak işlem sağlanılabilir.

basketIdstring

Sepet ID’si.

Ödeme kanalı.

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

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.