Registrar transacción

Permite a la red registrar la transacción de pago en Payvalida; una vez recibida esta petición correctamente, la referencia se considera aprobada. Antes de invocar esta operación, la red debe hacer las validaciones de negocio pertinentes, algunos ejemplos son: usuario cuenta con saldo suficiente para la transacción o validar un monto mínimo de la transacción.

Sandbox: https://api-test.payvalida.com/v4/recaudo/dinamico/recaudoregister

Los campos marcados con asteriscos (*) son obligatorios.

POST https://api.payvalida.com/v4/recaudo/dinamico/recaudoregister

Request Body

Name	Type	Description
netname*	string	Nombre de identificación única de la Red de Recaudo
request_type*	integer	Utilizado en el método de consulta
reference*	string	Utilizado en el método de consulta
reference_aux	string	Utilizado en el método de consulta
payment_reference*	string	Referencia de pago, recibida dentro del listado de opciones posibles a pagar.
transaction*	string	ID transacción único de la Red de recaudo. Puede ser el mismo utilizado en la consulta.
amount*	number	Valor a recaudar. No incluir más de 4 decimales.
checksum*	string	Cadena de comprobación, calculada con SHA512(netname + reference + trasaction + amount + FIXED_HASH). Para este cálculo el "amount" se incluye sin decimales.
commerce	string	Nombre del comercio sobre el cual se está realizando la transacción
timestamp*	number	Fecha en formato Unix segundos.
request_transaction	string	ID de la transacción utilizada en la consulta
teller*	string	Código de la tienda/punto en dónde se realiza la transacción (ip o punto de venta)
terminal_code*	string	Código de la terminal en dónde se realiza la transacción
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)
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
money*	string	Código de moneda de la transacción. Formato ISO
name	string	Nombre del depositante
lastname1	string	Primer apellido del depositante
lastname2	string	Segundo apellido del depositante

200 code: 0000 cuando la respuesta sea exitosa. text: Descripción del error, "OK" cuando la respuesta sea exitosa transaction_cost: Costo de la transacción, solo a nivel informativo amount: Valor aceptado de recaudo description: Descripción general del comercio en la acptación del recaudo payment_reference: Referencia de pago. transaction: Confirmación ID única de la transacción de la Red pv_order: Código de la orden en Payvalida commerce: Nombre del comercio asociado al pago timestamp: Fecha en formato Unix segundos. authorization_code: Código de autorización entregado por el comercio. checksum: Cadena de comprobación, calculada con SHA512(timestamp + amount + FIXED_HASH). Solo se calcula cuando Body/data no es vacío. Para este cálculo el "amount" se incluye sin decimales.

{
    "code":"0000",
    "description": "OK",
    "data": {
        "transaction_cost":3000,
        "amount":50000,
        "descripcion":"",
        "payment_reference":"98383899901",
        "transaction":"237883993939",
        "pv_order": "2929299001",
        "commerce":"kuanto",
        "timestamp": 1618641323,
        "authorization_code":"IUSYY8899",
        "checksum":"a5a43bfb7e2t6971062303f0a70722c8b6a2d5973a1c1e9f90ee74a9651e79410e4c04c384cffe406077d426070e070a1149e136bb035288b7c6ad0f957eff49"
    }
}