Skip to main content
Agencias, mayoristas, plataformas de reservas y aerolíneas cobran a viajeros en su país y pagan a hoteles, anfitriones y operadores en otros. El desfase de monedas y países es justo lo que la API simplifica.

​
Flujo

​
Paso a paso

1

Cobra la reserva en moneda local

Enlace de pago con POST /payment_orders o checkout propio con Direct Payment.
El enlace de pago vence en 15 minutos. Crea la orden recién cuando el viajero esté listo para pagar — no antes.
2

Confirma y emite

Con el webhook payment_order.paid confirma la reserva. Si el viajero abandona, el estado pasa a expired y puedes liberar el inventario.
3

Paga al proveedor

Calcula el monto con GET /prices y crea el pago con POST /transactions y transactions_type: "withdrawal" a la cuenta del proveedor en su país.
4

Concilia

Cruza cada reserva con su order en GET /transactions y con los eventos de GET /events.

​
Buenas prácticas

Usa un order por reserva (cobro) y otro por pago al proveedor. No reutilices el mismo identificador entre tramos.
Los pagos de una misma cuenta se procesan en fila: no dispares varios a la vez ni reintentes con otro order si el primero sigue en curso.
Si pagas a proveedores en dólares desde saldos en moneda local, revisa el paso previo de conversión en Modelo de balances.

​
Endpoints clave

Crear payin

POST /payment_orders

Precios

GET /prices

Crear payout

POST /transactions con transactions_type: "withdrawal"

Eventos

GET /events