# 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. {% hint style="info" %} Raporlama Servisi üzerinden alabileceğiniz bilgiler maksimum 2 yıla kadar geriye gidebilmektedir. {% endhint %} ## İşlem Detayı Raporlama > 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. ```json {"openapi":"3.0.3","info":{"title":"İşlem Detayı Raporlama","version":"1.0.0"},"tags":[{"name":"Reporting","description":"Raporlama uçları"}],"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/reporting/payment/details":{"get":{"summary":"İşlem Detayı Raporlama","description":"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.","tags":["Reporting"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"$ref":"#/components/parameters/LocaleQuery"},{"$ref":"#/components/parameters/ConversationIdQuery"},{"name":"paymentId","in":"query","required":true,"schema":{"type":"string"},"description":"Ödeme numarası. paymentConversationId gönderilmezse zorunlu bilgidir.\n"},{"name":"paymentConversationId","in":"query","required":true,"schema":{"type":"string"},"description":"Ödeme işlemine ait conversationId. ConversationId ile sorgulama yapmak isteğinde kullanılabilir. paymentId gönderilmezse zorunludur.\n"}],"responses":{"200":{"description":"Başarılı yanıt — işlem detayı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportingPaymentDetailsResponse"}}}},"400":{"description":"Geçersiz istek / doğrulama hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek gövdesinin veri formatı."},"LocaleQuery":{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["tr","en"]},"description":"Dil kodu."},"ConversationIdQuery":{"name":"conversationId","in":"query","required":false,"schema":{"type":"string"},"description":"İstek/yanıt eşleştirmesi için kullanılabilir. İstekte gönderilen veri, yanıtta aynen geri döner."}},"schemas":{"ReportingPaymentDetailsResponse":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"payments":{"type":"array","description":"Sorgu sonucunda dönen işlemler.","items":{"$ref":"#/components/schemas/ReportingPaymentDetailsItem"}}}}]},"BaseResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucunu bildirir.","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili (tr/en)."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID (varsa)."}}},"ReportingPaymentDetailsItem":{"type":"object","properties":{"paymentId":{"description":"Ödeme numarası.","type":"string"},"paymentStatus":{"type":"integer","description":"Ödeme durumu.\n\n- **1** (Success)\n- **2** (Failure / INIT_THREEDS )\n- **3** (CALLBACK_THREEDS)\n","enum":[1,2,3]},"paymentRefundStatus":{"type":"string","description":"İade Durumu.\n\n- **NOT_REFUNDED** (İade Edilmedi)\n- **PARTIALLY_REFUNDED** (Kısmi İade Edildi)\n- **TOTALLY_REFUNDED** (Tamamı İade Edildi)\n"},"price":{"type":"decimal","description":"Sepet toplam tutarı."},"paidPrice":{"type":"decimal","description":"Tahsil edilen toplam tutar."},"installment":{"type":"integer","description":"Taksit sayısı."},"merchantCommissionRate":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon oranı (bilgi amaçlı)."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyerinin uyguladığı vade/komisyon tutarı (bilgi amaçlı)."},"iyziCommissionRateAmount":{"type":"decimal","description":"Ödemeye ait iyzico işlem komisyon tutarı."},"iyziCommissionFee":{"type":"decimal","description":"Ödemeye ait iyzico işlem ücreti."},"paymentConversationId":{"type":"string","description":"Ödeme işlemine ait conversationId."},"fraudStatus":{"type":"integer","description":"Fraud filtrelerine göre ödeme durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir, eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.\n- **1**: Onaylandı\n- **0**: İncelemede\n- **-1**: Reddedildi\n","enum":[-1,0,1]},"cardType":{"type":"string","description":"Kart tipi.","enum":["CREDIT_CARD","DEBIT_CARD","PREPAID_CARD"]},"cardAssociation":{"type":"string","description":"Kart kuruluşu.","enum":["VISA","MASTER_CARD","AMERICAN_EXPRESS"]},"cardFamily":{"type":"string","description":"Kart ailesi.","enum":["Bonus","Axess","World","Maximum","Paraf","CardFinans"]},"binNumber":{"type":"string","description":"BIN (ilk 8 hane)."},"lastFourDigits":{"type":"string","description":"Kartın son 4 hanesi."},"basketId":{"type":"string","description":"Sepet ID’si."},"currency":{"type":"string","description":"Para birimi.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"connectorName":{"type":"string","description":"Bağlantı/pos sağlayıcı adı."},"authCode":{"type":"string","description":"Bankadan dönen authCode değeri."},"threeDS":{"type":"boolean","description":"İşlemin 3DS ile yapılıp yapılmadığı."},"phase":{"type":"string","description":"Ödeme fazı."},"acquirerBankName":{"type":"string","description":"Tahsilat yapan banka/kurum adı."},"hostReference":{"type":"string","description":"Banka/sağlayıcı tarafından verilen hostReference değeri."},"createdDate":{"type":"string","description":"ISO-8601 oluşturulma zamanı."},"cancels":{"type":"array","description":"İptal işlemleri listesi.","items":{"$ref":"#/components/schemas/ReportingCancel"}},"itemTransactions":{"type":"array","description":"Sepet öğelerine ait işlem kırılımları.","items":{"$ref":"#/components/schemas/ReportingItemTransaction"}}}},"ReportingCancel":{"type":"object","properties":{"refundId":{"description":"İptale ilişkin refund/id bilgisi.","oneOf":[{"type":"string"},{"type":"integer"}]},"cancelConversationId":{"type":"string","description":"İptal işlemine ait conversationId."},"refundPrice":{"type":"decimal","description":"İptal/iade tutarı."},"refundStatus":{"type":"integer","description":"İptal/iade durum kodu."},"createdDate":{"type":"string","description":"ISO-8601 oluşturulma zamanı."},"currencyCode":{"type":"string","description":"Para birimi.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"authCode":{"type":"string","description":"Bankadan dönen authCode değeri."},"hostReference":{"type":"string","description":"Sağlayıcı tarafından verilen hostReference değeri."}}},"ReportingItemTransaction":{"type":"object","properties":{"paymentTransactionId":{"description":"Kırılıma ait işlem ID’si.","type":"string"},"transactionStatus":{"type":"integer","description":"Ödeme kırılımının durumu.\n- **0**: Fraud kontrolünde\n- **-1**: Fraud kontrolünden sonra reddedildi\n- **1**: Onaylandı (Pazaryerinde: Üye İşyeri Onayı Bekliyor)\n- **2**: Onaylandı (Pazaryeri Onay Verilmiş)\n","enum":[0,-1,1,2]},"price":{"type":"decimal","description":"Ürün tutarı."},"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı."},"merchantCommissionRate":{"type":"decimal","description":"Üye işyeri vade/komisyon oranı (kırılım)."},"merchantCommissionRateAmount":{"type":"decimal","description":"Üye işyeri vade/komisyon tutarı (kırılım)."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico komisyon tutarı (kırılım)."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücreti (kırılım)."},"blockageRate":{"type":"decimal","description":"Üye işyeri blokaj oranı (kırılım)."},"blockageRateAmountMerchant":{"type":"decimal","description":"Blokajın üye işyerine yansıyan tutarı."},"blockageRateAmountSubMerchant":{"type":"decimal","description":"Blokajın alt üye işyerine yansıyan tutarı."},"blockageResolvedDate":{"type":"string","description":"Blokaj çözülme tarihi (ISO-8601)."},"subMerchantPrice":{"type":"decimal","description":"Alt üye işyeri ürün tutarı."},"subMerchantPayoutRate":{"type":"decimal","description":"Alt üye işyerine gönderilecek tutar oranı."},"subMerchantPayoutAmount":{"type":"decimal","description":"Alt üye işyerine aktarılacak tutar."},"merchantPayoutAmount":{"type":"decimal","description":"Komisyon ve blokajlar sonrası üye işyerine gönderilecek tutar."},"convertedPayout":{"$ref":"#/components/schemas/ReportingConvertedPayout"},"refunds":{"type":"array","description":"Kırılım bazında iade işlemleri.","items":{"$ref":"#/components/schemas/ReportingRefund"}}}},"ReportingConvertedPayout":{"type":"object","properties":{"paidPrice":{"type":"decimal","description":"Tahsilat tutarının kırılım bazındaki dağılımı."},"iyziCommissionRateAmount":{"type":"decimal","description":"iyzico komisyon tutarı (kırılım, dönüşüm sonrası)."},"iyziCommissionFee":{"type":"decimal","description":"iyzico işlem ücreti (kırılım, dönüşüm sonrası)."},"blockageRateAmountMerchant":{"type":"decimal","description":"Üye işyeri blokaj tutarı (dönüşüm sonrası, üye işyeri)."},"blockageRateAmountSubMerchant":{"type":"decimal","description":"Alt üye işyeri blokaj tutarı (dönüşüm sonrası)."},"subMerchantPayoutAmount":{"type":"decimal","description":"Alt üye işyerine aktarılacak tutar (dönüşüm sonrası)."},"merchantPayoutAmount":{"type":"decimal","description":"Üye işyerine gönderilecek tutar (dönüşüm sonrası)."},"iyziConversionRate":{"type":"decimal","description":"Kur oranı."},"iyziConversionRateAmount":{"type":"decimal","description":"Kur oranı sonucu tutar."},"currency":{"type":"string","description":"Para birimi.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]}}},"ReportingRefund":{"type":"object","properties":{"refundTxId":{"description":"İade işlem ID’si.","oneOf":[{"type":"string"},{"type":"integer"}]},"refundConversationId":{"type":"string","description":"İade işlemine ait conversationId."},"refundPrice":{"type":"decimal","description":"İade tutarı."},"refundStatus":{"type":"integer","description":"İade durum kodu."},"isAfterSettlement":{"type":"boolean","description":"İade para gönderimi sonrası mı yapıldı?"},"createdDate":{"type":"string","description":"ISO-8601 oluşturulma zamanı."},"currencyCode":{"type":"string","description":"Para birimi.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"authCode":{"type":"string","description":"Bankadan dönen authCode değeri."},"hostReference":{"type":"string","description":"Sağlayıcı tarafından verilen hostReference değeri."},"iyziCommissionRateAmount":{"type":"decimal","description":"İade işleminde komisyon tutarı (varsa)."}}},"ErrorResponse":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"errorCode":{"type":"string","description":"İşlem hatasına dair kod."},"errorMessage":{"type":"string","description":"İşlem hatasına dair mesaj. Locale parametresine göre dil desteği sunar."},"errorGroup":{"type":"string","description":"Hata grubu."}}}]}}}} ``` #### Örnek Kodlar
PHP
Java
.Net
Python
Postman
## Gün Bazında Raporlama > Belirli bir tarihte gerçekleşen ödeme/iptal/iade işlemlerinin listesini döner. ```json {"openapi":"3.0.3","info":{"title":"İşlem Detayı Raporlama","version":"1.0.0"},"tags":[{"name":"Reporting","description":"Raporlama uçları"}],"servers":[{"url":"https://api.iyzipay.com","description":"iyzico API"}],"paths":{"/v2/reporting/payment/transactions":{"get":{"summary":"Gün Bazında Raporlama","description":"Belirli bir tarihte gerçekleşen ödeme/iptal/iade işlemlerinin listesini döner.","tags":["Reporting"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"$ref":"#/components/parameters/LocaleQuery"},{"$ref":"#/components/parameters/ConversationIdQuery"},{"name":"page","in":"query","required":true,"schema":{"type":"integer","minimum":1},"description":"Sayfa numarası (1’den başlar)."},{"name":"transactionDate","in":"query","required":true,"schema":{"type":"string"},"description":"Sorgulanacak gün (YYYY-MM-DD). Örn: `2025-07-24`.\n"}],"responses":{"200":{"description":"Başarılı yanıt — gün bazında işlemler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportingDailyTransactionsResponse"}}}},"400":{"description":"Geçersiz istek / doğrulama hatası","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"schema":{"type":"string"},"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir."},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string"},"description":"İstek gövdesinin veri formatı."},"LocaleQuery":{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["tr","en"]},"description":"Dil kodu."},"ConversationIdQuery":{"name":"conversationId","in":"query","required":false,"schema":{"type":"string"},"description":"İstek/yanıt eşleştirmesi için kullanılabilir. İstekte gönderilen veri, yanıtta aynen geri döner."}},"schemas":{"ReportingDailyTransactionsResponse":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"transactions":{"type":"array","description":"Gün içindeki işlemler.","items":{"$ref":"#/components/schemas/ReportingDailyTransactionItem"}},"currentPage":{"type":"integer","description":"Mevcut sayfa numarası."},"totalPageCount":{"type":"integer","description":"Toplam sayfa sayısı."}}}]},"BaseResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucunu bildirir.","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili (tr/en)."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID (varsa)."}}},"ReportingDailyTransactionItem":{"type":"object","properties":{"transactionType":{"type":"string","description":"İşlem Tipi.","enum":["CANCEL","PAYMENT","REFUND"]},"transactionDate":{"type":"string","description":"İşlem zamanı (yyyy-MM-dd HH:mm:ss)."},"transactionId":{"description":"İşlem ID'si.","type":"string"},"transactionStatus":{"type":"integer","description":"Ödeme kırılımının durumu.\n- 0: Fraud kontrolünde\n- -1: Fraud kontrolünden sonra reddedildi\n- 1: Onaylandı. (Pazaryerinde 1 değeri Üye İşyeri Onayı Bekliyor Anlamına Gelir)\n- 2: Onaylandı (Pazaryeri Onay Verilmiş)\nenum: [ 0, -1, 1, 2 ]\n"},"afterSettlement":{"type":"integer","description":"Para gönderimi sonrası işlem mi? 0=Hayır, 1=Evet (REFUND işlemleri için).","enum":[0,1]},"paymentTxId":{"description":"Ödeme kırılım ID’si.","type":"string"},"paymentId":{"description":"Ödeme ID’si.","type":"string"},"conversationId":{"type":"string","description":"İşleme ait conversationId (varsa)."},"paymentPhase":{"type":"string","description":"Ödeme fazı."},"price":{"type":"decimal","description":"Ürün/işlem tutarı."},"paidPrice":{"type":"decimal","description":"Tahsil edilen tutar."},"transactionCurrency":{"type":"string","description":"İşlem para birimi.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"installment":{"type":"integer","description":"Taksit sayısı."},"threeDS":{"type":"integer","description":"3DS ile mi yapıldı? 0=Hayır, 1=Evet.","enum":[0,1]},"settlementCurrency":{"type":"string","description":"Mutabakat para birimi.","enum":["TRY","USD","EUR","GBP","NOK","CHF"]},"connectorType":{"type":"string","description":"Bağlantı/pos sağlayıcı tipi."},"posOrderId":{"type":"string","description":"Pos sipariş numarası."},"authCode":{"type":"string","description":"Banka authCode değeri."},"hostReference":{"type":"string","description":"Sağlayıcı hostReference değeri."},"basketId":{"type":"string","description":"Sepet ID’si."},"iyzicoCommission":{"type":"decimal","description":"Komisyon (PAYMENT işlemleri için)."},"iyzicoFee":{"type":"decimal","description":"İşlem ücreti (PAYMENT işlemleri için)."},"parity":{"type":"decimal","description":"Kur paritesi (PAYMENT işlemleri için)."},"iyzicoConversionAmount":{"type":"decimal","description":"Kur çevrim tutarı (PAYMENT işlemleri için)."},"merchantPayoutAmount":{"type":"decimal","description":"Üye işyerine ödenecek tutar (PAYMENT işlemleri için)."},"subMerchantPayoutAmount":{"type":"decimal","description":"Alt üye işyerine ödenecek tutar (PAYMENT işlemleri için)."}}},"ErrorResponse":{"allOf":[{"$ref":"#/components/schemas/BaseResponse"},{"type":"object","properties":{"errorCode":{"type":"string","description":"İşlem hatasına dair kod."},"errorMessage":{"type":"string","description":"İşlem hatasına dair mesaj. Locale parametresine göre dil desteği sunar."},"errorGroup":{"type":"string","description":"Hata grubu."}}}]}}}} ``` #### Örnek Kodlar
PHP
Java
.Net
Python
Postman
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.iyzico.com/ek-servisler/raporlama-servisi.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.