¿Puede proporcionar una lista de todos los estados de transacción posibles?
Esta es la lista completa de estados posibles para las operaciones de la API:
- Compras (pay-ins): created, confirmed, canceled, failed
- Pagos (pay-outs): created, completed, pending, canceled, failed
- Pagos masivos: pending, running, done, failed, completed, queued, canceled
Nota: Recomendamos que los implementadores realicen comparaciones sin distinción de mayúsculas y minúsculas al verificar los estados.
¿Qué estados se consideran finales y cuáles no?
Purchase API (API de Compras / Pay-ins)
NO FINAL
- Created: Se creó una orden de compra y está esperando la acción del destinatario. Debe ser "confirmed" o "canceled" por el destinatario. Las compras no completadas caducan a los 15 días.
FINAL
- Confirmed: El destinatario confirmó (pagó) la orden de compra y los fondos se acreditaron en tu cuenta.
- Canceled: El destinatario canceló (rechazó) la orden de compra. No se acreditaron fondos en tu cuenta.
- Failed: Algo salió mal cuando el destinatario intentó confirmar o cancelar la orden. Comunícate con tu Account Manager para conocer la ubicación exacta de los fondos.
Payout API (API de Pagos / Pay-outs)
NO FINAL
- Created: Se creó una orden de pago usando el proceso de dos pasos y está esperando que llames al commit endpoint.
- Pending: Se creó una cuenta de invitado para el usuario final con el correo del destinatario, y el dinero se mantendrá en fideicomiso de Airtm hasta que el destinatario active su cuenta.
FINAL
- Completed: El pago se completó con éxito y los fondos se acreditaron en la cuenta Airtm del usuario final.
- Canceled: Cancelaste el pago y los fondos se devolvieron a tu saldo (solo aplica si el pago estaba previamente en estado "pending").
- Failed: Algo salió mal al procesar el pago. Comunícate con tu Account Manager para conocer la ubicación exacta de los fondos.
Bulk Payments API (API de Pagos Masivos)
Estados de una tarea de Pago Masivo:
NO FINAL
- Pending: Se creó la tarea de pago masivo pero aún no se inició.
- Running: El sistema está procesando actualmente todos los pagos individuales del pago masivo.
FINAL
- Done: El procesamiento, las validaciones y la creación de operaciones relacionadas con esa tarea han finalizado. Esto no significa que todos los pagos individuales se hayan completado correctamente.
- Failed: Algo salió mal al procesar uno o más pagos individuales. Consulta el endpoint de errores y comunícate con tu Account Manager si es necesario.
Estados de pagos individuales dentro de un Pago Masivo:
NO FINAL
- Queued: El pago está en cola esperando ser procesado.
- Pending: Se creó una cuenta de invitado para el usuario final y el dinero se mantendrá en fideicomiso hasta que el destinatario active su cuenta Airtm.
FINAL
- Completed: El pago se completó con éxito y los fondos se acreditaron en la cuenta Airtm del usuario final.
- Canceled: Cancelaste el pago y los fondos se devolvieron a tu saldo (solo aplica si el pago estaba en estado "pending").
- Failed: Algo salió mal. Consulta el endpoint de errores y comunícate con tu Account Manager si es necesario.
¿Tienen un endpoint para verificar el estado y los detalles de una transacción?
Sí. Para pay-ins y pay-outs puedes usar https://docs.airtm.com/operations/get-operation-detail. Para pagos masivos: https://docs.airtm.com/bulk-payments/get-bulk-payments-by-id. Además, puedes recibir callbacks al usar la API de compras (pay-ins) y la de pagos (pay-outs) para conocer el estado sin tener que consultar uno por uno.