iyzico ile Öde

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"
}

iyzico ile öde (PWI) Sorgulama

post

PWI işlem sonucunu token ile sorgulanır.

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: 8152109759

tokenstringRequired

Sorgulama yapılacak PWI oturumuna ait token değeri.

Example: da7431f4-89fc-4f65-8533-d83a4fede7d9

Responses

200

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

application/json

statusstring · enumOptional

Yapılan isteğin sonucunu bildirir.

Example: successPossible values:

localestring · enumOptional

Yanıt dili (tr/en).

Example: trPossible values:

systemTimeintegerOptional

Zaman damgası (epoch ms).

Example: 1755252706797

conversationIdstringOptional

İstek ile eşleşen ID.

Example: 8152109759

pricedecimalOptional

Sepet toplam tutarı.

Example: 10

paidPricedecimalOptional

Tahsil edilen toplam tutar.

Example: 10

installmentintegerOptional

Taksit sayısı.

Example: 1

paymentIdstringOptional

Ödeme ID’si.

Example: 25152948

fraudStatusinteger · enumOptional

Ödeme işleminin fraud filtrelerine göre durumu.

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

Example: 1Possible values:

merchantCommissionRatedecimalOptional

Ü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.

Example: 0

merchantCommissionRateAmountdecimalOptional

Ü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.

Example: 0

iyziCommissionRateAmountdecimalOptional

Ödemeye ait iyzico işlem komisyon tutarı.

Example: 0.2094

iyziCommissionFeedecimalOptional

Ödemeye ait iyzico işlem ücreti.

Example: 0.25

cardTypestring · enumOptional

Kart tipi.

Example: CREDIT_CARDPossible values:

cardAssociationstring · enumOptional

Kart kuruluşu.

Example: MASTER_CARDPossible values:

cardFamilystringOptional

Kart ailesi..

Example: Axess

binNumberstringOptional

BIN (ilk 8 hane).

Example: 552608

lastFourDigitsstringOptional

Kartın son 4 hanesi.

Example: 0006

basketIdstringOptional

Sepet ID.

Example: basketId

currencystring · enumOptional

Para birimi.

Example: TRYPossible values:

authCodestringOptional

Bankadan dönen authCode değeri.

Example: 277568

phasestringOptional

Ödeme Fazı.

Example: AUTH

hostReferencestringOptional

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

Example: mock00007iyzihostrfn

signaturestringOptional

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

Example: 57b1be1f094d17da286c748e2b2779e078e550bafe9734d4fd8c092aeee022be

tokenstringOptional

İşleme ait token (sorgulama cevabı).

Example: 0b7b67d2-fdf0-4c9a-905f-2b0003b1b8c7

callbackUrlstringOptional

Başlangıçta gönderilen callback URL.

Example: https://callbackurl.com

paymentStatusstring · enumOptional

Ödeme durumu.

Example: SUCCESSPossible values:

memberEmailstringOptional

PWI ödemesi yapan üye e-posta adresi.

Example: [email protected]

memberGsmNumberstringOptional

PWI ödemesi yapan üye GSM numarası.

Example: [phone]

400

Hatalı istek / doğrulama hatası

application/json

post

/payment/iyzipos/checkoutform/auth/ecom/detail

HTTPcURL

POST https://api.iyzipay.com/payment/iyzipos/checkoutform/auth/ecom/detail
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "locale": "tr",
  "conversationId": "8152109759",
  "token": "da7431f4-89fc-4f65-8533-d83a4fede7d9"
}

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1755252706797,
  "conversationId": "8152109759",
  "price": 10,
  "paidPrice": 10,
  "installment": 1,
  "paymentId": "25152948",
  "fraudStatus": 1,
  "merchantCommissionRate": 0,
  "merchantCommissionRateAmount": 0,
  "iyziCommissionRateAmount": 0.349,
  "iyziCommissionFee": 0.25,
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "Axess",
  "binNumber": "552608",
  "lastFourDigits": "0006",
  "basketId": "basketID",
  "currency": "TRY",
  "itemTransactions": [
    {
      "itemId": "ItemID",
      "paymentTransactionId": "27142369",
      "transactionStatus": 2,
      "price": 10,
      "paidPrice": 10,
      "merchantCommissionRate": 0,
      "merchantCommissionRateAmount": 0,
      "iyziCommissionRateAmount": 0.349,
      "iyziCommissionFee": 0.25,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "blockageResolvedDate": "2025-08-23 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": 0,
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 9.401,
      "convertedPayout": {
        "paidPrice": 10,
        "iyziCommissionRateAmount": 0.349,
        "iyziCommissionFee": 0.25,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 0,
        "merchantPayoutAmount": 9.401,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    }
  ],
  "authCode": "277568",
  "phase": "AUTH",
  "hostReference": "mock00007iyzihostrfn",
  "signature": "57b1be1f094d17da286c748e2b2779e078e550bafe9734d4fd8c092aeee022be",
  "token": "0b7b67d2-fdf0-4c9a-905f-2b0003b1b8c7",
  "callbackUrl": "callbackUrl",
  "paymentStatus": "SUCCESS",
  "memberEmail": "[email protected]",
  "memberGsmNumber": "[phone]"
}