Receive real-time chargeback updates via webhook. Includes status, reason codes, and transaction references for dispute management.
The Chargeback Notification informs merchants when a chargeback is created or when its status changes during the dispute process.
Chargeback Statuses
| Status | Description |
|---|---|
PENDING | The chargeback was created in the system and the balance reservation was made. |
APPROVED | The chargeback was approved by the acquirer or issuer. The dispute was lost and the funds remain debited from the merchant’s account. |
REJECTED | The chargeback was rejected or reversed. The dispute was won, and the reserved amount is returned to the merchant’s account as a credit. |
Notification Parameters
Parameter | Type | Description |
|---|---|---|
|
| Unique identifier of the chargeback. |
|
| UUnique identifier of the related purchase. |
|
| Amount of the chargeback |
|
| Currency of the chargeback amount, according to ISO-4217 |
|
| Current status code of the chargeback |
|
| Date and time when the chargeback transaction was created or change its status. Date format ISO-8601 |
|
| Purchase order number generated by the merchant. |
|
| Chargeback reason code |
|
| Chargeback reason description |
Example Notification
{
"chargebackId": "123456",
"transactionId": "6594100",
"amount": 62615,
"currency": "UYU",
"status": "PENDING",
"created": "2024-02-17T18:10:45.667",
"order": "merchant-1236540",
"reasonCode": "13.3",
"description": "Multiple processing of a transaction"
}Response Expected
The merchant’s webhook endpoint must return HTTP 200 (OK) to confirm that the notification was successfully received and processed. If Bamboo receives any other status code or no response, the notification will be retried according to the Retry Policy
| Response Code | Meaning |
|---|---|
200 | Notification successfully received and processed. |
4xx | Client-side error (invalid endpoint, payload rejection, or failed signature validation). |
5xx | Temporary server error. Bamboo will retry the notification automatically. |