Consulta
Last updated
Was this helpful?
Last updated
Was this helpful?
Permite a la red obtener información acerca de la transacción que el cliente desea realizar, proporcionando la referencia.
Sandbox:
Los campos marcados con asteriscos (*) son obligatorios.
POST https://api.payvalida.com/v4/recaudo/dinamico/recaudoconsulta
Como criterios de búsqueda, la Red de recaudo tendrá las siguientes opciones que el API soporta: Reference, reference_aux, request_type y key_value.
Con base en este criterio, Payválida retornará un listado de referencias para pago, es posible que dentro de las opciones solo haya una opción con la misma referencia de consulta, o que haya un listado de más referencias disponibles. En la respuesta, cada referencia de pago cuenta con una de las tres posibles opciones para pago: - 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 referencia del pago y con la cual se debe realizar el proceso de conciliación con la Red es la utilizada en la transacción financiera, el campo "reference" de este API es para efectos de consulta.
netname*
string
Nombre de identificación única de la Red de Recaudo.
request_type*
number
Valor debe ser 1. En caso de que por el contexto la red necesite definir opciones que permitan definir criterios podemos usar este valor, por ejemplo definir: 1-Abono capital, 2-Reducción cuota
reference*
string
Referencia principal de la consulta
reference_aux
string
Referencia opcional. Aplica para convenios que requieran una referencia adicional.
teller*
string
Código de la tienda/punto en dónde se realiza la transacción (ip o punto de venta)
checksum*
string
Cadena de comprobación, calculada con SHA512(netname + reference + FIXED_HASH)
timestamp*
number
La fecha y hora de la consulta, en formato Unix (segundos)
terminal_code
string
Código de la terminal en dónde se realiza la transacción
geographic_code*
string
Hace referencia al código postal de la localidad en dónde se realiza la transacción, depende de la red/país que lo invoque. En Colombia se conoce como código DANE.
key_value*
string
Valor debe ser 1. En caso de que por el contexto la red necesite incluir posible configuración o condición especial que se deba tener en cuenta en la transacción se puede enviar una cadena con estructura llave-valor.