PWI Başlatma
Aşağıda belirtilen talebi yaptıktan sonra, müşterilerinizin iyzico ile Ödeme'ye yönlendirileceği benzersiz bir sayfa olan payWithIyzicoPageUrl
değerini alacaksınız. Müşterileriniz, ödeme işlemini tamamladıktan sonra iyzico ile Öde başlatma talebinde belirttiğiniz callBackUrl'ye otomatik olarak yönlendirilecektir.
Oluşturulan bağlantıyı ödeme sayfanızda düğme, bağlantı veya div olarak görüntüleyebilirsiniz. Bağlantı ile alınan token bu aşamada veya müşteri ödeme işlemine devam ederse callBackUrl'e gönderildiğinde saklanabilir. Lütfen oluşturulan bağlantı ve token değerlerinin 30 dakika boyunca geçerli olduğunu unutmayın. Bu süre içinde herhangi bir ödeme alınmazsa tokenin süresi dolar.
Bu özellikleri dahil ederek, işlemlerinin başarısı veya başarısızlığı hakkında gerçek zamanlı geri bildirim ile müşterilerinize sorunsuz bir ödeme deneyimi sağlayabilirsiniz.
PWI oturumunu başlatır; yönlendirme için token ve sayfa URL’i döner.
Authorization header, IYZWSv2 ile başlayan ve imzalı base64 hash değeridir.
IYZWSv2 aXBzaWduYXR1cmU...
application/json
Dil kodu. Varsayılan; tr
tr
Possible values: İstek/yanıt eşleştirme ID’si.
conversationID
Sepet toplamı.
10
Sepet ID’si.
basketID
Ödeme grubu.
PRODUCT
Possible values: İşlem sonrası yönlenecek URL.
callbackUrl
Para birimi. Varsayılan TRY.
TRY
Possible values: Tahsil edilecek tutar.
10
Ödeme kanalı.
WEB
Possible values: Başarılı yanıt (PWI başlatıldı)
Hatalı istek / doğrulama hatası
POST https://api.iyzipay.com/payment/pay-with-iyzico/initialize
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"locale": "tr",
"conversationId": "conversationID",
"price": 10.0,
"basketId": "basketID",
"paymentGroup": "PRODUCT",
"callbackUrl": "callbackUrl",
"currency": "TRY",
"paidPrice": 10.0,
"paymentChannel": "WEB",
"enabledInstallments": [1,2,3,6,9,12],
"buyer": {
"id": "buyerID",
"name": "buyerName",
"surname": "buyerSurname",
"identityNumber": "11111111111",
"email": "[email protected]",
"gsmNumber": "+905350000000",
"registrationAddress": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
"city": "Istanbul",
"country": "Turkey",
"ip": "85.34.78.112",
"zipCode": "34732",
"registrationDate": "2013-04-21 15:12:09",
"lastLoginDate": "2015-10-05 12:43:35"
},
"shippingAddress": {
"address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
"contactName": "Contact Name",
"city": "Istanbul",
"country": "Turkey",
"zipCode": "34742"
},
"billingAddress": {
"address": "Burhaniye Mahallesi Atilla Sokak No:7 Üsküdar",
"contactName": "Contact Name",
"city": "Istanbul",
"country": "Turkey",
"zipCode": "34700"
},
"basketItems": [
{
"id": "ItemID",
"price": 10.0,
"name": "product Name",
"category1": "Category Name",
"itemType": "PHYSICAL"
}
]
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755252275214,
"conversationId": "conversationID",
"token": "54481021-e605-407e-93d7-776ef481c4d7",
"tokenExpireTime": 1800,
"payWithIyzicoPageUrl": "https://sandbox-ode.iyzico.com/?token=54481021-e605-407e-93d7-776ef481c4d7&lang=tr",
"signature": "a35338903267271c38465924d7d1903b2e10870bebaef1a00923be864e475818"
}
Örnek Kodlar
Last updated