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. 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	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.
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	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	Utilizado en el método de consulta. 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.
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"
    }
}