Consulta Dinámica

Consulta de referencias disponibles para pago de acuerdo a un criterio de búsqueda.

El proceso consiste en que Payvalida realiza una solicitud con el criterio de búsqueda definido. El comercio tiene total control sobre la referencia a recaudar, la red de recaudo por la cual realizar el pago, así como el punto habilitado y su posición geográfica. En la respuesta el comercio entregará la referencia o referencias de pago asociadas a la solicitud.

Al igual que con Cashin+, la referencia deberá poseer un prefijo de tres digitos que permita identificar al comercio asociado a ella, este prefijo no es necesario para convenios privados con la Red Baloto.

En la respuesta, cada referencia de pago cuenta con una de las tres posibles opciones (payment_type) que permite a Payvalida aceptar el monto enregado en el punto de recaudo:

• 1-Monto abierto: El valor entregado a la Red es cero ($0), el cliente puede hacer un pago por un valor que se encuentra dentro de un rango definido por el comercio y que el cliente debe conocer.

• 2-Monto fijo: Se retorna un valor asociado a la referencia, es el único valor que el cliente puede pagar.

• 3-Monto sugerido: Se retorna un valor asociado a la referencia, sin embargo el cliente puede pagar un valor mayor o menor, dependiendo de un rango definido por el comercio y que el cliente debe conocer.

La respuesta debe ser entregada en máximo 14 segundos.

Consulta dinámica

GET https://[URL definida por el comercio]

Query Parameters

Name	Type	Description
request_type	string	Valor del 1 al 9 el cual puede ser habilitado como criterio de búsqueda en la Red VIA Baloto dependiendo del caso de uso del comercio. Numérico 1 caracter.
reference	string	Referencia principal para la consulta de referencias de pago. Numérico Max 16 caracteres.
reference_aux	string	Referencia auxiliar la cual puede ser habilitada como criterio de búsqueda en la Red Via Baloto dependiendo del caso de uso del comercio. Numérico Max 16 caracteres.
netname	string	Nombre de identificación única de la Red de Recaudo que está procesando la transacción. Alfanumérico Max 40 caracteres.
checksum	string	Cadena de comprobación SHA512(reference + money + netname + timestamp + FIXED_HASH). Alfanumérico 128 caracteres.
money	string	Código de la moneda de la petición. (1 para Colombia). Alfanumérico Max 3 caracteres.
timestamp	number	La fecha de la petición en formato Unix (segundos). Max 10 caracteres.
transaction	string	ID único de transacción de consulta enviada por la Red de recaudo. Alfanumérico Max 40 caracteres.
teller	string	Código de la tienda/punto en dónde se realiza la transacción (IP o punto de venta). Alfanumérico Max 20 caracteres.
terminal_code	string	Código de la terminal en dónde se realiza la transacción. Alfanumérico Max 20 caracteres (Depende de los codigo de la Red).
geographic_code	string	Código de la localidad en dónde se realiza la transacción, depende de la red/país que lo invoque. Colombia (código DANE). Alfanumérico Max 10 caracteres.
key_value	string	Para incluir posible configuración o condición especial que se deba tener en cuenta en la transacción. Cadena con estructura llave-valor. Alfanumérico Max 500 caracteres.

200 code: 0000 cuando la respuesta sea exitosa. String numérico de 4 caracteres. text: Descripción del error, "OK" cuando la respuesta sea exitosa. Alfanumérico Max 20 caracteres.description_order: Descripción general de la orden. Alfanumérico Max 30 caracteres por restricciones de la Red.email: Email del cliente, dónde se notificará el pago de la orden. Alfanumérico Max 100 caracteres.timestamp: Tiempo en segundos formato Unix. Numérico Max 10 caracteres.payment_options: Objeto con listado de referencias para pago (por lo menos una opción).payment_type: Tipo de valor a recaudar, 1-Monto abierto, 2-Monto fijo, 3-Monto sugerido. Numérico 1 caracter.payment_reference: Referencia de pago, la que se debe enviar al momento de registrar la transacción financiera. String Max 16 caracteres, numéricos. Cada opción de pago debe tener una referencia diferente dentro de la misma petición, la referencia puede ser reutilizada cuando la orden haya sido pagada. payment_amount: Valor del pago, cero cuando es Monto abierto. Numérico Max 20 caracteres.payment_order: Este código debe ser único para todas las opciones de pago que se puedan registrar para el comercio. No debe contener guiones bajos ni caracteres especiales. Alfanumérico Max 100 caracteres.payment_desciption: Descripcíon específica para la referencia de pago. Alfanumérico Max 30 caracteres. Su visualización depende de restricciones en el punto de recaudo. Sirve para detallar cada una de las opciones de pago que tiene el cliente.payment_min: Valor mínimo del pago, solo para monto abierto(1) y monto sugerido(3). Numérico Max 20 caracteres.payment_max: Valor máximo del pago, solo para monto abierto(1) y monto sugerido(3). Numérico Max 20 caracteres.transaction_cost: Costo de la transacción, informativo, no afecta el valor de la transacción. Esto en caso que el comercio esté cobrando un valor por el servicio de recaudo. Numérico Max 20 caracteres.checksum: Cadena de comprobación, calculada con SHA512(timestamp + sum(payment_amount) + FIXED_HASH). Donde el "payment_amount" es un valor entero truncado sin decimales. Alfanumérico 128 caracteres.

{
    "code":"0000",
    "text": "OK",
    "data": {
        "description_order":"Servicios financieros",
        "email":"[e-mail]",
        "timestamp":1619649378,
        "paymen_options": [
            {
                "payment_type": 1,
                "payment_reference": "902882727241",
                "payment_amount": 0,
                "payment_order":"orden_unica_92828992",
                "payment_description": "Credito consumo 9989",
                "payment_min":1000,
                "payment_max":1000000
            },
            {
                "payment_type": 2,
                "payment_reference": "902882727242",
                "payment_amount": 25000,
                "payment_order":"orden_unica_92828993",
                "payment_description": "Credito Hipotecario 8766"
            },
            {
                "payment_type": 3,
                "payment_reference": "902882727242",
                "payment_amount": 56000,
                "payment_order":"orden_unica_92828994",
                "payment_description": "Credito rotativo 8788",
                "payment_min":20000,
                "payment_max":130000
            }
        ],
        "transaction_cost": 0.00,
        "checksum": "a5a43bfb7e2t6971062303f0a70722c8b6a2d5973a1c1e9f90ee74a9651e79410e4c04c384cffe406077d426070e070a1149e136bb035288b7c6ad0f957eff49"
    }
}