Getting started

Cobru integration map for accepting payments, moving balance, operating treasury, and browsing the API reference.

Cobru is a Colombian payments platform for teams that need to launch hosted payment links, support local methods, automate collections, and operate money movement from one API.

This documentation is organized by product flow. Use this page as the starting map: begin with credentials, continue with the flow you want to build, and use the API reference when you need exact payloads.

Choose a path

Quickstart

Get an access token, create your first payment link, and validate the minimum path.

Authentication

Understand credentials, bearer tokens, refresh, and secure session handling.

Collections

Create hosted Cobrus and enable methods such as PSE, Nequi, Bre-B, Bancolombia, and cards.

Payouts

Move balance with transfers, bank withdrawals, cash withdrawals, and Bre-B flows.

Balances and movements

Check balances, movements, and operational signals for reconciliation.

Cards

Review virtual card issuance, details, movements, freezing, and top-ups.

Services

Explore recharges, Pins, and other transactional services exposed by Cobru.

Webhooks

Process asynchronous state changes, retries, and reconciliation-relevant events.

API reference

Open the interactive OpenAPI contract for exact request and response shapes.

What to read first

Quickstart to create the first payment link.
Authentication to harden token handling.
Cobrus to accept payments with local methods.
Payouts if your integration moves balance outside checkout.
Webhooks, Testing, and Production readiness before go-live.
API Reference when you need exact request and response shapes.

Product surface

Area	What developers use it for
Collections	Create hosted Cobrus, calculate fees, inspect payment details, and handle local payment methods
Payouts	Move balance, trigger cash withdrawals, bank withdrawals, and BRE-B settlement flows
Balances and movements	Check balances, movements, and evidence for reconciliation
Cards & Services	Operate cards, recharges, Pins, and other surfaced product APIs

Environments

Environment	Base URL
Sandbox	`https://dev.cobru.co`
Production	`https://prod.cobru.co`

Verification and support

Source	Role
`dev.cobru.co` sandbox	Primary verification source for live behavior
Cobru legacy API materials	Secondary source for endpoints not yet re-verified
Cobru API menu captures	Scope source for families still pending contract extraction
`soporte@cobru.co`	Escalation path when a contract must be confirmed before production