Chargebacks

Merchants can view chargeback records related to previously created purchases using authenticated API requests.

Chargebacks can occur when users dispute a transaction. This may result in funds being deducted temporarily or permanently from the merchant, depending on the outcome of the dispute process.

The following endpoints are available to retrieve chargeback data:

Get All Chargebacks

Retrieves a paginated list of all chargebacks.

/merchant/v1/chargeback

Responses

{
  "data": [
    {
      "id": "e9c1d0be-8f62-4c47-9f01-bfcf0a3f263b",
      "originalTransactionId": "txn_abc123xyz",
      "fiatPaymentId": "bc672b47-e0b4-4a7e-9f88-7dba362410a9",
      "status": "Initiated",
      "method": "Card",
      "reasonCode": "fraudulent",
      "fiatCurrency": "USD",
      "amount": 120.5,
      "feeAmount": 5.25,
      "totalAmount": 125.75,
      "userEmail": "user@example.com",
      "userPhoneNumber": "+1234567890",
      "userKycLevel": "2",
      "userCreditCardBrand": "VISA",
      "userCreditCardBin": "123456",
      "userCreditCardLast4": "****1234",
      "completedAt": "2025-07-21T14:33:45Z",
      "originalTransactionDate": "2025-07-20T09:18:00Z"
    }
  ],
  "pagination": {
    "totalPages": 1,
    "totalItems": 1,
    "currentPage": 1
  }
}

This endpoint supports sorting using the sort query parameter.
The format is <field>_<direction>, for example: completedAt_desc.

Get Chargeback by ID

Retrieves detailed information about a specific chargeback.

/merchant/v1/chargeback/{id}

Request parameters

Responses

{
  "id": "e9c1d0be-8f62-4c47-9f01-bfcf0a3f263b",
  "originalTransactionId": "txn_abc123xyz",
  "fiatPaymentId": "bc672b47-e0b4-4a7e-9f88-7dba362410a9",
  "status": "Initiated",
  "method": "Card",
  "reasonCode": "fraudulent",
  "fiatCurrency": "USD",
  "amount": 120.5,
  "feeAmount": 5.25,
  "totalAmount": 125.75,
  "userEmail": "user@example.com",
  "userPhoneNumber": "+1234567890",
  "userKycLevel": "2",
  "userCreditCardBrand": "VISA",
  "userCreditCardBin": "123456",
  "userCreditCardLast4": "****1234",
  "completedAt": "2025-07-21T14:33:45Z",
  "originalTransactionDate": "2025-07-20T09:18Z"
}

Additional Notes

Field 'reasonCode' can return a null value on both endpoints.

08 January 2026