Pre-Autorización

Se reserva un importe en la tarjeta del usuario. Posteriormente se debe confirmar el importe real de la transacción. Este importe puede ser igual, mayor, o menor que el monto pre-autorizado.

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

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

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 pre-autorizació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

Response (ejemplo)

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