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.

ÖNEMLİ NOT : callBackUrl adresi mutlaka SSL içermelidir.

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.

iyzico ile Öde (PWI) Başlatma

post

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

Header parameters

AuthorizationstringRequired

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

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequiredExample: application/json

Body

application/json

localestring · enumOptional

Dil kodu. Varsayılan; tr

Example: trPossible values:

conversationIdstringOptional

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

Example: conversationID

pricedecimalRequired

Sepet toplamı.

Example: 10

basketIdstringRequired

Sepet ID’si.

Example: basketID

paymentGroupstring · enumOptional

Ödeme grubu.

Example: PRODUCTPossible values:

callbackUrlstringRequired

İşlem sonrası yönlenecek URL.

Example: callbackUrl

currencystring · enumRequired

Para birimi. Varsayılan TRY.

Example: TRYPossible values:

paidPricedecimalRequired

Tahsil edilecek tutar.

Example: 10

paymentChannelstring · enumOptional

Ödeme kanalı.

Example: WEBPossible values:

Responses

200

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

application/json

statusstring · enumOptional

Yapılan isteğin sonucunu bildirir.

Example: successPossible values:

localestring · enumOptional

Yanıt dili.

Example: trPossible values:

systemTimeintegerOptional

Zaman damgası (epoch ms).

Example: 1755252275214

conversationIdstringOptional

İstek ile eşleşen ID.

Example: conversationID

tokenstringOptional

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.

Example: 54481021-e605-407e-93d7-776ef481c4d7

tokenExpireTimeintegerOptional

Token geçerlilik süresi; 1800 saniye

Example: 1800

payWithIyzicoPageUrlstringOptional

Yönlenecek ödeme sayfası URL’i.

Example: https://sandbox-ode.iyzico.com/?token=54481021-e605-407e-93d7-776ef481c4d7&lang=tr

signaturestringOptional

Yanıt imzası (hash).

Example: a35338903267271c38465924d7d1903b2e10870bebaef1a00923be864e475818

400

Hatalı istek / doğrulama hatası

application/json

post

/payment/pay-with-iyzico/initialize

HTTPcURL

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": "[phone]",
    "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

PHP

Java

.NET

Postman