Configuring the Authentication

All methods require the following authentication headers.

Key	Value	Comments
`Content-Type`	`application/json`	Indicates that the request body is transmitted in JSON format.
`Authorization`	`Basic {{Merchant Private Key}}`	Send the `{{Merchant Private Key}}` (your merchant identifier) prefixed with the word `Basic`. Example: `Basic RVkeLr-86_iTzSMLvDtuyQ-1zqIcsmFG-oSzncn_uFv-nj7bhB3rtZg__`

Setting the Language of the Response Codes for Payins

Error descriptions can be localized by including the lang header in your request.
Use any of the following languages in ISO 639-1 format.

Code	Language
`en`	English. Default language. If no header is sent, or the value is invalid, the response will default to English.
`es`	Spanish.
`pt`	Portuguese.

Payins Guide

Learn how to create, capture, and refund purchases using Bamboo’s Payins API.

Payouts Guide

Explore payout creation, status tracking, and beneficiary configuration.

MCP Server

Connect AI tools to Bamboo’s API and documentation using MCP.

Postman Collection

Access ready-to-use Postman environments for staging and production testing.

Error Codes: Payins

Review the list of possible error responses and their resolutions for Payins.

Error Codes: Payouts

Review the list of possible error responses and their resolutions for Payouts.