Cada transacción pasa por diferentes estados que se definen a partir de dos parámetros:
- status: estado simplificado de la transacción.
- detailedStatus: estado detallado de la transacción.
El parámetro status contiene el estado simplificado de la transacción:
- Permite saber si la transacción está pagada o no,
- Siempre es el mismo, sin importar el medio de pago.
Los distintos valores posibles se describen en la siguiente tabla. Si la columna FIN está marcada, significa que el estado de la transacción ya no podrá cambiar sin una intervención específica del vendedor (como la cancelación).
| status | Descripción | fin |
|---|---|---|
| PAID | La transacción ha sido pagada | ✔ |
| RUNNING | El procesamiento de la transacción está en curso | |
| UNPAID | La transacción no ha sido pagada | ✔ |
El parámetro detailedStatus proporciona información detallada sobre el estado del pago. Cada uno de los estados es propioa los medios de pago utilizados.
| detailedStatus | status | Descripción | fin |
|---|---|---|---|
| ACCEPTED | PAID | Estado de una transacción de tipo VERIFICATION cuya autorización o solicitud de información ha sido aceptada. Este estado no puede cambiar. Las transacciones con estado ACCEPTED no se capturan nunca. Se crea una transacción de tipo VERIFICATION al actualizar o crear un token sin pago. | ✔ |
| AUTHORISED | PAID | El monto está autorizado y será capturado automáticamente. | |
| CAPTURED | PAID | El monto de la transacción ha sido autorizado. | ✔ |
| PARTIALLY_AUTHORISED | PAID | La transacción ha sido parcialmente pagada. | |
| AUTHORISED_TO_VALIDATE | RUNNING | La transacción, creada en validación manual, está autorizada. El vendedor debe validar manualmente la transacción para que sea capturada al banco. La transacción puede ser validada siempre y cuando la fecha de expiración de la solicitud de autorización no se haya vencida. Si esta fecha se supera, el pago toma el estado EXPIRED. El estado Expirado es definitivo. | |
| WAITING_AUTHORISATION | RUNNING | La transacción no se ha autorizado porque el plazo de captura es superior al período de validez de la autorización. La solicitud de autorización será activada automáticamente D-1 antes de la fecha de captura. La captura es automática. | |
| WAITING_AUTHORISATION_TO_VALIDATE | RUNNING | Se ha verificado el medio de pago pero aún no se ha autorizado la transacción porque el período de captura es superior al período de validez de la autorización. La solicitud de autorización se iniciará automáticamente D-1 antes de la fecha de captura y se requerirá una intervención manual para confirmar la autorización. No hay garantía de que la solicitud de autorización sea aceptada. | |
| REFUSED | UNPAID | La transacción fue rechazada. | ✔ |
| ERROR | UNPAID | Ocurrió un error inesperado. | ✔ |
| CANCELLED | UNPAID | La transacción fue cancelada. | ✔ |
| EXPIRED | UNPAID | La transacción ha caducado (el vendedor no la validó dentro del período especificado). | ✔ |
Al crear una transacción, esta se encapsula en un objeto de alto nivel: el objeto Payment. Este objeto contiene diferentes estados del pedido, así como una lista de transacciones.
El estado del pedido se define a partir de los dos parámetros siguientes:
- orderCycle: puede tener el valor OPEN o CLOSED.
- orderStatus: consolidación del parámetro status de las transacciones asociadas al pedido.
Para más detalles, consulte: Referencia del objeto Payment.