Bre B PayIn

Bre-B is Colombia’s national instant payment system created by the Banco de la República (the Colombian central bank). It lets people and businesses send and receive money instantly between different banks and digital wallets, 24/7, using simple “keys” (“llaves”) like a phone number, ID number, email, or QR code instead of full bank account numbers.

Allows the creation of pay-ins (incoming payments).

URL:https://api.payelu.xyz/api/v1/payments/payin_hth

Country Uses:

Colombia: Bre B

Request Parameters:

Parameter	Type	Description	Requeriment
`service_code`	string	’`BRB_CO`’	required
`amount`	num	Amount to process. e.g. `123.45`	required
`reference`	string	Merchant’s Unique ID for transaction. It must be 22 alfanumeric digits (i.e. ‘`0000000000002507135224`‘)	required
`account_doc_type`	string	Payer’s ID, CC for Cedula de Ciudadania and CE for Cedula de Extranjeria	required
`account_doc_id`	num	Payer’s number ID	required

Bre B Example Request:


{
    "service_code": "BRB_CO",
    "amount": 1500,
    "reference": "71823718293",
    "account_doc_id": "88265853",
    "account_doc_type": "CC"
}

Bre B Example Response:


{
    "status": "success",
    "data": {
        "transaction_id": "j9vveDt42tCiSNy",
        "key_value": "XXXXXXXXXXXXXX",
        "amount": 1500,
        "currency": "COP",
        "status": "PENDING",
        "reference": "71823718293",
        "created_at": "2026-05-11T14:14:01.899680+00:00",
        "updated_at": "2026-05-11T14:14:01.899680+00:00",
        "expired_at": "2026-05-12T05:14:01.899680+00:00",
        "redirect_hpp_url": "XXXXXXXXXXXXXXXXXXX"
    }
}

After receiving redirect_hpp_url, you need to redirect the client to the URL and wait for the final status of the transaction.

Bre B HPP & H2H 1. Bre B PayIn Country Uses:Request Parameters:Bre B Example Request:Bre B Example Response: