- Para qué sirve?
El servicio de notificaciones es la forma más efectiva para mantener una interconexión en tiempo real y garantizar la consistencia de la información entre Pay per TIC y vuestro sistema. A través de este servicio recibirán actualizaciones de todas las solicitudes de pago y suscripciones de forma automática, evitando la necesidad de realizar consultas o descargar archivos.
- Cómo funciona?
Es muy simple, enviaremos una notificación con cada cambio de estado de un pago o una suscripción. Esta notificación se envía a través de un POST y deberán indicar en la solicitud de pago o suscripción la URL en la que desean recibirla.
La notificación se envía con toda la información del objeto actualizado, es decir que recibirán todos los datos disponibles: La notificación contiene exactamente la misma información que devuelve el servicio de consulta.
- Dónde indico la URL de mi web service?
La URL del web service que recibirá las notificaciones debe ser indicada en cada solicitud de pago o suscripción, en el campo notification_url.
{
...
"notification_url": "https://host.com/notificaciones",
...
}
Qué información se envía en la notificación?
Se envía la información completa del documento en cuestión. Es idéntico a utilizar el servicio de consulta (ya sea para pagos o suscripciones).
- Qué debo hacer cuando recibo una notificación?
El objetivo de la notificación es actualizar la información en vuestra plataforma, por lo tanto, deberá aplicar la lógica de negocio correspondiente a la notificación que recibe, por ejemplo:
Si recibimos una notificación de un pago cuyo estado es "approved", debería buscar la transacción mencionada y marcarla como pagada en vuestro sistema
Una vez procesado el mensaje, debemos responder con código HTTP 200. Si hubiera ocurrido algún error durante el procesamiento, pueden responder con el código que corresponda, Pay per TIC reenviará esta notificación de forma autómatica durante hasta que la respuesta sea 200 de acuerdo a lo indicado en Reenvío de notificaciones.
- Qué pasa si no recibo una notificación?
Las notificaciones se envían automáticamente en el momento que ocurre un cambio en el pago o suscripción. En el caso de no recibir una notificación deberá verificar que la URL se envió en la solicitud de pago o suscripción y que la misma sea correcta. En caso de haber realizado este control y si el problema persiste, póngase en contacto con nuestro sector de soporte.
- Cómo puedo aumentar la seguridad de este sistema?
Contamos con la posibilidad de agregar una capa de seguridad a esta comunicación enviando las notificaciones encriptadas y brindándoles una llave para desencriptar los mensajes en su destino, garantizando así que las notificaciones sólo pueden ser emitidas por Pay per TIC. Para añadir esta capa de seguridad comuníquese con nuestro equipo de soporte.
- Es posible reenviar una notificación manualmente?
Efectivamente, en el front de entidades cuenta con la posibilidad de forzar el reenvío de notificaciones manualmente y también disponemos de un servicio web que permite realizar esta acción.
- Cada cuanto se reenvían las notificaciones fallidas?
El intervalo de tiempo es exponencial, los primeros reintentos son a los pocos segundos y este valor aumenta hasta llegar a una hora.
- Hasta cuando se reenvía una notificación fallida?
Se reenvían durante un lapso de 5 días. Una vez pasados no se realizan más reintentos automáticos, pero es posible forzar el reenvío manulamente como vimos anteriormente.