Notificación

Para esta etapa del proceso de integración el comercio debe construir un servicio REST que será consumido por Payvalida para realizar el proceso de notificación. Cuando esté construido, se debe comunicar a Payvalida para que se realice el registro de la URL de dicho servicio.

Al momento de registrar una orden de desembolso, ésta se crea en estado PENDIENTE. La orden de desembolso puede cambiar por diversas razones:

1. El cliente ha efectudo el desembolso -> Cambia de estado PENDIENTE a APROBADO y se notifica con status APROBADA.

2. No se ha efectuado el desembolso antes de la fecha de vencimiento -> Cambia de estado PENDIENTE a CANCELADA y se notifica con status VENCIDA.

El sistema notifica de forma automática en el momento del cambio de estado de la orden.

La notificación se envía por el método HTTP POST con un body de tipo json.

Request (Lo ejecuta Payvalida)

Request (Lo ejecuta Payvalida)

Campo	Tipo	Descripción
amount	float64	Monto de la orden de desembolso
document	string	Documento de identidad asociado a la orden de desembolso
operation	string	Identificador generado por el comercio para la orden de desembolso
currency	string	Moneda con la que se registra la orden de desembolso
status	string	Estado de la orden del desembolso (El valor que se envía es APROBADA)
checksum	string	Cadena de comprobación calculada con SHA512(operation+document+amount+currency+status+NOTIFICATION_HASH). El amount para el cálculo del checksum debe ser transformado a entero.

Response

Campo	Tipo	Descripción
code	int	El valor 0 lo tomamos como ejecución correcta. Si se retorna un valor diferente lo tomamos como un error.
text	string	Descripción de la ejecución al momento de responder.

Para Cashout+ el tiempo de vencimiento de una orden es por defecto de 1 día, en caso que el cliente no haga el retiro del dinero se ejecutará el proceso de vencimiento una vez el tiempo se cumpla, posterior se notifica al comercio y retorna el valor a la bolsa.