Completar pre-autorización

Confirmar el importe real de la transacción pre-autorizada. Este importe puede ser igual, mayor, o menor que el monto pre-autorizado.

Para la completar una pre-autorización pueden existir 3 escenarios:

• Monto menor al pre-autorizado: se completa la pre-autorización con el monto indicado en el servicio de completion.

• Monto igual al pre-autorizado: se completa la transacción por el monto indicado.

• Monto mayor al pre-autorizado: se completa la pre-autorización inicial y se crea una nueva transacción por el monto restante. Esta transacción se puede identificar con el order_1, donde order es el orderId del request. En caso de que la transacción por el monto restante sea rechazada, esta será notificada como vencida a través del API de notificación.

Producción: https://api.payvalida.com/v4/merchant/completion

Sandbox: https://api-test.payvalida.com/v4/merchant/completion

Request

Campo	Requerido	Tipo	Descripción
merchantName	sí	string	Nombre del merchant
orderId	sí	string	Id de la orden creado por el merchant previamente en el API Recaudo
checksum	sí	string	sha512(merchantName + orderId + fixed_hash)
amount	sí	string	Monto por el cual se va a realizar la finalización de la transacción
token	sí	string	Identificador del token creado anteriormente para la tarjeta
typeDi	no	string	Tipo de documento del usuario. Colombia: CC,CE,PP,NIT
di	no	string	Número de documento de usuario

Request (ejemplo)

{
"merchantName": "my_merchant_name",
"orderId": "1234567890",
"checksum":"90037d4ae7d310c1c4c50ce630c54af850587533a900099cde381ac68aa8af1cc959b9820e77a48fb403c460a8630729bc37e2a9d47be9e3e846982fa7c56de0",
"amount": 70500.00,
"token": "12345678901234",
"typeDi": "CC",
"di": "1234567890",
}

Response

CODE	DESC
0000	APPROVED
0001	REJECTED
0010	wrong request
0011	invalid request
0012	payment invalid
0013	the reference is not registered or is invalid
0016	error processing transaction
0017	transaction already completed

Response (ejemplo)

{
    "CODE": "0000",
    "DESC": "APPROVED"
}