Ödeme Sorgulama
iyzico'da kayıtlı bir işlemin detayına ulaşmak için ödeme sorgulama hizmetini kullanabilirsiniz.
Servise gönderilmesi gereken parametreler aşağıdaki gibidir. Hem paymentId hemde paymentConversationId ile sorgulama yapma imkanı sunar.
Ödeme sonucunu sorgular.
Header parameters
AuthorizationstringRequiredExample:
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 aXBzaWduYXR1cmU...
Content-TypestringRequiredExample:
Content-Type değeri.
application/json
Body
localestring · enumOptionalExample:
Dil kodu. Alabileceği değerler; tr, en. Default; tr
tr
Possible values: paymentIdstringRequiredExample:
Ödeme işlem ID’si.
25168803
paymentConversationIdstringOptionalExample:
Ödeme işlemine ait conversationId. paymentId gönderilmezse zorunludur.
123456789
Responses
200
Başarılı yanıt
application/json
400
Hatalı istek / doğrulama hatası
application/json
post
POST https://api.iyzipay.com/payment/detail
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json
{
"paymentId":"25168803",
"paymentConversationId":"123456789"
}
{
"status": "success",
"locale": "tr",
"systemTime": 1700000000000,
"conversationId": "123456789",
"paymentId": "1",
"price": 1,
"paidPrice": 1,
"installment": 1,
"fraudStatus": 1,
"merchantCommissionRate": "0E-8",
"merchantCommissionRateAmount": "0E-8",
"iyziCommissionRateAmount": 0.0349,
"iyziCommissionFee": 0.25,
"cardType": "CREDIT_CARD",
"cardAssociation": "MASTER_CARD",
"cardFamily": "Axess",
"binNumber": "552879",
"lastFourDigits": "0008",
"basketId": "B67832",
"currency": "TRY",
"itemTransactions": [
{
"itemId": "BI101",
"paymentTransactionId": "27137212",
"transactionStatus": 2,
"price": 0.3,
"paidPrice": 0.3,
"merchantCommissionRate": "0E-8",
"merchantCommissionRateAmount": "0E-8",
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRate": "0E-8",
"blockageRateAmountMerchant": "0E-8",
"blockageRateAmountSubMerchant": "0E-8",
"blockageResolvedDate": "2025-08-22 00:00:00",
"subMerchantPrice": 0,
"subMerchantPayoutRate": "0E-8",
"subMerchantPayoutAmount": 0,
"merchantPayoutAmount": 0.21453,
"convertedPayout": {
"paidPrice": 0.3,
"iyziCommissionRateAmount": 0.01047,
"iyziCommissionFee": 0.075,
"blockageRateAmountMerchant": "0E-8",
"blockageRateAmountSubMerchant": "0E-8",
"subMerchantPayoutAmount": "0E-8",
"merchantPayoutAmount": 0.21453,
"iyziConversionRate": 0,
"iyziConversionRateAmount": 0,
"currency": "TRY"
}
}
],
"authCode": "579803",
"phase": "AUTH",
"hostReference": "mock00007iyzihostrfn",
"signature": "5ab609ed2e0f4cae0035c8c136d29b00c2616cf8fb4856df65bb52b5a796369f",
"paymentStatus": "SUCCESS"
}
Örnek Kodlar
Last updated