Ciclo de vida de una transacción

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.

Parámetro "status"

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

Parámetro "detailedStatus"

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).

Transacción y pedido

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.