FX y bloqueo de tasas (Pay-Out)
De dónde sale la tasa
Cuando creas una cotización, Cashela pide una cotización a cada pagador que puede entregar en el país y la moneda de destino, aplica la tasa de cambio y la comisión, y selecciona una de las cotizaciones. Los pagadores que pueden entregarlo aparecen en payers_available.
Para ver las opciones antes de comprometerte, llama a POST /api/v1/pay-out/calculate: devuelve una selected_quote y las available_quotes, sin crear una cotización. Consulta Vista previa sin guardar.
Qué te dice la cotización
| Campo | Significado |
|---|---|
source.amount | Importe enviado, en la moneda de origen. |
destination.amount | Importe que recibe el beneficiario, en la moneda de destino. |
wholesale_fx_rate | Tasa de cambio aplicada. |
fee.amount | Comisión, en la moneda de origen. |
Con mode: "SOURCE_AMOUNT" tú fijas source.amount y Cashela calcula destination.amount. Con mode: "DESTINATION_AMOUNT" tú fijas destination.amount y Cashela calcula source.amount.
Qué pagas
El pago se financia desde tu billetera Cashela en la moneda de origen. Necesitas una billetera activa en esa moneda: una source.currency para la que no tienes billetera se rechaza con 422. Al ejecutar, el importe que muestra funding.amount de la transacción se reserva de tu saldo disponible.
Cuánto dura la tasa
La tasa, la comisión y los importes quedan fijados durante 30 minutos, hasta expiration_date. Ejecuta la transacción antes. Después la cotización pasa a EXPIRED y no se puede ejecutar: crea otra con un external_identifier nuevo. Consulta Bloqueo de tasas de la cotización.
Buenas prácticas
- Muestra al usuario el importe recibido, la tasa y la comisión antes de que confirme.
- Muestra el tiempo que queda hasta
expiration_date. - Usa los valores de la cotización, no una tasa calculada por ti.