Confirmar Transacción

Cuando el comercio responda correctamente esta petición la orden se entenderá aprobada y Payvalida procederá a autorizar a la Red Comercial que conserve el dinero.

Petición realizada por Payvalida para aprobar la transacción que se ejecuta en el punto de recaudo.

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

Confirmar Transacción

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

Request Body

Name	Type	Description
request_type	integer	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.
payment_reference	string	Referencia que se va a pagar, la cual fue recibida dentro del listado de opciones posibles a pagar en el método de consulta. String Max 16 caracteres, numéricos.
amount	number	Valor del pago. Numérico Max 20 caracteres.
payment_order	string	Orden única en el comercio, recibida previamente dentro del listado de opciones posibles a pagar en el método de consulta. Alfanumérico Max 100 caracteres.
netname	string	Nombre de identificación única de la Red de Recaudo. Alfanumérico Max 100 caracteres.
checksum	string	Cadena de comprobación, calculada con SHA512(netname + reference + payment_reference + amount + transaction + FIXED_HASH). Alfanumérico 128 caracteres.
timestamp	integer	La fecha y hora en formato Unix (segundos). Max 10 caracteres.
transaction	string	ID único de transacción de pago registrada por la red de recaudo. Alfanumérico Max 50 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 50 caracteres.
terminal_code	string	Código de la terminal en dónde se realiza la transacción. Alfanumérico Max 50 caracteres (depende de la Red de Recaudo)
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. Para Colombia podría ser el código DANE. Alfanumérico Max 20 caracteres.
key_value	string	Para incluir posible configuración o condición especial que se deba tener en cuenta en la transacción. posibilidad de incluir cadena con estructura llave-valor. Alfanumérico Max 500 caracteres.
money	string	Código de moneda de la transacción. Colombia "1". Alfanumérico Max 3 caracteres.

200 code: "0000" cuando la respuesta sea exitosa. String numérico 4 caracteres. text: Descripción del error, "OK" cuando la respuesta sea exitosa. Alfanumérico Max 30 caracteres.amount: Valor aceptado. Numérico Max 20 caracteres.payment_order: Informativo, confirmación de la orden del comercio, igual a la retornada en la consulta. Alfanumérico Max 100 caracteres.transaction_cost: Informativo, confirmación del costo de la orden. Numérico Max 20 caracteres.description: Informativo, descripción genérica del resultado de la operación. Alfanumérico Max 30 caracteres. No debe contener caracateres especiales.timestamp: Fecha y hora en formato Unix segundos. Numérico 10 caracteres.authorization_code: Código de autorización del comercio, código de aprobación entregado por el comercios. Alfanumérico Max 15 caracteres, sin caracteres especiales.checksum: Cadena de comprobación, calculada con SHA512( timestamp + authorization_code + FIXED_HASH ). Solo se calcula cuando el http status = 200. Alfanumérico 128 caracteres.

{
    "code":"0000",
    "text": "OK",
    "data": {
        "amount":5000,
        "payment_order":"orden_unica_92828992",
        "transaction_cost":0,
        "description":"Descripcion de la transaccion",
        "timestamp":1619649378,
        "authorization_code":"872YTGHS89",
        "checksum": "a5a43bfb7e2t6971062303f0a70722c8b6a2d5973a1c1e9f90ee74a9651e79410e4c04c384cffe406077d426070e070a1149e136bb035288b7c6ad0f957eff49"
}