¿Puede proporcionar una lista de todos los estados de transacción posibles?
Esta es una lista completa de todos los estados posibles que las operaciones de la API pueden tener en un momento dado:
Para compras: created, confirmed, canceled, failed (creado, confirmado, cancelado, fallido)
Para pagos: created, completed, pending, canceled, failed (creado, completado, pendiente, cancelado, fallido)
Para pagos masivos: pending, running, done, failed, completed, queued, canceled (pendiente, en ejecución, finalizado, fallido, completado, en cola, cancelado)
NOTA: Recomendamos que los implementadores de API realicen comparaciones que no distingan entre mayúsculas y minúsculas al verificar los estados.
¿Qué estados se consideran finales y cuáles no?
Purchase API (API de Compras/Depósitos)
NO FINAL
Created (creado): Se ha creado una orden de compra y está esperando la acción del destinatario. Una vez creada, la orden de compra debe ser "confirmada" o "cancelada" por el destinatario. Las compras no completadas caducan a los 15 días.
FINAL
Confirmed (confirmado): El destinatario ha confirmado (pagado) una orden de compra y los fondos se han acreditado en tu cuenta.
Canceled (cancelado): El destinatario canceló (rechazó) una orden de compra. No se acreditaron fondos en tu cuenta.
Failed (fallido): Algo salió mal cuando el destinatario intentó confirmar o cancelar la orden de compra. Comunícate con tu Administrador de Cuenta para conocer la ubicación exacta de los fondos.
Payout API (API de Pagos/Retiros)
NO FINAL
Created (creado): Se ha creado una orden de pago usando el proceso de pago de dos pasos y está esperando que llames al commit endpoint
Pending (pendiente): Se ha creado una cuenta de invitado para el usuario final con el correo electrónico del destinatario, y el dinero se mantendrá en el fideicomiso de Airtm hasta que el destinatario active su cuenta de Airtm.
FINAL
Completed (completado): El pago se completó con éxito y los fondos se acreditaron en la cuenta de Airtm del usuario final.
Canceled (cancelado): Cancelaste el pago y los fondos se devolvieron al saldo de tu cuenta (solo aplica si el pago estaba previamente en estado "pending").
Failed (fallido): Algo salió mal cuando intentamos procesar el pago. Comunícate con tu Administrador de Cuenta 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 (pendiente): Se ha creado una tarea de pago masivo, pero aún no se ha iniciado.
Running (en ejecución): Nuestro sistema está procesando actualmente todos los pagos individuales contenidos en el pago masivo.
FINAL
Done (finalizado): Las tareas de pagos masivos con estado “DONE” significan que 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 (fallido): Algo salió mal al procesar uno o más pagos individuales. Consulta el endpoint de errores para saber qué sucedió y comunícate con tu Administrador de Cuenta si es necesario.
Estados de pagos individuales dentro de un Pago Masivo:
NO FINAL
Queued (en cola): El pago ha quedado en cola y está esperando su turno para ser procesado.
Pending (pendiente): Se ha creado una cuenta de invitado para el usuario final con el correo electrónico del destinatario, y el dinero se mantendrá en el fideicomiso de Airtm hasta que el destinatario active su cuenta de Airtm.
FINAL
Completed (completado): El pago se completó con éxito y los fondos se acreditaron en la cuenta de Airtm del usuario final.
Canceled (cancelado): Cancelaste el pago y los fondos se devolvieron al saldo de tu cuenta (solo aplica si el pago estaba previamente en estado "pending").
Failed (fallido): Algo salió mal cuando intentamos procesar el pago. Consulta el endpoint de errores para saber qué sucedió y comunícate con tu Administrador de Cuenta si es necesario.
¿Tienen un endpoint para verificar el estado y los detalles de la transacción?
Sí, si la transacción ya se realizó, puede verificarla utilizando este endpoint para pay-ins y pay-outs https://docs.airtm.com/operations/get-operation-detail o https://docs.airtm.com/bulk-payments/get-bulk-payments-by-id #details-by-id para pagos masivos. Además, puede recibir callbacks cuando utiliza la API de compras (pay-ins), así como la API de pagos (pay-outs), para que pueda conocer el estado de las transacciones sin tener que verificar una por una.