Consulta externa o inicialización de la orden
Permite realizar una consulta de orden de retiro al comercio
Definido por el comercio
POST La url o webhook lo define el comercio .
El comercio prepara un endpoint para tomar como petición (request) y respuesta (response) la siguiente información:
Request Body
otp
string
Pin de operación u OTP
document
string
Número de documento de identidad del usuario final
timestamp_start
string
Tiempo de inicio de la transacción en formato Unix (segundos)
checksum
string
Cadena de comprobación, calculada con SHA512( document + otp + timestamp_start + FIXED_HASH)
{
“code”: “0000”,
“text”: “OK”,
“data”:{
“operation”: “123456789”,
“amount”: “30000”,
“currency”: “COP”,
“description”: “Operación CashOut+”,
“timestamp_end”: “1581370646”,
“transactionCost”: “2000”,
“checksum”: “75535b719153109d34a7c09e1fe6ec266b0cce28870b9553b068ce643922599927ea9cc2fe90ee21105177bd32ce87a82be5b9bc6459f8d9f19c2dd592f90b39”
}
}
Es importante tener en cuenta que el valor de amount debe ser mayor a cero (0) y no debe contener cifras decimales.
* El monto indicado en transactionCost es solo informativo para el usuario final y no influye en el monto de la operación (amount), es decir, el monto total a desembolsar es el indicado en “amount”, independientemente del valor indicado en transactionCost
Detalles de los datos de respuesta.
code: Indica el código del resultado. Si el código es “0000” indica un resultado sin error, si el código es diferente, el sistema indica el error en el campo text. text: Contiene el mensaje relacionado al code enviado. data: Contiene los datos de la operación cuando el code nos indica que no hay ningún error.
operation: identificador de la operación, generado por el comercio (tiene una longitud máxima de 40 caracteres).
amount: valor de la operación (no contiene cifras decimales).
currency: código ISO de la divisa de la operación (tiene una longitud de 3 caracteres).
description: descripción de la operación (tiene una longitud máxima de 50 caracteres).
timestamp_end: tiempo de transacción en formato Unix Timestamp (milisegundos).
transactionCost: indica el costo que asume el usuario por realizar la transacción.
checksum: cadena de comprobación, calculada con SHA512( operation + amount + currency + document + timestamp_end + otp + FIXED_HASH)
Los códigos de la respuesta, pueden ser: “0000”: OK “0004”: Monto inválido “0005”: Error de comunicación con el autorizador “0006”: Su transacción ha sido rechazada por el autorizador “0007”: Servicio de verificación indisponible “0009”: El checksum no es válido “0013”: No se pudo completar la transacción “0019”: Uno o varios datos no están configurados correctamente “0020”: Error al procesar los datos “0024”: Debe ingresar un número de operación válido “0029”: Debe indicar un monto válido “0030”: Debe indicar una moneda válida “0031”: Debe indicar una descripción válida
Last updated