Ödeme İşlemleri Raporu

Ödeme işlemlerinizi raporlayın

Bu API hizmeti, Zotlo üzerinden gerçekleşen ödemelere ait işlem kayıtlarını performanslı, güvenli ve ölçeklenebilir bir şekilde sorgulamanıza olanak tanıyan read-only bir raporlama servisidir.

Bu API hizmeti, ödeme platformunda üretilen tüm transaction kayıtlarını; tarih aralığı, paket/ürün, ülke gibi filtreler ile sorgulamanızı sağlar. Cursor tabanlı sayfalama yapısı sayesinde büyük hacimli verileri hızlı bir şekilde çekebilir ve entegrasyon süreçlerinizi stabil şekilde yürütebilirsiniz.

İlgili servis GET metodu ile çalışır ve temel endpoint aşağıdaki gibidir:

GET https://api.zotlo.com/v1/reports/activity/transaction

Parametreler	Açıklama	Zorunlu mu?
limit	Döndürülecek maksimum kayıt sayısı. (Default: 25, max: 100)	Opsiyonel
country	İşlemin gerçekleştiği ülkeye göre filtreleme.	Opsiyonel
package_id	İşlemin bağlı olduğu paket/plan türüne göre filtreleme.	Opsiyonel
start_date	Belirtilen tarihten sonraki işlemleri listeler. (Y-m-d)	Opsiyonel
end_date	Belirtilen tarihten önceki işlemleri listeler. (Y-m-d)	Opsiyonel
before	Bir önceki sayfaya geçmek için, response içinde dönen before cursor değerinin tekrar gönderilmesi gerekir.	Yalnızca sayfalama aşamasında zorunlu.
after	Bir sonraki sayfaya geçmek için, response içinde dönen after cursor değerinin tekrar gönderilmesi gerekir.	Yalnızca sayfalama aşamasında zorunlu.

Örnek İstek:

Ödeme İşlemleri Raporu servisine istek gönderirken gerekli olan Access Key,Access Secret ve App Id bilgilerine, Zotlo Panel'de yer alan Developer Tools/API Keys sayfasından ulaşabilirsiniz. Bu bilgileri isteğin header'ında göndermeniz gerekmektedir.

GET https://api.zotlo.com/v1/reports/activity/transaction?limit=50?&start_date=2025-11-01&end_date=2025-11-30 HTTP/1.1
AccessKey: ••••••
AccessSecret: ••••••
Content-Type: application/json
ApplicationId: •
Language: ••

Başarılı Cevap Örneği

{
  "meta": {
    "requestId": "5896c0267514-REQ-6924605fb81f4",
    "httpStatus": 200
  },
  "result": {
    "data": [
      {
        "id": 1723,
        "paymentType": "subscription",
        "originalTransactionId": "29d557b4-2563-497b-ad1f-677ac6910b81",
        "transactionId": "29d557b4-2563-497b-ad1f-677ac6910b81",
        "packageId": "web_premium",
        "status": "start_paid",
        "purchaseDate": "2025-11-10 08:27:37",
        "originalPurchaseDate": "2025-11-10 08:27:37",
        "price": "200.00",
        "currency": "TRY",
        "country": "TR",
        "expireDate": "2025-11-10 08:28:08",
        "subscriberId": "3a33eb5d-3e4b-4875-916f-7e9fb5867f3f",
        "creditCard": "37442754***1042",
        "refundPrice": "200.00",
        "refundDate": "2025-11-10 08:28:08",
        "refundReason": "{\"reason\":\"\",\"user\":\"API: \"}",
        "isRefund": 1,
        "providerName": "BBVA",
        "jsonPayload": "{\"forceWebhook\":true,\"cardBrand\":\"amex\",\"threeds\":\"0\",\"installment\":\"1\",\"bank\":\"garanti\",\"subscriberIpAddress\":\"0.0.0.0\"}",
        "quantity": 1,
        "packagePrice": "200.00",
        "subscriptionId": 343
      },
      {
        "id": 1722,
        "paymentType": "subscription",
        "originalTransactionId": "6edc57b0-86a1-4ba7-bf9a-81d05afbf505",
        "transactionId": "6edc57b0-86a1-4ba7-bf9a-81d05afbf505",
        "packageId": "web_premium",
        "status": "start_paid",
        "purchaseDate": "2025-11-10 08:19:29",
        "originalPurchaseDate": "2025-11-10 08:19:29",
        "price": "200.00",
        "currency": "TRY",
        "country": "TR",
        "expireDate": "2025-11-10 08:26:59",
        "subscriberId": "8aa4de92-a86d-4330-bb3c-6995a5f837ed",
        "creditCard": "37442754***1042",
        "refundPrice": "200.00",
        "refundDate": "2025-11-10 08:26:59",
        "refundReason": "{\"reason\":\"\",\"user\":\"API: \"}",
        "isRefund": 1,
        "providerName": "BBVA",
        "jsonPayload": "{\"forceWebhook\":true,\"cardBrand\":\"amex\",\"threeds\":\"0\",\"installment\":\"1\",\"bank\":\"garanti\",\"subscriberIpAddress\":\"0.0.0.0\"}",
        "quantity": 1,
        "packagePrice": "200.00",
        "subscriptionId": 342
      }
    ],
    "paging": {
      "cursors": {
        "previous": null,
        "next": "DPn5BRhxQmvSvYRkfK3KQXUzYXpDSlcvUVVQREluUUxGbDFFR2xKV1dJNzM1Wnc2aE4xcERTNHdVWFRQV21selI1UDFuOWJ2Z0d4TmJCY3JFK3BzbTJxM0lkc3JGcVlmSThCK1ZYYUVPNWxmSnlTb0lhR0hnY2tBeE9HNEd5RFdnRFBOazVpMDlUZ1N1L1FuL0tCeDFzaUdxOGJLSFljZGdiTSttRzlkNzBXbXZPUnI0RWNWOHlUcDk3S1M1ZWlZbFBva0o1UENXV0RkOXlJTTdDUUtFalh1bEt2YzFTcUd6Nk9qUzBnNGRyVWcxbGZ2L2RBS2pvSVpNbVRPOE54WUZyQ3pMaFZtenhvbG4veHg"
      },
      "previous": "https://local-api.zotlo.com:39443/v1/reports/activity/transaction",
      "next": "https://local-api.zotlo.com:39443/v1/reports/activity/transaction?after=DPn5BRhxQmvSvYRkfK3KQXUzYXpDSlcvUVVQREluUUxGbDFFR2xKV1dJNzM1Wnc2aE4xcERTNHdVWFRQV21selI1UDFuOWJ2Z0d4TmJCY3JFK3BzbTJxM0lkc3JGcVlmSThCK1ZYYUVPNWxmSnlTb0lhR0hnY2tBeE9HNEd5RFdnRFBOazVpMDlUZ1N1L1FuL0tCeDFzaUdxOGJLSFljZGdiTSttRzlkNzBXbXZPUnI0RWNWOHlUcDk3S1M1ZWlZbFBva0o1UENXV0RkOXlJTTdDUUtFalh1bEt2YzFTcUd6Nk9qUzBnNGRyVWcxbGZ2L2RBS2pvSVpNbVRPOE54WUZyQ3pMaFZtenhvbG4veHg"
    }
  }
}

Başarısız Cevap Örneği

Servislerimizden HTTP status code olarak başarılı durumlarda 200 dönmektedir. Başarısız durumlarda ise 400 ya da 500 Http StatusCode dönmektedir. Örnek hata cevabı aşağıdaki şekildedir.

{
  "meta": {
    "requestId": "5896c0267514-REQ-692464aa9a8c8",
    "httpStatus": 400,
    "errorMessage": "Invalid start_date format. Use Y-m-d",
    "errorCode": "400024"
  },
  "result": []
}

Başarısız Cevap Parametreleri:

Başarısız dönen isteklerde yer alan parametreler aşağıdaki gibidir. Başarısız isteklerde hata kodu olarak 400 ya da 500 dönmektedir.

requestId	Hatanın HTTP durum kodu değeriHer istek için sistem tarafından atanan id değeridir. Sistemsel hatalarda log'lardan hata yakalamak için kullanılır.
httpStatus	Hatanın HTTP durum kodu değeri
errorMessage	Hata mesajıdır. Tüm hata kodlarına buradan ulaşabilirsiniz.
errorCode	İlgili hata için Zotlo tarafından verilen hata kodu