Notificación

Este es el proceso de notificación que utiliza Payvalida para comunicar al comercio si una transferencia específica fue aprobada o rechazada por el banco.

Para esta etapa del proceso de integración el comercio debe construir un servicio REST que será consumido por Payválida para realizar el proceso de notificación. Cuando esté construido, se debe comunicar a Payválida para que se realice el registro de la URL de dicho servicio. 
Al momento de realizar una transferencias, ésta se crea en estado EN PROCESO. La orden de desembolso puede cambiar por diversas razones: 
1.El banco a aprobado la transferencia -> Cambia de estado EN PROCESO a APROBADA.
2.Si el banco rechaza la transferencia -> Cambia de estado EN PROCESO a RECHAZADA y se notifica con status RECHAZADA. 
El sistema notifica de forma automática en el momento en que el banco emita una respuesta acerca de una transferencia específica.

La notificación se envía por el método HTTP POST con un body de tipo json.
Request (enviado por Payvalida)
Response
Campo
Tipo
Obligatorio
Descripción
amount
float64
Sí
Monto de la orden de desembolso.
document
string
Sí
Documento de identidad del beneficiario de la transferencia
operation
string
Sí
Identificador generado por el comercio para la transferencia.
currency
string
Sí
Moneda con la que se registra la orden de desembolso
status
string
Sí
Estado de la orden del desembolso (El valor que se envía es APROBADA o RECHAZADA)
checksum
string
Sí
Cadena de comprobación calculada con SHA512(operation+document+amount+currency+status+FIXED_HASH). El amount para el cálculo del checksum debe ser transformado a entero.
rejectionReason
string
No
Razón por la cuál el banco rechazó la transferencia bancaria. Este campo solo se enviará en caso de que la transferencia sea notificada como RECHAZADA
​
Campo
Tipo
Text
code
int
El valor 0 lo tomamos como ejecución correcta. Si se retorna un valor diferente lo tomamos como un error, de ser el caso se enviará una notificación vía correo electrónico.
text
string
Descripción de la ejecución al momento de responder. 

Campo	Tipo	Obligatorio	Descripción
amount	float64	Sí	Monto de la orden de desembolso.
document	string	Sí	Documento de identidad del beneficiario de la transferencia
operation	string	Sí	Identificador generado por el comercio para la transferencia.
currency	string	Sí	Moneda con la que se registra la orden de desembolso
status	string	Sí	Estado de la orden del desembolso (El valor que se envía es APROBADA o RECHAZADA)
checksum	string	Sí	Cadena de comprobación calculada con SHA512(operation+document+amount+currency+status+FIXED_HASH). El amount para el cálculo del checksum debe ser transformado a entero.
rejectionReason	string	No	Razón por la cuál el banco rechazó la transferencia bancaria. Este campo solo se enviará en caso de que la transferencia sea notificada como RECHAZADA

Campo	Tipo	Text
code	int	El valor 0 lo tomamos como ejecución correcta. Si se retorna un valor diferente lo tomamos como un error, de ser el caso se enviará una notificación vía correo electrónico.
text	string	Descripción de la ejecución al momento de responder.

Transferencias - Previous

Realizar transferencias

Next - Bancos

Colombia

Last modified 1mo ago