BREB

Rail overview

Use BREB for Colombian bank payouts when the recipient should receive funds through local bank infrastructure.

Conomy captures the withdrawal from an internal ACCOUNT and sends the payout instruction to the provider for bank processing.

Region Colombia

Currency COP

Direction Pay-out

Model Bank payout rail

Collect enough recipient bank data before capture so failures are validation issues, not operational exceptions.

Required fields

Field	Type	Description
type	string	Must be "BREB"
currency	string	Must be "COP"
breb.bankId	string	Recipient bank code
breb.accountNumber	string	Recipient account number
breb.customer.firstName	string	Recipient first name
breb.customer.lastName	string	Recipient last name
breb.customer.email	string	Recipient email

Example

{
  "type": "BREB",
  "currency": "COP",
  "breb": {
    "bankId": "1022",
    "accountNumber": "123456789",
    "customer": {
      "firstName": "Camila",
      "lastName": "Torres",
      "email": "camila@example.com"
    }
  }
}

Object

bankIdstringrequired

Bank identifier for the recipient's account.

accountNumberstringrequired

Recipient's bank account number.

accountTypestring

CHECKINGSAVINGS

customerobjectrequired

Information on who pays the transaction

idstring

Unique identifier for the internal service.

firstNamestringrequired

Payer's name

emailstring

Payer's email

lastNamestring

Payer's last name

phoneNumberstring

Payer's phone number without prefix

phoneNumberPrefixstring

Phone number prefix (e.g., +57)

documentTypestring

Documeny type of the entity (e.g., RUT, CURP, CURL). Go to the Supported Identity document types page for the complete list of supported values.

documentNumberstring

The document number associated with the documentType

addressobjectshow 8 properties

The entity’s address information.