PWI Sorgulama

Ödeme formunda kart bilgileri girilip "X TL Öde" butonuna basıldığında iyzico, ödeme formunu oluştururken belirttiğiniz callbackUrl adresine yönlendirecektir. Bu adreste iyzico tarafından bir token değeri yayınlanacaktır. Ödeme sonuçlarıyla ilgili ek ayrıntıları görüntülemek için bu token kullanılarak ikinci bir sorgu yapılmalıdır.

Aşağıdaki hizmet, token kullanımını temsil eder;

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

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

Örnek Kodlar

PHP

Java

.NET

Postman