Skip to main content
Plataformas que atienden a muchos clientes necesitan identificar quién pagó cada depósito. Con cuentas virtuales por cliente, cada abono llega referenciado a su dueño y se concilia solo.

​
Flujo

​
Paso a paso

1

Crea al cliente

POST /business_users y espera la verificación con GET /business_users/verification_status.
2

Consulta sus métodos de depósito

GET /deposits lista los métodos disponibles para recargar saldo en la cuenta del cliente.
3

Detecta los abonos

Con webhooks de categoría deposit recibes cada depósito acreditado. Concilia por cliente en tu sistema usando el identificador del business_user.
4

Liquida en moneda local

Convierte con exchange si hace falta y paga con withdrawal a la cuenta local del cliente cuando lo solicite.

​
Buenas prácticas

Mantén un ledger por cliente: la wallet de la API es de tu empresa, no de cada cliente. Tu base de datos es la fuente de verdad para los saldos individuales.
Concilia con GET /transactions filtrando por fechas y, si corresponde, por source_currency / target_currency.
Los datos de los clientes viajan por HTTPS y firmados con HMAC. No los registres en logs ni los expongas en respuestas de tu propia API.

​
Endpoints clave

Crear usuario

POST /business_users

Métodos de depósito

GET /deposits

Transacciones

GET /transactions

Webhooks

Categoría deposit