Confirmation

A través de este método se consulta el estado de confirmación de la transacción dado un identificador de transacción.

POST /transaction/confirmation

Constituye la confirmación de la transacción y por lo tanto del desembolso o aprobación del valor de la transacción. El medio de pago digital debe estar preparado para recibir más de una vez la solicitud asociada a la misma transacción, retornando el estado actualizado de la confirmación. El endpoint debe ser expuesto por el medio de pago digital y será invocada por payválida.

Headers

Name	Type	Description
Accept*	String	Utilizado para definir que tipo de contenido puede procesar el cliente. El valor siempre debe ser application/json.
Content-Type*	String	Utilizado para identificar el media-type del cuerpo de la solicitud. El valor siempre debe ser application/json.
Authorization	String	Token Oauth2 obtenido en el endpoint Oauth2 expuesto por el medio de pago digital. En caso de que el token tenga un scope se debe definir previamente. Debe seguir el formato 'token_type access_token'.

Request Body

Name	Type	Description
transaction*	Object	Información de la transacción consultada.
id*	String	Parte del object transaction. Identificador de la transacción

200: OK Solicitud procesada correctamente

transaction* (object): Información de la transacción confirmada

id* (string): Parte del object transaction. Identificador de la transacción.

status* (string): Parte del object transaction. Estado de la transacción tras confirmar el monto, y por ende, la confirmación del pago. Valores permitidos: REJECTED, APPROVED, PENDING, CREATED. REJECTED: Significa que no se completó el pago y por lo tanto el fin del flujo. APPROVED: Significa que se confirma el pago por el valor de la transacción. PENDING: Significa que la confirmación del pago, por el valor de la transacción, aún no se ha completado por lo que se espera una confirmación asíncrona, de parte de el medio de pago digital, antes de la fecha de expiración de la transacción. CREATED: Significa que el el usuario aún sigue en proceso de pago por lo que no se ha determinado si se rechazó, aprobó o se realizará confirmación asíncrona. Al recibir este estado se realizarán 10 intentos aproximadamente cada 2 minutos. Si luego de los reintentos se sigue obteniendo el estado CREATED, se asumirá que se realizará una confirmación asíncrona y en este punto el comportamiento será igual al de recibir estado PENDING.

confirmation_result (string): Parte del object transaction. Descripción del estado o resultado de confirmación. Es opcional y se utiliza por registro y trazabilidad.

value* (string): Parte del object transaction. Monto de la transacción y por lo tanto del pago. En caso de recibir un valor distinto al enviado en transaction, el medio de pago digital debe estar preparado para recibir una solicitud de anulación con el monto recibido al crear la transacción (consumo de transaction).

400: Bad Request La solicitud o los claims del token no tienen la estructura esperada.

403: Forbidden No fue posible identificar al cliente de la solicitud. Asociado a la validación y verificación del token.

404: Not Found La transacción asociada no existe o no se encuentra.

409: Conflict La solicitud entra en conflicto con el estado actual de la transacción.

500: Internal Server Error Error del servidor al procesar la solicitud.

Request ejemplo

{
  "transaction": {
    "id": "0427dfac-ffd8-44f4-be96-5d442c1c1bed"
  }
}

Response ejemplo

{
  "transaction": {
    "id": "0427dfac-ffd8-44f4-be96-5d442c1c1bed",
    "status": "APPROVED",
    "confirmation_result": "Transacción confirmada",
    "value": "10.25"
  }
}