Aspectos generales sobre la IPN
Este documento define el concepto de IPN y explica cuándo utilizarla.
¿Qué es la IPN?
IPN son las siglas de un término inglés que significa Instant Payment Notification. En español se habla de notificación instantánea de pago.
La IPN es una notificación de servidor a servidor (servidor de plataforma de pago hacia el servidor del vendedor) que permite que el sitio web comercial reciba notificaciones en tiempo real y de manera automática cuando se produce un evento, por ejemplo, cuando se registra una transacción.
Es posible configurar el envío de notificaciones en los siguientes casos:
- evento en el formulario de pago (formulario HTTPS): registro de un pago simple o recurrente, abandono del pago, etc.
- Operación proveniente del
Back Office Vendedor : registro de un pago simple o recurrente, anulación, reembolso, modificación, validación de una transacción, etc.
Para recibir las notificaciones, el vendedor debe configurar al menos la regla de notificación al final pago. Esta regla se define de manera automática al crearse la tienda.
No hay envío de IPN cuando los intercambios entre el vendedor y la plataforma de pago se realizan a través de Web Service (de servidor a servidor) ya que en este caso, el vendedor analizará la respuesta del Web Service, que recibirá en tiempo real.
Esta notificación consiste en una llamada a una URL situada en el servidor del vendedor. El vendedor define esta URL, denominada URL de notificación instantánea, desde su
El vendedor puede definir varias reglas según el tipo de evento.
Los datos se enviarán en modo POST y, entre ellos, encontrará:
- El medio de pago que utiliza el comprador,
- El código de retorno de autorización,
- El tipo de autorización (pre-auto o completa),
- Indormación del medio de pago utilizado por el comprador (ejemplo: tipo, número de tarjeta oculto, fecha de expiración, etc.),
- El monto,
- La dirección de e-mail del comprador,
- El número de la orden,
- etc.
Los datos transmitidos en la IPN se reciben y analizan mediante un script que el vendedor habrá desarrollado en su servidor. La ejecución de este script permite al vendedor actualizar su sistema de información en función de la información recibida.
La URL de notificación también puede sobrecargarse al realizar la solicitud.
¿Cuál es el principio de funcionamiento de una IPN?
El diálogo entre el servidor del vendedor y la plataforma de pago se efectuará mediante intercambio de datos. Para garantizar la seguridad de los intercambios, los datos se firmarán mediante una clave conocida solamente por el vendedor y la plataforma de pago.
Para crear un pago, estos datos se enviarán mediante un formulario HTML a través del navegador del comprador (etapa 1).
Al final del pago, el resultado se transmite al sitio web comercial de dos maneras:
- automáticamente mediante notificaciones enviadas a la URL de notificación instantánea (etapa 2).
- por el navegador cuando el comprador hace clic en el botón para volver al sitio web comercial (etape 3).
El tiempo de procesamiento tiene un efecto directo en el plazo de la visualizacion de la página de resumen de pago. Cuanto mayor sea el procesamiento, más se demora la visualización.
¿Qué diferencia existe entre la URL de notificación instantánea y la URL de retorno a tienda?
La gestión del diálogo con el sitio web comercial se realiza mediante dos tipos de URL:
- URL de notificación instantánea, utilizada por la IPN,
- URL de retorno hacia el sitio web comercial.
La URL de notificación instantánea permite que la plataforma de pago notifique el resultado del pago al sitio web comercial de manera automática. El navegador utiliza la URL de retorno hacia el sitio web comercial para redirigir al comprador hacia el sitio web comercial cuando hace clic en el botón de retorno a la tienda.
Los datos transmitidos al navegador son los mismos que en la IPN. El retorno a la tienda deberá consistir simplemente en mostrar un contexto visual al comprador. Por tanto, los datos recibidos no podrán utilizarse para efectuar el tratamiento en base de datos.
¿Cómo comprobar que la IPN funciona?
Puede consultar el historial de notificaciones de una transacción en el
¿Qué hacer en caso de error?
Si se produce problema, el historial de las notificaciones permite consultar:
- la hora de la notificación (en tiempo real al finalizar el pago),
- la duración de la ejecución del script de análisis en el servidor del vendedor,
- los 100 primeros caracteres de su script escrito en el canal abierto entre la plataforma de pago y el servidor del vendedor (por recuperación de printout en este canal).
En caso de error de ejecución de la IPN, se envía un mensaje de alerta a la dirección de e-mail indicada en el
Este e-mail contiene:
- el código HTTP del error encontrado,
- elementos de análisis en función del error,
- el procedimiento que se debe seguir desde el
Back Office Vendedor para reenviar la notificación.
También será posible activar una opción de resolicitud automática de la IPN (menú Configuración > Reglas de notificaciones > pestaña Llamada URL de notificación > active la casilla «Resolicitud automática en caso de falla»). C
Esta opción permite enviar automáticamente la notificación al sitio del vendedor hasta 4 veces en caso de fallo. Los intentos de llamada se programan a horas fijas cada 15 minutos (00, 15, 30, 45). Tras cada intento infructuoso, se envía un e-mail de alerta a la dirección indicada como en el caso anterior. El e-mail enviado incluye en el asunto el número correspondiente al intento de envío de la notificación.
Podrán aparecer varios códigos de retorno de tipo HTTP durante este diálogo entre servidores. Cuando el código de retorno devuelto comienza por 4xx o 5xx, no se puede realizar la reejecución automática.
Si su script contiene errores, la plataforma de pago le ofrece la posibilidad de reejecutar manualmente la URL de notificación instantánea desde el
En resumen, estos son los tres consejos que le ofrecemos:
- Esté pendiente de la configuración de sus reglas de notificación,
- Testee la IPN,
- Lea los e-mails de la plataforma de pago, son muy útiles.