Product Overview
Send and receive Colombian pesos (COP) with Bitso. Colombia Payments connects your platform to the country’s main rails — Bre-B, PSE, and bank transfers (ACH) — with one consistent REST contract, real-time webhook updates, and clear status lifecycles.
Key Features & Benefits
- One API for COP rails: Use the same resources for Bre-B alias payments, PSE redirect charges, and ACH bank transfers.
- Payouts and pay-ins: Create payouts, register Bre-B pay-in keys to receive funds, start PSE pay-in intents, and read settled pay-ins.
- Real-time notifications: Webhooks keep your system informed as payouts, pay-in intents, and pay-ins change status.
- Secure & reliable: All requests must be authenticated using your Bitso API key and secret (HMAC).
- Safe retries: For Bre-B payouts,
preview_payout_idis the idempotency key — theIdempotency-Keyheader is not supported for that flow.
Time to Settlement
| Type | Processing time |
|---|---|
| Bre-B | ~20 seconds (up to 3 min max) |
| Nequi / Bancolombia | Between 10 and 15 minutes |
| Daviplata / Davivienda | Between 10 and 15 minutes |
| BBVA | Between 10 and 15 minutes |
| Grupo Aval | Between 10 and 15 minutes |
| Coopcentral | Between 10 and 15 minutes |
| Other banks (ACH) | Per ACH cycles |
Supported Rails
| Rail | Direction | Discriminator (type) | What it does |
|---|---|---|---|
| Bre-B | Payout | CO_BREB | Send COP to a beneficiary alias (phone, email, or other key types). |
| ACH | Payout | CO_ACH | Send COP to a Colombian bank account. Third-party payouts validate document_id by type; use NIT only for a legal person. |
| Bre-B | Pay-in | CO_BREB | Register a standing alias (payin_key) so payers can send you COP. |
| PSE | Pay-in | CO_PSE | Create a per-transaction pay-in intent and redirect the payer to online banking. Use bank_code 1022 in stage; in production use a code from https://api.bitso.com/v3/banks/co. |
| ACH | Pay-in | CO_ACH | Refund of an ACH payout only. See Get payin for the fields that link it to the payout that was returned. Inbound COP is Bre-B or PSE. |
Get Started
Ready to move COP?
- Set up credentials: Create or reuse Bitso API credentials and sign requests as described in Authentication.
- Register your webhook URL: Subscribe to payout, pay-in, and pay-in intent events with Create webhook subscriptions so you receive status updates.
- Call the API: Use
/payments/v1/endpoints with the Colombiatypevalues above (CO_BREB,CO_ACH,CO_PSE).
For more details, check out our full documentation:
Updated 14 days ago
Did this page help you?
