Skip to main content
Una remesa tiene tres tramos: el cliente paga en su país, el dinero cambia de moneda y llega a la cuenta del beneficiario en otro país. La API cubre los tres con llamadas estándar.

​
Flujo

​
Paso a paso

1

Recibe el pago local

Crea la orden con POST /payment_orders indicando el país de origen (en mayúsculas, ISO 3166-1 alfa-2). El cliente paga con un método local y el monto se acredita en tu wallet.
2

Muestra el monto exacto que recibirá el beneficiario

GET /prices devuelve tasa y costo fijo por destino. Calcula:
Respeta siempre valid_until.
3

Pide los datos del destino

GET /withdrawal_rules entrega el formulario exacto del país: campos obligatorios, bancos aceptados y formatos. Así tu app pide solo lo que el destino exige.
4

Envía el pago

POST /transactions con transactions_type: "withdrawal". Sigue el estado con webhooks: started, processed, pending, completed o denied.

​
Buenas prácticas

Informa al cliente el monto final antes de que pague, usando los precios vigentes. Nada frustra más a un remitente que ver una cifra distinta a la prometida.
Para Brasil y Argentina existen validadores de beneficiario (POST /beneficiaries/validate_beneficiary) que bajan los rechazos antes de ejecutar.
Si el estado llega denied, lee statuses[] para saber la razón y ofrece corregir los datos sin crear otro order.

​
Endpoints clave

Precios

GET /prices

Reglas por país

GET /withdrawal_rules

Crear payout

POST /transactions con transactions_type: "withdrawal"

Validar beneficiario

POST /beneficiaries/validate_beneficiary