Flujo
Paso a paso
1
Una integración, muchas empresas
Da de alta a cada empresa cliente con
POST /business_users. Cada una queda verificada y con su propio saldo.2
Cobra una factura
Crea una orden por factura con
POST /payment_orders, usando el número de factura como order en tu sistema. El cliente paga con su método local.3
Paga a proveedores
Desde el módulo financiero,
POST /transactions con transactions_type: "withdrawal": una orden de pago por proveedor y por factura.4
Registra el movimiento
Con webhooks marca la factura como pagada y concilia automáticamente en el libro contable.
Buenas prácticas
Guarda el
order igual al identificador del documento en tu ERP (número de factura o de orden de pago). Facilita la conciliación y hace el order legible para auditoría.Consulta saldos con
GET /wallets/{uuid} para mostrar disponibilidad dentro del software antes de que el usuario intente pagar.Usa la colección Postman para que tu equipo pruebe la integración antes de programar.
Endpoints clave
Crear usuario (empresa)
POST /business_usersCobrar factura
POST /payment_ordersPagar proveedor
POST /transactions con transactions_type: "withdrawal"Saldo de wallet
GET /wallets/{uuid}