Choose your environment

Bamboo provides two environments. Depending on how you handle card data, the endpoint you should use varies:

Staging for simulations and homologation (recommended first).
Production for live payments after certification.

Installments API Reference

Environment	Endpoint
Staging	`https://api.stage.bamboopayment.com/v1/api/installment/calculate`
Production	`https://api.bamboopayment.com/v1/api/installment/calculate`

Building the request

Headers

⚠️
Remember to include the Merchant Private Key in the request headers.
For more details, refer to our Authentication Guide

Request parameters

Parameter	Type	Mandatory?	Description
`CountryCode`	`string`	Yes	Country where the payment will be processed (ISO-3166-1).
`CurrencyCode`	`string`	Yes	ISO-4217 currency.
`Amount`	`integer (64bit)`	Yes	Amount with two decimals, no separators (`12.25` → `1225`).
`BIN`	`string`	No	Card BIN.
`Token`	`string`	No	Card Token.

Request example

{
  "CountryCode": "AR",
  "CurrencyCode": "ARS",
  "Amount": 150000,
  "Bin": "123456",
  "Token": "OT__ar_7Jr8K2rQyZC9m4fVx1pQw2e3s4t5u6v"
}

Response Parameters

Parameter	Type	Description
`CountryCode`	`string`	Country where the payment will be processed (ISO-3166-1).
`CurrencyCode`	`string`	ISO-4217 currency.
`Amount`	`integer (64bit)`	Amount with two decimals, no separators (`12.25` → `1225`).
`BIN`	`string`	Card BIN.
`Token`	`string`	Card Token.
`Installments`	`object`	Installments Data

Installments Data Obtect

Parameter	Type	Description
`InstallmentNumber`	`integer`	Installment number configure for the merchant
`InstallmentFee`	`integer (64bit)`	Fee percentage that applies to the transaction
`TotalAmount`	`integer (64bit)`	Final transaction amount with the fee assumed by the end user Amount with two decimals, no separators (`12.25` → `1225`).
`InstallmentAmount`	`integer (64bit)`	Amount of each installment

Response example

{
    "CountryCode": "AR",
    "CurrencyCode": "ARS",
    "Amount": 150000,
    "Bin": null,
    "Token": null,
    "Installments": [
        {
            "InstallmentNumber": 2,
            "InstallmentFee": 10,
            "TotalAmount": 165000,
            "InstallmentAmount": 82500
        },
        {
            "InstallmentNumber": 3,
            "InstallmentFee": 20,
            "TotalAmount": 180000,
            "InstallmentAmount": 60000
        }
    ]
}