Estados
La Merchant API usa tres conjuntos de estados: los estados de las transacciones para pagos, transferencias y otras transacciones; los estados de los pagos para pedidos pagados con facturas cripto; y los estados de las facturas, que describen un pago cripto con más detalle.
Estados de las transacciones
Los devuelven Obtener transacción y Obtener historial de transacciones.
| Estado | Significado | Final |
|---|---|---|
CREATED | La transacción se creó. | No |
READY_TO_PROCESS | La transacción está lista para procesarse. | No |
PENDING | La transacción espera una acción o una verificación. | No |
PROCESSING | La transacción se está procesando. | No |
EXCHANGING | La conversión de moneda está en curso. | No |
COMPLETED | La transacción se completó. | Sí |
CANCELLING | La cancelación está en curso. | No |
CANCELED | La transacción se canceló. | Sí |
REFUNDING | El reembolso está en curso. | No |
REFUNDED | La transacción se reembolsó. | Sí |
Considera un pago como completado solo cuando su estado sea COMPLETED. Sigue la transacción hasta que llegue a un estado final.
Un estado final todavía puede cambiar si más tarde se hace un reembolso: una transacción COMPLETED pasa entonces a REFUNDING y REFUNDED.
Estados de los pagos
Los devuelve en paymentStatus Obtener pedido de pago.
| Estado | Significado | Acción recomendada |
|---|---|---|
CREATED | La factura está creada. Volet.com todavía no terminó de procesar un pago para ella. | Mantén el pedido pendiente. |
PROCESSING | Volet.com está procesando el pago. | Mantén el pedido pendiente. |
COMPLETED | El pago se completó y los fondos se acreditaron en tu cuenta. Estado final. | Marca el pedido como pagado y entrégalo. |
FAILED | El pago falló o su transacción se canceló. Estado final. | No entregues el pedido. |
paymentStatus no tiene un valor para los reembolsos. Un reembolso se ve en transaction.status y en invoice.invoiceStatus.
Cuando la factura vence, paymentStatus no cambia a FAILED por sí solo: el cliente todavía puede enviar un pago después del vencimiento.
Estados de las facturas
Los devuelve en invoice.invoiceStatus Obtener pedido de pago. Úsalos para explicar un pago con problemas, no para decidir si el pedido está pagado.
| Estado | Significado |
|---|---|
NEW | La factura está creada y todavía no se recibió ningún pago. |
RECEIVED | Se recibió una transacción de la blockchain para la factura. Las verificaciones pueden seguir en curso, así que los fondos aún no están acreditados. |
EXCHANGING | Volet.com está convirtiendo las criptomonedas recibidas a la moneda del receptor. |
COMPLETED | La factura está procesada y los fondos se acreditaron en tu cuenta. |
REFUND_CONFIRMATION | Un reembolso del pago espera confirmación. |
REFUND_REQUESTED | Se solicitó un reembolso. |
REFUNDED | El pago se devolvió al cliente. |
CLOSED | La factura está cerrada. |
invoice.penalties indica en qué se diferencia el pago recibido de la factura. Está vacío cuando el pago coincide:
UNDERPAYMENT— el cliente envió menos quesenderAmount.OVERPAYMENT— el cliente envió más quesenderAmount. Un pago en exceso pequeño, dentro de la tolerancia permitida, no se marca.EXPIRED— el pago llegó después del vencimiento de la factura. Ese pago no se acredita automáticamente.
invoice.externalStatus combina invoiceStatus y penalties en un solo valor, por ejemplo UNDERPAYMENT_RECEIVED o EXPIRED_PAYMENT_REFUNDED. PAYMENT_RECEIVED no significa que los fondos estén acreditados. Usa externalStatus solo para mostrarlo.
Relacionado
- Errores — formato de los errores y cómo gestionarlos
- Integración por API para aceptar pagos — el flujo de pago completo
- Integración por API para pagos masivos — el flujo de pagos completo