If a chargeback was applied (requested by the user) a notification is sent to the previously registered Merchant chargeback notification URL by POST protocol, sending the following parameters:
Property | Type | Description |
| String | The chargeback id. |
| String | The payment id. |
| Positive Float | The amount of the chargeback. |
| String | The currency of the chargeback. |
| String | The status of the chargeback. |
| String | The status code of the chargeback. |
| String | The description of the chargeback's status. |
| String | The date of when the chargeback was executed. |
Chargeback notifications are signed. Learn more about the signature notifications here.​
Example post
POST: {merchant.chargeback_url}
{"id": "CHAR42342","payment_id": "PAY245235","amount": 100.00,"currency": "USD","status": "COMPLETED","status_code": "200","status_detail": "The chargeback was executed.","created_date" : "2018-02-15T15:14:52-00:00"}
{"id": "CHAR42342","payment_id": "PAY245235","amount": 100.00,"currency": "USD","status": "COMPLETED","status_code": "200","status_detail": "The chargeback was executed.","created_date" : "2018-02-15T15:14:52-00:00"}
$ curl \-H 'X-Date: 2018-02-20T15:44:42.310Z' \-H 'X-Login: sak223k2wdksdl2' \-H 'X-Trans-Key: fm12O7G9' \-H 'X-Version: 2.1' \-H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \https://api.dlocal.com/chargebacks/CHAR42342
{"id": "CHAR42342","status": "COMPLETED","status_code": "200","status_detail": "The chargeback was executed."}
Status | Status code | Description |
| 100 | The chargeback is pending. |
| 101 | Dispute documentation received |
| 200 | The chargeback was executed. |
| 201 | Dispute documentation was sent to the acquirer. |
| 202 | The chargeback dispute was lost. |
| 700 | The chargeback dispute was won. |
| 800 | Request for information received. |
In the Production environment, Chargebacks are triggered by the buyer by calling their bank. In dLocal's Sandbox environment though, merchants can simulate a Chargeback using the method described below:
{"id": "CBK-4-184-45b0b9ae-4e05-419e-9248-d5890437b719"}
$ curl -X POST \-H 'X-Date: 2018-02-20T15:44:42.310Z' \-H 'X-Login: sak223k2wdksdl2' \-H 'X-Trans-Key: fm12O7G9' \-H 'Content-Type: application/json' \-H 'Authorization: V2-HMAC-SHA256, Signature: 1bd227f9d892a7f4581b998c21e353b1686a6bdad5940e7bb6aa596c96e0a6ec' \https://sandbox.dlocal.com/sandbox-tools/chargebacks
{"payment_id" : "PAY4334346343"}