Banks

Banks represent the financial institutions available for a given country in the Conomy network.

Use the Banks API to retrieve the list of supported banks by country code. This is useful when building payment flows that require the payer to select their bank, such as PSE or local bank transfer methods.

Endpoints

GET /payments/banks/:country

List banks by country

get

Returns all supported banks and financial institutions for the given country code. Use the code value as the bank field in BANK_ACCOUNT, BREB, or SPEI payment nodes.

Authorizations

BearerToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

countrystringRequired

ISO country code (e.g., CHL, COL, PER, MEX).

Header parameters

x-api-keystringRequired

The API key used for authentication when making requests to the API Gateway.

User-AgentstringRequired

Identifies the application making the request.

Responses

200

Request processed successfully.

application/json

A financial institution supported by conomy for a given country.

codestringRequired

Bank code used in payment nodes (e.g., BANCO_CHILE, co_bancolombia).

namestringRequired

Human-readable bank name.

countryCodestringRequired

ISO country code of the bank (e.g., CHL, COL).

400

Invalid request parameters or payload.

application/json

500

Unexpected internal server error.

application/json

get

/payments/banks/{country}

HTTPcURLJavaScriptPython

GET /payments/banks/{country} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
x-api-key: text
User-Agent: text
Accept: */*

[
  {
    "code": "BANCO_CHILE",
    "name": "BANCO DE CHILE",
    "countryCode": "CHL"
  },
  {
    "code": "BCI",
    "name": "BCI",
    "countryCode": "CHL"
  },
  {
    "code": "SANTANDER",
    "name": "BANCO SANTANDER",
    "countryCode": "CHL"
  }
]