v1

latestOpenAPI 3.0.32026-07-232073105.4 KB

Pay with iyzico

iyzico ile Öde (PWI) Başlatma

PWI oturumunu başlatır; yönlendirme için token ve sayfa URL’i döner.

post/payment/pay-with-iyzico/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:PwiInitializeRequest:properties:price","oasType":"schema","type":"unknown","description":"Sepet toplamı."}

basketIdstring required

Sepet ID’si.

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

Ödeme grubu.

callbackUrlstring required

İşlem sonrası yönlenecek URL.

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

Para birimi. Varsayılan TRY.

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

Ödeme kanalı.

enabledInstallmentsinteger[]

Sunulacak taksit seçenekleri.

Response

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

status'success' | 'failure'

Yapılan isteğin sonucunu bildirir.

locale'tr' | 'en'

Yanıt dili.

systemTimeinteger

Zaman damgası (epoch ms).

conversationIdstring

İstek ile eşleşen ID.

tokenstring

iyzico ile ödeme için oluşturulan tekil değer. Her istek için özel üretilir ve işyerine dönülür Ödemenin sonucunu öğrenmek için gereklidir.

tokenExpireTimeinteger

Token geçerlilik süresi; 1800 saniye

payWithIyzicoPageUrlstring

Yönlenecek ödeme sayfası URL’i.

signaturestring

Yanıt imzası (hash).