Getting Started

The Payouts API allows you to request multiple payments using the balance available in your account.

To learn more about Payouts, refer to this article.

Configuring the authentication

All methods used in Payouts API require the following authentication headers.

Key	Value	Comments
`Content-Type`	`application/json`	With this header, the request will be transmitted in JSON format.
`Authorization`	`Basic {{MerchantPrivateKey}}`	Send the `{{MerchantPrivateKey}}` (your merchant identifier) and the word `Basic`. Example: `Basic RVkeL-s86_iTzSMLvDtuyQ-1zqIcsmF-coSzncn_uFvQnj7b-B3rtZg__`
`DigitalSignature`	`{{DigitalSignature}}`	Signature to validate the transaction using the HmacSHA256 algorithm. This header is mandatory only for Payout creation.

Signing the message

Build the hash using the parameters country, amount, currency, reference, and type of the Request. When signing the onboarding contract with Bamboo, the secret-key and MerchantPrivateKey are provided to you.

Signature sample code

var json = JSON.parse(request.data);
let signdata = {Country:json.country, Amount: json.amount,Currency:json.currency, Reference:json.reference, Type: json.type};
var data = JSON.stringify(signdata);
var hexHash = CryptoJS.HmacSHA256(data, secret-key);
var hash = hexHash.toString(CryptoJS.enc.Hex);

API methods

The Payouts API offers four primary methods that you can use when requesting Payouts.

Get Bank list

This method lets you get the list of available banks in a country.

Request URL

You must invoke a GET request to the following URLs according to your needs.

Production: https://payout-api.bamboopayment.com/api/bank/country/{{Country}}
Stage: https://payout-api.stage.bamboopayment.com/api/bank/country/{{Country}}

Where {{Country}} represents the ISO code of the country you wish to inquire about, using the ISO 3166-2 format. List of countries available for Payouts.

Response parameters

Parameter	Format	Size	Description
`id`	`integer`	-	Internal identification of the bank.
`countryIsoCode`	`string`	2	Country to which the bank belongs.
`bankCode`	`string`	4	Internal code of the bank used in the parameter `payee.bankaccount.codebank` when requesting a Payout.
`bankName`	`string`	-	Name of the bank.
`payoutType`	`integer`	-	Payout type. Set any of the following values: `1` for Cash. `2` for Bank Transfer. `3` for Wallet. `4` for Instant Bank Transfer in Brazil.

Info

For Colombia, in the request it must be differentiated whether the entity is bank or wallet and consequently whether the type is 3 (wallet) or 2 (bank transfer).
In the response of the operation, "payoutType": 3 or "payoutType": 2 is returned as appropriate. List of banks and wallets in Colombia.

Response example

[ {
    "id": 680,
    "countryIsoCode": "CO",
    "bankCode": "1507",
    "bankName": "NEQUI",
    "payoutType": 3
},
{
    "id": 609,
    "countryIsoCode": "CO",
    "bankCode": "1058",
    "bankName": "BANCO PROCREDIT COLOMBIA",
    "payoutType": 2
},
{
...
} ]

Last modified September 19, 2024