Saltar al contenido principal

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.

EstadoSignificadoFinal
CREATEDLa transacción se creó.No
READY_TO_PROCESSLa transacción está lista para procesarse.No
PENDINGLa transacción espera una acción o una verificación.No
PROCESSINGLa transacción se está procesando.No
EXCHANGINGLa conversión de moneda está en curso.No
COMPLETEDLa transacción se completó.Sí
CANCELLINGLa cancelación está en curso.No
CANCELEDLa transacción se canceló.Sí
REFUNDINGEl reembolso está en curso.No
REFUNDEDLa 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.

EstadoSignificadoAcción recomendada
CREATEDLa factura está creada. Volet.com todavía no terminó de procesar un pago para ella.Mantén el pedido pendiente.
PROCESSINGVolet.com está procesando el pago.Mantén el pedido pendiente.
COMPLETEDEl pago se completó y los fondos se acreditaron en tu cuenta. Estado final.Marca el pedido como pagado y entrégalo.
FAILEDEl 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.

EstadoSignificado
NEWLa factura está creada y todavía no se recibió ningún pago.
RECEIVEDSe 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.
EXCHANGINGVolet.com está convirtiendo las criptomonedas recibidas a la moneda del receptor.
COMPLETEDLa factura está procesada y los fondos se acreditaron en tu cuenta.
REFUND_CONFIRMATIONUn reembolso del pago espera confirmación.
REFUND_REQUESTEDSe solicitó un reembolso.
REFUNDEDEl pago se devolvió al cliente.
CLOSEDLa 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 que senderAmount.
  • OVERPAYMENT — el cliente envió más que senderAmount. 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.