List chargebacks
This endpoint retrieves a list of chargebacks associated with your account. A Chargeback is a mandatory transaction reversal initiated by the consumer's card issuer or bank, usually due to a dispute over a transaction. When a chargeback occurs, the costumer effectively reverses the transaction, resulting in a debit of the disputed amount from the merchant's account. This endpoint allows you to view details of chargebacks, including the reason for the dispute, transaction amount, and status, providing insights into consumer disputes and their impact on your financials.
Required scope: <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">chargeback:read</code>
Query parameters
The cursor parameter is used for pagination. It specifies the pointer to the start of the next set of results in a sequence of paginated data. Typically, this is a unique identifier of the last item from the previous response. If not provided, the API fetches the first page of results.
The limit parameter is used for pagination. It specifies the maximum number of entries to return in a single page of results. Max 100.
Filter records by creation datetime interval in UTC. Maximum allowed range is 30 days. Format: interval(YYYY-MM-DD HH:MM,YYYY-MM-DD HH:MM).
Filter chargebacks by capture UUID. Returns only chargebacks associated with the specified capture.
Response
OK
Example response
{
"data": [
{
"id": "c6056234-a3f9-42de-b944-3ed793fcb6bb",
"created_at": "2006-01-02 15:04",
"message": "MD06 - Refund Request by End Customer",
"code": "MD06",
"amount": 12.87,
"capture": {
"id": "c6056234-a3f9-42de-b944-3ed793fcb6bb",
"payment_id": "c6056234-a3f9-42de-b944-3ed793fcb6bb"
}
}
],
"metadata": {
"next_cursor": "lL_j7ilk7rc",
"count": 10
}
}