Flujos de integración

Esta página conecta los productos en flujos completos de negocio: qué llamar, qué esperar y qué webhook cierra cada ciclo. Cada flujo linkea a la guía detallada de su producto.

1. Fondear la cuenta

Tres caminos para que entre dinero; todos terminan en un abono al saldo USDT y un webhook:

Camino	Endpoint	Webhook de cierre
Cobro fiat (QR, transferencia, página de pago, pull)	`POST /v1/payins` / `/collect`	`payin_credited`
Depósito USDT on-chain	`POST /v1/crypto/wallets` (dirección fija)	`crypto_deposit_credited`
Transferencia interna de otra cuenta	— (la inicia el emisor)	`transfer_received`

Detalle: payins · crypto · transferencias.

2. Dispersar (payout)

Variante QR (Bolivia, PIX de Brasil): POST /v1/payouts/qr/scan (gratis, decodifica) → muestra los datos → POST /v1/payouts/qr/confirm (cobra como un payout normal). Detalle: payouts · payout QR.

3. Cobrar a un cliente

Elige la modalidad según el país y la experiencia que quieras dar:

Modalidad	Países	Experiencia del pagador	Confirmación
Página de pago hosted	CL	Abre una URL y paga desde su banco	Automática
QR	BO, BR (PIX)	Escanea con su app bancaria	Automática
Transferencia anunciada	CL, PE, MX, BR	Transfiere incluyendo la referencia	Automática por referencia (o monto)
CLABE / CVU dedicada	MX, AR	Transfiere a una cuenta fija tuya	Automática, sin referencias
Cobro pull (c2p / débito)	VE	Autoriza con OTP y tú ejecutas el cobro	Síncrona en la misma llamada
Pago con tarjeta	BO (BOB/USD)	Ingresa su tarjeta en una página hosted segura (3DS)	Automática
Link de cobro universal	Todos los países activos + crypto + tarjetas	Abre un link y elige cómo pagar	Automática

Todos cierran con payin_credited y el abono neto en tu saldo. Detalle: payins · checkout.

4. Checkout end-to-end

Un link, todos los rieles, liquidado en el saldo que elijas: Detalle: checkout.

5. Tarjetas guardadas y suscripciones

Guarda la tarjeta una vez (con consentimiento del pagador) y cóbrala después — con un clic, sin el pagador presente (MIT) o con un calendario recurrente: Detalle: tarjetas guardadas y suscripciones.

6. Cobro QR POS (procesadores)

Para empresas que operan puntos de venta físicos: Detalle: QR POS.

7. Convertir saldos (swaps)

Una llamada convierte entre USDT, USDC, BTC y GOLD a la tasa de tu cuenta — la plata no sale de la cuenta, así que no requiere OTP. Detalle: swaps.

8. Conciliar

Receta completa en movimientos y conciliación y cartola.

9. Banking internacional end-to-end

El saldo banking vive en tus cuentas bancarias (separado del USDT); CBPay solo cobra los fees fijos configurados. Detalle: banking.

¿Primera integración? Sigue el inicio rápido (fondeo → payout → webhook) y vuelve aquí cuando agregues productos.

Comenzar

Conceptos