Introducción

Esta API es para uso exclusivo de aliados de recaudo, permitiéndole al usuario realizar pagos en efectivo de forma presencial en redes de efectivo o registrar una referencia de pago en el sistema o aplicación del aliado de recaudo. El proceso consta de 3 operaciones:

• Consulta: Permite a la red obtener información acerca de la transacción que el cliente desea realizar, proporcionando la referencia.

• 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.

• Cancelar transacción: La red cuenta con 30 segundos para aplicar un reverso en caso de presentarse un error técnico en su sistema; algunos ejemplos son: timeout en la comunicación o errores de conexión a la base de datos.