CF 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;

Ödeme Formu (CF) sorgulama

post

CF ödeme formu tamamlandıktan sonra, token ile sonuçları sorgular.

Header parameters

AuthorizationstringRequired

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

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequired

Content-Type değeri.

Example: application/json

Body

application/json

localestring · enumOptional

Dil kodu. Varsayılan; tr

Example: trPossible values:

conversationIdstringOptional

İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.

Example: 8152109759

tokenstringRequired

CF initialize yanıtından dönen token.

Example: 077aff05-1e9b-44aa-aa11-c268bb8b3826

Responses

200

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

application/json

400

Başarısız yanıt

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": "077aff05-1e9b-44aa-aa11-c268bb8b3826"
}

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1755536577419,
  "conversationId": "8152109759",
  "price": 6,
  "paidPrice": 6,
  "installment": 1,
  "paymentId": "24478123",
  "fraudStatus": 1,
  "merchantCommissionRate": 0,
  "merchantCommissionRateAmount": 0,
  "iyziCommissionRateAmount": 0.2094,
  "iyziCommissionFee": 0.25,
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "Axess",
  "binNumber": "552608",
  "lastFourDigits": "0006",
  "basketId": "basketId",
  "currency": "TRY",
  "itemTransactions": [
    {
      "itemId": "BI101",
      "paymentTransactionId": "26475993",
      "transactionStatus": 2,
      "price": 1,
      "paidPrice": 1,
      "merchantCommissionRate": 0,
      "merchantCommissionRateAmount": 0,
      "iyziCommissionRateAmount": 0.0349,
      "iyziCommissionFee": 0.04166667,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "blockageResolvedDate": "2025-07-20 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": 0,
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 0.92343333,
      "convertedPayout": {
        "paidPrice": 1,
        "iyziCommissionRateAmount": 0.0349,
        "iyziCommissionFee": 0.04166667,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 0,
        "merchantPayoutAmount": 0.92343333,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    },
    {
      "itemId": "BI103",
      "paymentTransactionId": "26475995",
      "transactionStatus": 2,
      "price": 3,
      "paidPrice": 3,
      "merchantCommissionRate": 0,
      "merchantCommissionRateAmount": 0,
      "iyziCommissionRateAmount": 0.1047,
      "iyziCommissionFee": 0.125,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "blockageResolvedDate": "2025-07-20 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": 0,
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 2.7703,
      "convertedPayout": {
        "paidPrice": 3,
        "iyziCommissionRateAmount": 0.1047,
        "iyziCommissionFee": 0.125,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 0,
        "merchantPayoutAmount": 2.7703,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    },
    {
      "itemId": "BI102",
      "paymentTransactionId": "26475994",
      "transactionStatus": 2,
      "price": 2,
      "paidPrice": 2,
      "merchantCommissionRate": 0,
      "merchantCommissionRateAmount": 0,
      "iyziCommissionRateAmount": 0.0698,
      "iyziCommissionFee": 0.08333333,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "blockageResolvedDate": "2025-07-20 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": 0,
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 1.84686667,
      "convertedPayout": {
        "paidPrice": 2,
        "iyziCommissionRateAmount": 0.0698,
        "iyziCommissionFee": 0.08333333,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 0,
        "merchantPayoutAmount": 1.84686667,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    }
  ],
  "authCode": "930115",
  "phase": "AUTH",
  "hostReference": "mock00007iyzihostrfn",
  "signature": "1960256fa0406e6ca0e02a71a9d0b3bd72c2aad4e2677cd315975a4dc8ecfaa5",
  "token": "077aff05-1e9b-44aa-aa11-c268bb8b3826",
  "callbackUrl": "https://callback.com/test",
  "paymentStatus": "SUCCESS"
}

Örnek Kodlar

PHP

Java

.NET

Node.Js

Python

Postman