GitHubFeedback FormAPI Reference - Beta

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
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
post
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": "+905555555555"
}

Örnek Kodlar

PHP

Java

.NET

Postman

Last updated