Flujo
Paso a paso
1
Cobra de tu cliente
Crea una orden con
POST /payment_orders en la moneda local del pagador. El monto queda en tu wallet.2
Fija la tasa
GET /prices (fiat) o GET /crypto_prices (cripto) según el caso. La tasa tiene valid_until: ejecuta antes de que venza para no revalidar.3
Paga al proveedor del exterior
POST /transactions con transactions_type: "withdrawal" a su cuenta bancaria, o crypto_payout si prefiere stablecoin.4
Deja trazabilidad
GET /transactions/:id entrega el detalle de cada operación con included.withdrawal completo para auditoría y conciliación contable.Buenas prácticas
Registra tu propia referencia en
order (número de factura o de importación). Esto convierte el order en tu puente entre la API y tu contabilidad.Algunas transacciones B2B requieren documentación adicional de respaldo (factura comercial, DJAI, etc.). Tenlo listo antes de ejecutar el payout.
Para saldos grandes, revisa el saldo con
GET /wallets/{uuid} antes de disparar el payout. Evita rechazos innecesarios.Endpoints clave
Crear payin
POST /payment_ordersPrecios
GET /prices / GET /crypto_pricesPayout
POST /transactions con transactions_type: "withdrawal"Detalle de transacción
GET /transactions/:id