Fetch Chargebacks

Retrieve chargebacks filtered by report date for dispute tracking and risk monitoring.

curl "https://api.catalystpay.com/api/v1/reconciliation/chargebacks/?start_date=2025-01-01&end_date=2025-03-31" \
  -H "Authorization: Bearer rk_your_api_key"

import requests

response = requests.get(
    "https://api.catalystpay.com/api/v1/reconciliation/chargebacks/",
    headers={"Authorization": "Bearer rk_your_api_key"},
    params={
        "start_date": "2025-01-01",
        "end_date": "2025-03-31",
    },
)

data = response.json()
for cb in data["results"]:
    print(f"{cb['id']} | {cb['reason_code']} | {cb['amount']} {cb['currency']}")

const params = new URLSearchParams({
  start_date: '2025-01-01',
  end_date: '2025-03-31',
});

const response = await fetch(
  `https://api.catalystpay.com/api/v1/reconciliation/chargebacks/?${params}`,
  { headers: { 'Authorization': 'Bearer rk_your_api_key' } }
);

const data = await response.json();
data.results.forEach(cb => {
  console.log(`${cb.id} | ${cb.reason_code} | ${cb.amount} ${cb.currency}`);
});

Response:

{
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "adapter_unique_id": "CB-12345",
      "merchant_transaction_id": "TXN-67890",
      "tenant_reference_id": "merchant-order-42",
      "status": "charged_back",
      "type": "chargeback",
      "amount": "29.99",
      "currency": "EUR",
      "report_date": "2025-02-15T00:00:00Z",
      "transaction_date": "2025-01-20T00:00:00Z",
      "reason_code": "MD06",
      "reason_message": "Refund request by end customer",
      "iban": "******************3000",
      "bic": "COBADEFFXXX",
      "arn": "74023960001234567890123",
      "cb_bank_fee": "25.00",
      "transaction_id": "b2c3d4e5-f6a7-8901-bcde-234567890123",
      "lead_id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "payment_gateway_id": "f7e8d9c0-b1a2-3456-cdef-890123456789"
      // ... additional fields
    }
  ]
}

Date filtering operates on report_date (when the chargeback was reported), not transaction_date. Additional filters: status, type, payment_gateway_id, and page_size (1-1000). See How to Reconcile Chargebacks for the full guide.

Fetch Transactions

Fetch Subscriptions