GitHubFeedback FormAPI Reference - Beta

Raporlama Servisi

Raporlama servisi, üye işyerlerinin karar almadan önce detaylı işlem bilgilerine, ödemelerin son durumuna, iade sonuçlarına ve fraud durumlarına ulaşmasını sağlar.

Raporlama Servisi üzerinden alabileceğiniz bilgiler maksimum 2 yıla kadar geriye gidebilmektedir.

İşlem Detayı Raporlama

get

Raporlama servisi, ödemelerin son durumuna, iade sonuçlarına ve fraud durumlarına ulaşmasını sağlar. Raporlama servisi hem paymentConversationId hem de paymentId ile çalışır. İki bilgiden birinin gönderilmesi zorunludur.

Query parameters
localestring · enumOptional

Dil kodu.

Example: trPossible values:
conversationIdstringOptional

İstek/yanıt eşleştirmesi için kullanılabilir. İstekte gönderilen veri, yanıtta aynen geri döner.

Example: 123
paymentIdstringRequired

Ödeme numarası. paymentConversationId gönderilmezse zorunlu bilgidir.

Example: 25168803
paymentConversationIdstringRequired

Ödeme işlemine ait conversationId. ConversationId ile sorgulama yapmak isteğinde kullanılabilir. paymentId gönderilmezse zorunludur.

Example: 123456789
Header parameters
AuthorizationstringRequired

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

Content-TypestringRequired

İstek gövdesinin veri formatı.

Example: application/json
Responses
200

Başarılı yanıt — işlem detayı

application/json
Responseall of
get
/v2/reporting/payment/details
GET https://api.iyzipay.com/v2/reporting/payment/details?locale=tr&paymentConversationId=123321&conversationId=123
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1756383869332,
  "payments": [
    {
      "paymentId": 25236546,
      "paymentStatus": 1,
      "paymentRefundStatus": "PARTIALLY_REFUNDED",
      "price": 1,
      "paidPrice": 50,
      "installment": 1,
      "merchantCommissionRate": 4900,
      "merchantCommissionRateAmount": 49,
      "iyziCommissionRateAmount": 1.745,
      "iyziCommissionFee": 0.25,
      "paymentConversationId": "123321",
      "fraudStatus": 1,
      "cardType": "CREDIT_CARD",
      "cardAssociation": "MASTER_CARD",
      "cardFamily": "Axess",
      "binNumber": "552608",
      "lastFourDigits": "0006",
      "basketId": "16733998",
      "currency": "TRY",
      "connectorName": "IYZI_POS",
      "authCode": "185027",
      "threeDS": false,
      "phase": "AUTH",
      "acquirerBankName": "iyziPos",
      "hostReference": "mock00007iyzihostrfn",
      "createdDate": "2025-08-28T15:19:03Z",
      "cancels": [],
      "itemTransactions": [
        {
          "paymentTransactionId": 27225634,
          "transactionStatus": 2,
          "price": 1,
          "paidPrice": 50,
          "merchantCommissionRate": 4900,
          "merchantCommissionRateAmount": 49,
          "iyziCommissionRateAmount": 1.745,
          "iyziCommissionFee": 0.25,
          "blockageRate": 0,
          "blockageRateAmountMerchant": 0,
          "blockageRateAmountSubMerchant": 0,
          "blockageResolvedDate": "2025-09-05T00:00:00Z",
          "subMerchantPrice": 0,
          "subMerchantPayoutRate": 0,
          "subMerchantPayoutAmount": 0,
          "merchantPayoutAmount": 48.005,
          "convertedPayout": {
            "paidPrice": 50,
            "iyziCommissionRateAmount": 1.745,
            "iyziCommissionFee": 0.25,
            "blockageRateAmountMerchant": 0,
            "blockageRateAmountSubMerchant": 0,
            "subMerchantPayoutAmount": 0,
            "merchantPayoutAmount": 48.005,
            "iyziConversionRate": 0,
            "iyziConversionRateAmount": 0,
            "currency": "TRY"
          },
          "refunds": [
            {
              "refundTxId": 3673487,
              "refundConversationId": "conversationId",
              "refundPrice": 0.5,
              "refundStatus": 1,
              "isAfterSettlement": false,
              "createdDate": "2025-08-28T15:19:08Z",
              "currencyCode": "TRY",
              "authCode": "839860",
              "hostReference": "mock00007iyzihostrfn",
              "iyziCommissionRateAmount": 0.01745
            }
          ]
        }
      ]
    },
    {
      "paymentId": 25236539,
      "paymentStatus": 1,
      "paymentRefundStatus": "TOTALLY_REFUNDED",
      "price": 1,
      "paidPrice": 50,
      "installment": 1,
      "merchantCommissionRate": 4900,
      "merchantCommissionRateAmount": 49,
      "iyziCommissionRateAmount": 1.745,
      "iyziCommissionFee": 0.25,
      "paymentConversationId": "123321",
      "fraudStatus": 1,
      "cardType": "CREDIT_CARD",
      "cardAssociation": "MASTER_CARD",
      "cardFamily": "Axess",
      "binNumber": "552608",
      "lastFourDigits": "0006",
      "basketId": "16733997",
      "currency": "TRY",
      "connectorName": "IYZI_POS",
      "authCode": "827023",
      "threeDS": false,
      "phase": "AUTH",
      "acquirerBankName": "iyziPos",
      "hostReference": "mock00007iyzihostrfn",
      "createdDate": "2025-08-28T15:18:52Z",
      "cancels": [
        {
          "refundId": 4177835,
          "cancelConversationId": "123456789",
          "refundPrice": 50,
          "refundStatus": 1,
          "createdDate": "2025-08-28T15:18:58Z",
          "currencyCode": "TRY",
          "authCode": "086147",
          "hostReference": "mock00007iyzihostrfn"
        }
      ],
      "itemTransactions": [
        {
          "paymentTransactionId": 27225633,
          "transactionStatus": 2,
          "price": 1,
          "paidPrice": 50,
          "merchantCommissionRate": 4900,
          "merchantCommissionRateAmount": 49,
          "iyziCommissionRateAmount": 1.745,
          "iyziCommissionFee": 0.25,
          "blockageRate": 0,
          "blockageRateAmountMerchant": 0,
          "blockageRateAmountSubMerchant": 0,
          "blockageResolvedDate": "2025-09-05T00:00:00Z",
          "subMerchantPrice": 0,
          "subMerchantPayoutRate": 0,
          "subMerchantPayoutAmount": 0,
          "merchantPayoutAmount": 48.005,
          "convertedPayout": {
            "paidPrice": 50,
            "iyziCommissionRateAmount": 1.745,
            "iyziCommissionFee": 0.25,
            "blockageRateAmountMerchant": 0,
            "blockageRateAmountSubMerchant": 0,
            "subMerchantPayoutAmount": 0,
            "merchantPayoutAmount": 48.005,
            "iyziConversionRate": 0,
            "iyziConversionRateAmount": 0,
            "currency": "TRY"
          },
          "refunds": []
        }
      ]
    }
  ]
}

Örnek Kodlar

PHP

Java

.Net

Python

Postman

Gün Bazında Raporlama

get

Belirli bir tarihte gerçekleşen ödeme/iptal/iade işlemlerinin listesini döner.

Query parameters
localestring · enumOptional

Dil kodu.

Example: trPossible values:
conversationIdstringOptional

İstek/yanıt eşleştirmesi için kullanılabilir. İstekte gönderilen veri, yanıtta aynen geri döner.

Example: 123
pageinteger · min: 1Required

Sayfa numarası (1’den başlar).

Example: 1
transactionDatestringRequired

Sorgulanacak gün (YYYY-MM-DD). Örn: 2025-07-24.

Example: 2025-07-24
Header parameters
AuthorizationstringRequired

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

Content-TypestringRequired

İstek gövdesinin veri formatı.

Example: application/json
Responses
200

Başarılı yanıt — gün bazında işlemler

application/json
Responseall of
get
/v2/reporting/payment/transactions
GET https://api.iyzipay.com/v2/reporting/payment/transactions?conversationId=123456x789&page=1&transactionDate=2025-07-24
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "status": "success",
  "systemTime": 1756387157979,
  "conversationId": "123456789",
  "transactions": [
    {
      "transactionType": "REFUND",
      "transactionDate": "2025-07-14 14:48:24",
      "transactionId": 3666275,
      "afterSettlement": 0,
      "paymentTxId": 26509582,
      "paymentId": 24511629,
      "conversationId": "123456789",
      "paymentPhase": "AUTH",
      "price": 0.55,
      "paidPrice": 1.1,
      "transactionCurrency": "TRY",
      "installment": 1,
      "threeDS": 0,
      "settlementCurrency": "TRY",
      "connectorType": "IYZI_POS",
      "posOrderId": "mock12-0699417518704633iyziord",
      "authCode": "830889",
      "hostReference": "mock00001iyzihostrfn",
      "basketId": "B67832"
    },
    {
      "transactionType": "REFUND",
      "transactionDate": "2025-07-14 14:48:24",
      "transactionId": 3666291,
      "afterSettlement": 0,
      "paymentTxId": 26509581,
      "paymentId": 24511629,
      "conversationId": "123456789",
      "paymentPhase": "AUTH",
      "price": 0.23,
      "paidPrice": 1.1,
      "transactionCurrency": "TRY",
      "installment": 1,
      "threeDS": 0,
      "settlementCurrency": "TRY",
      "connectorType": "IYZI_POS",
      "posOrderId": "mock12-0699417518704633iyziord",
      "authCode": "830889",
      "hostReference": "mock00001iyzihostrfn",
      "basketId": "B67832"
    },
    {
      "transactionType": "REFUND",
      "transactionDate": "2025-07-14 14:48:24",
      "transactionId": 3666292,
      "afterSettlement": 0,
      "paymentTxId": 26509583,
      "paymentId": 24511629,
      "conversationId": "123456789",
      "paymentPhase": "AUTH",
      "price": 0.22,
      "paidPrice": 1.1,
      "transactionCurrency": "TRY",
      "installment": 1,
      "threeDS": 0,
      "settlementCurrency": "TRY",
      "connectorType": "IYZI_POS",
      "posOrderId": "mock12-0699417518704633iyziord",
      "authCode": "830889",
      "hostReference": "mock00001iyzihostrfn",
      "basketId": "B67832"
    },
    {
      "transactionType": "REFUND",
      "transactionDate": "2025-07-14 14:47:53",
      "transactionId": 3666289,
      "afterSettlement": 0,
      "paymentTxId": 26509581,
      "paymentId": 24511629,
      "conversationId": "conversationId",
      "paymentPhase": "AUTH",
      "price": 0.1,
      "paidPrice": 1.1,
      "transactionCurrency": "TRY",
      "installment": 1,
      "threeDS": 0,
      "settlementCurrency": "TRY",
      "connectorType": "IYZI_POS",
      "posOrderId": "mock12-0699417518704633iyziord",
      "authCode": "959162",
      "hostReference": "mock00001iyzihostrfn",
      "basketId": "B67832"
    },
    {
      "transactionType": "PAYMENT",
      "transactionDate": "2025-07-14 14:44:46",
      "transactionId": 26509581,
      "transactionStatus": 2,
      "paymentTxId": 26509581,
      "paymentId": 24511629,
      "conversationId": "123456789",
      "paymentPhase": "AUTH",
      "price": 0.3,
      "paidPrice": 0.33,
      "transactionCurrency": "TRY",
      "installment": 1,
      "threeDS": 0,
      "iyzicoCommission": 0.011517,
      "iyzicoFee": 0.075,
      "parity": 1,
      "iyzicoConversionAmount": 0,
      "settlementCurrency": "TRY",
      "merchantPayoutAmount": 0.243483,
      "connectorType": "IYZI_POS",
      "posOrderId": "mock12-0699417518704633iyziord",
      "subMerchantPayoutAmount": 0,
      "authCode": "610336",
      "hostReference": "mock00001iyzihostrfn",
      "basketId": "B67832"
    },
    {
      "transactionType": "PAYMENT",
      "transactionDate": "2025-07-14 14:44:46",
      "transactionId": 26509582,
      "transactionStatus": 2,
      "paymentTxId": 26509582,
      "paymentId": 24511629,
      "conversationId": "123456789",
      "paymentPhase": "AUTH",
      "price": 0.5,
      "paidPrice": 0.55,
      "transactionCurrency": "TRY",
      "installment": 1,
      "threeDS": 0,
      "iyzicoCommission": 0.019195,
      "iyzicoFee": 0.125,
      "parity": 1,
      "iyzicoConversionAmount": 0,
      "settlementCurrency": "TRY",
      "merchantPayoutAmount": 0.405805,
      "connectorType": "IYZI_POS",
      "posOrderId": "mock12-0699417518704633iyziord",
      "subMerchantPayoutAmount": 0,
      "authCode": "610336",
      "hostReference": "mock00001iyzihostrfn",
      "basketId": "B67832"
    },
    {
      "transactionType": "PAYMENT",
      "transactionDate": "2025-07-14 14:44:46",
      "transactionId": 26509583,
      "transactionStatus": 2,
      "paymentTxId": 26509583,
      "paymentId": 24511629,
      "conversationId": "123456789",
      "paymentPhase": "AUTH",
      "price": 0.2,
      "paidPrice": 0.22,
      "transactionCurrency": "TRY",
      "installment": 1,
      "threeDS": 0,
      "iyzicoCommission": 0.007678,
      "iyzicoFee": 0.05,
      "parity": 1,
      "iyzicoConversionAmount": 0,
      "settlementCurrency": "TRY",
      "merchantPayoutAmount": 0.162322,
      "connectorType": "IYZI_POS",
      "posOrderId": "mock12-0699417518704633iyziord",
      "subMerchantPayoutAmount": 0,
      "authCode": "610336",
      "hostReference": "mock00001iyzihostrfn",
      "basketId": "B67832"
    }
  ],
  "currentPage": 1,
  "totalPageCount": 1
}

Örnek Kodlar

PHP

Java

.Net

Python

Postman

Last updated