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;
CF ödeme formu tamamlandıktan sonra, token
ile sonuçları sorgular.
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 aXBzaWduYXR1cmU...
Content-Type değeri.
application/json
Dil kodu. Varsayılan; tr
tr
Possible values: İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.
8152109759
CF initialize yanıtından dönen token.
077aff05-1e9b-44aa-aa11-c268bb8b3826
Başarılı yanıt (ödeme tamamlandı)
Başarısız yanıt
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
Last updated