Skip to main content
Una billetera necesita que sus usuarios carguen saldo, paguen, se envíen dinero entre sí y retiren a su banco. Con la API puedes sumar esas funciones sin construir cada riel por país.

​
Flujo

​
Paso a paso

1

Alta de usuarios

POST /business_users crea al usuario (persona o empresa). GET /business_users/verification_status te dice si ya está verificado.
Los documentos de verificación van en Base64 con su tipo (JPG/PNG para imágenes, PDF para documentos).
2

Recarga de saldo

Cobra con POST /payment_orders o Direct Payment y acredita el saldo del usuario en tu sistema al recibir payment_order.paid.
3

Envíos entre usuarios

POST /transactions con transactions_type: "vita_sent" y el correo del receptor. Es instantáneo y liquida contra el ecosistema Vita.
4

Retiros y conversión

  • Retiro a banco: transactions_type: "withdrawal".
  • Retiro a wallet externa: transactions_type: "crypto_payout".
  • Cambio de moneda: transactions_type: "exchange".

​
Buenas prácticas

Mantén tu propio ledger por usuario: la wallet de la API es de tu empresa, no de tus usuarios finales. Concilia con GET /transactions y GET /deposits.
Usa webhooks en lugar de hacer polling de estados. Reduce latencia y costos.
Deduplica eventos por event_id (tratarlo como texto opaco) para no procesar dos veces el mismo cambio de estado.

​
Endpoints clave

Crear usuario

POST /business_users

Vita Sent

POST /transactions con transactions_type: "vita_sent"

Payout bancario

POST /transactions con transactions_type: "withdrawal"

Payout cripto

POST /transactions con transactions_type: "crypto_payout"