Chargebacks

A chargeback occurs when a cardholder disputes a charge with the card issuer. When a new chargeback is received in Bamboo for a merchant, the merchant is notified via webhook. Additionally, once the chargeback is resolved — whether it is won or lost — a notification is also sent through the same channel.

Dispute documentation

If the merchant decides to dispute the chargeback, they must submit the corresponding documentation. For this purpose, the following API is available.

Request

To use the evidence API, you must point to the following endpoint:

PUT https://api.stage.bamboopayment.com/v2/api/purchase/{purchaseId}/chargeback/{chargebackId}/evidence

📘
Remember to include your merchant’s Private Key in the request headers.

Example of the request

{
  "fileName": "file-4.jpg",
  "description": "Bamboo test",
  "content": "base64 content",
}

Parameter	Type	Mandatory?	Description
fileName	string	Yes	File name to upload.
description	string	Yes	File description.
content	string	Yes	File in Base64 format.

Requirements

The allowed formats are PDF, JPEG and JPG.
The file must be uploaded in Base64 format.
The maximum file size per upload is 1MB.
Only one file can be uploaded per API call.