Market specifications

Do you want to know more information about Bolivia's market? Go to the Tap Into Latin America’s High-Growth Potential article.

Country reference

`country` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.document.id` format
`BO`	`BOB`	2	CI or NIT	Between 5 to 20 digits for CI and 7 to 10 (usually 9) digits for NIT.

Document validations

Validation	Name	Length	Type	Verification digit	Example
Cédula de identidad	CI	Up to 8	Numeric	No check digit	1234567
Cédula de Identidad de extranjero (Foreign ID number)	CE	Up to 8	E - (numeric)	No check digit	E-1234567
Número de Identificación Tributaria (For companies)	NIT	Up to 15	Numeric

Mandatory parameters

Bank transfers

Bank transfer parameters	B2C	B2B
`external_id`	Yes	Yes
`payment_method_id`	Yes	Yes
`flow_type`	Yes	Yes
`purpose`	Yes	Yes
`amount`	Yes	Yes
`country`	Yes	Yes
`currency`	Yes	Yes
`currency_to_pay`	-	-
`beneficiary.document.id`	Yes	Yes
`beneficiary.document.type`	Yes	Yes
`beneficiary.first_name`	Yes	Yes
`beneficiary.last_name`	Yes	Yes
`beneficiary.bank_account.code`	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes

Payment methods

Bolivia supports payouts via Bank transfers. This method requires specific parameters and follows validation rules aligned with local compliance and banking standards.

Bank transfers

Bank transfers in Bolivia require detailed account information, including document ID, document type, bank code, and bank account number. The format of these fields depends on the receiving bank, and strict validation rules apply.

Refer to the document validations, bank account validations and bank codes sections for format specifications.

Mandatory parameters

All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types.

Mandatory parameter	Description
`external_id`	Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business).
`purpose`	Payout purpose code. See purpose codes reference.
`amount`	Payout amount in the currency set in the `currency` field. Use up to 2 decimal places.
`country`	Country code. For Bolivia, use `BO`.
`currency`	Source currency of the FX operation. For Bolivia, use `BOB` or `USD`.
`currency_to_pay`	Currency to be paid out. Mandatory only if the payout needs to be paid in USD. In case this parameter is missing, the payout will be paid in local currency.
`beneficiary.document.id`	Beneficiary's document number. See document validations below.
`beneficiary.document.type`	Beneficiary's document type. See document validations below.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters.
`beneficiary.bank_account.code`	Beneficiary's bank code. See bank codes below.
`beneficiary.bank_account.account`	Beneficiary's bank account number. Format varies by bank. See bank account validations below.

Example request

{
  "external_id": "1234567812345678",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "amount": 1100.00,
  "country": "BO",
  "currency": "BOB",
  "beneficiary": {
    "document": {
      "id": "1234567",
      "type": "CI"
    },
    "first_name": "JUAN",
    "last_name": "GOMEZ",
    "bank_account": {
      "code": "1",
      "account": "9087654321"
    }
  },
  "notification_url": "https://thisisawebsite.net"
}

{
    "external_id": "1234567812345678",
    "payment_method_id": "BANK_TRANSFER",
    "flow_type": "B2C",
    "purpose": "OTHER_SERVICES",
    "amount": 1100.00,
    "country": "BO",
    "currency": "BOB",
    "currency_to_pay": "USD",
    "beneficiary": {
        "document": {
            "id": "1234567",
            "type": "CI"
        },
        "first_name": "JUAN",
        "last_name": "GOMEZ",
        "bank_account": {
            "code": "1",
            "account": "9087654321"
        }
    },
    "notification_url": "https://thisisawebsite.net"
}

{
    "external_id": "{{currentDateConcatenated}}",
    "payment_method_id": "BANK_TRANSFER",
    "flow_type": "B2B",
    "purpose": "OTHER_SERVICES",
    "amount": 5500.00,
    "country": "BO",
    "currency": "BOB",
    "beneficiary": {
        "document": {
            "id": "123456789",
            "type": "NIT"
        },
        "first_name": "EMPRESA",
        "last_name": "BOLIVIANA SA",
        "bank_account": {
            "code": "3",
            "account": "1234567890"
        }
    },
    "notification_url": "https://thisisawebsite.net"
}

{
  "external_id": "1234567812345678b2b",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2B",
  "purpose": "OTHER_SERVICES",
  "amount": 5500.00,
  "country": "BO",
  "currency": "BOB",
  "currency_to_pay": "USD",
  "beneficiary": {
    "document": {
      "id": "123456789",
      "type": "NIT"
    },
    "first_name": "EMPRESA",
    "last_name": "BOLIVIANA SA",
    "bank_account": {
      "code": "3",
      "account": "1234567890"
    }
  },
  "notification_url": "https://thisisawebsite.net"
}

Bank information

Access the reference formats and accepted values required for processing bank payouts in Bolivia.

Bank account validations

Bank name	Validation
Banco Mercantil	Digits length 10
Banco Nacional de Bolivia	Digits length 10
Banco Unión	Digits length 14
Other banks	Digits up to 15

Bank codes

These are the bank codes supported in Bolivia for accounts in local currency (BOB) as well as USD.

Bank Name	Bank Code
Banco BISA	5
Banco de Crédito de Bolivia	3
Banco Do Brasil	4
Banco Económico	7
Banco Ecofuturo	47
Banco FIE	45
Banco Fortaleza	49
Banco Ganadero	9
Banco Mercantil	1
Banco Nacional de Bolivia	2
Banco Solidario	8
Banco Unión	6
Cooperativa Catedral	38
Cooperativa Comarapa	34
Cooperativa Educadores Gran Chaco	37
Cooperativa El Chorolque	36
Cooperativa Fátima	24
Cooperativa Hospicio	27
Cooperativa Incahuassi	30
Cooperativa Jesús Nazareno	22
Cooperativa Loyola	26
Cooperativa PIO X	29
Cooperativa Quillacollo	31
Cooperativa San Antonio	28
Cooperativa San Jose de Punata	32
Cooperativa San Martin	23
Cooperativa San Mateo	35
Cooperativa San Pedro	25
Cooperativa San Joaquín	40
Cooperativa Trinidad	33
Cooperativa Trapetrol Oriente	41
Financiera Acceso La Paz	43
Fondo Financiero de la Comunidad	44
Magisterio Rural	39
Mutual del Pueblo	19
Mutual el Progreso	14
Mutual Guapay	12
Mutual La Plata	15
Mutual la Primera	11
Mutual la Promotora	13
Mutual la Tarija	17
Mutual Manutata	21
Mutual Paititi	18
Mutual Potosí	16
Nacional Financiera Boliviana SAN	42