Liquidación y procesamiento (Pay-Out)
Tu billetera durante un pago
Pay-Out se financia desde tu billetera Cashela en la moneda de origen de la cotización.
| Momento | status de la transacción | Tu billetera |
|---|---|---|
| Ejecutas la cotización | PROCESSING | El importe de funding.amount pasa de tu saldo disponible a un saldo reservado (bloqueado). |
| El pago se entrega | COMPLETED | El importe reservado se liquida: sale de tu billetera. |
| El pago falla | FAILED | El importe reservado vuelve a tu saldo disponible. |
Falla una comprobación al ejecutar (por ejemplo Insufficient wallet balance.) | FAILED | No se reserva nada. |
Cada reserva se liquida o se libera una sola vez, aunque Cashela reciba el mismo estado final más de una vez.
Cómo conoces el resultado
- Notificaciones. Si enviaste una
callback_url, Cashela la notifica tras la ejecución y otra vez cuando la transacción llega aCOMPLETEDoFAILED. Consulta Notificaciones. - Consulta de estado.
GET /api/v1/pay-out/transactions/{reference}siempre devuelve el estado actual. Úsalo como fuente de verdad y para recuperarte de una notificación perdida.
Tiempos de entrega
El tiempo de entrega depende del pagador, el país y el servicio. La API no devuelve un tiempo estimado de entrega. Muestra a tus usuarios un rango acordado con Cashela para cada corredor, no una hora fija.
Buenas prácticas
- No des un pago por cerrado hasta que su estado sea
COMPLETEDoFAILED. - Haz idempotente tu handler de notificaciones y verifica cada firma.
- Concilia tus registros con la
referencede la transacción y tuexternal_identifier.