External consultation
Allows you to make a payment order inquiry to the merchant
Last updated
Allows you to make a payment order inquiry to the merchant
Last updated
The external consultation service can have two types of integration: its own agreement code or reference with a prefix (prefix + identification).
Integration with your own agreement is possible only with the baloto collection network.
And the reference integration with prefix must follow the prefix + number format and guarantee a minimum length to be considered of 9 digits and a maximum of 16 digits.
It is up to each merchant to decide how to fill in the missing digits, but it is recommended to use the number 0, for example: 326000034567
The external consultation service allows the merchant to be the one who has control of the order to be collected and the means of payment that will be used to make the payment.
Los montos mix y max son obligatorios si el monto es CERO.
Es de suma importancia garantizar un tiempo de respuesta del servicio menor a 5 segundos, de lo contrario, nuestro sistema cerrará la conexión.
Es potestad de cada comercio realizar la validación del medio de recaudo, es decir, de rechazar o no la petición de detalles de la orden de compra de acuerdo al medio que se envía.
Si los montos min y max no son enviados, el checksum se calcula sin tener estos campos en cuenta. Los dos escenarios para el cálculo de checksum son:
Sin límites: order + amount + timestamp_end + FIXED_HASH
Con límites: order + amount + min + max + timestamp_end + FIXED_HASH
Campo
Requerido
Tipo
Longitud
Descripción
reference
Si
Numérico
16
Número de referencia proporcionado por el usuario
netname
Si
Alfanumérico
40
Nombre del medio de recaudo
currency
Si
Numérico
1
Moneda asociada al monto de la orden de compra (Monedas)
timestamp_start
Si
Numérico
10
Tiempo de inicio de la transacción en formato Unix Timestamp (Segundos) UTC
checksum
si
Alfanumérico
512
Cadena de comprobación SHA512(reference + currency + netname + timestamp_start + FIXED_HASH)
Campo
Requerido
Estructura
Tipo
Longitud
Descripción
CODE
si
-
Alfanumérico
4
Código de respuesta de errores "0000" para respuesta OK
TEXT
si
-
Alfanumérico
2
Descripción de respuesta "OK" para ejecución correcta.
DATA
si
-
estructura
-
Estructura json que contiene los datos de respuesta
order
si
DATA
Alfanumérico
200
Número de orden registrada en el sistema del comercio debe ser única. A este campo se le realiza una validación por expresión regular (^[a-zA-Z0-9_-]{1,200}$)
amount
si
DATA
Alfanumérico
20
Monto de la orden (puede ser cero)
description
si
DATA
Alfanumérico
40
Descripción corta de la orden. A este campo se le realiza una validación por expresión regular (^[\w -]+$)
si
DATA
Alfanumérico
100
Correo electrónico del usuario
timestamp_end
si
DATA
Alfanumérico
10
Tiempo de finalización de la transacción en formato Unix Timestamp (Segundos) UTC
min
no*
DATA
Alfanumérico
20
Monto mínimo a pagar, default 0
max
no*
DATA
Alfanumérico
20
Monto máximo a pagar, default 999999999
checksum
si
DATA
Alfanumérico
512
Cadena de comprobación, calculada con SHA512(Revisar apartado de Checksum para conocer como realizar el cálculo correcto)
