Analizar el resultado del pago

Después de cada pago (aceptado o rechazado) la plataforma envía al sitio del vendedor una notificación que contiene el resultado del pago.

Esta notificación también se conoce como IPN.

Para gestionar las notificaciones, el vendedor debe desarrollar una página especializada que analice los datos transmitidos en modo POST (ejemplo de URL: https://sitio-vendedor.com/analisis_pago.php).

En función del resultado, esta página iniciará distintas acciones (modificar el estado del pedido, actualizar el stock etc.).

Prerrequisito:

  • La URL de la página que analiza el resultado del pago debe ingresarse obligatoriamente en el Back Office Vendedor (consulte el capítulo Configurar notificaciones).
  • El vendedor debe asegurarse de que esta URL sea accesible por la plataforma de pago sin redirección.

    Los redireccionamientos dan como resultado la pérdida de datos en POST.

  • En caso de que se establezca una restricción en el lado del sitio web del vendedor, será necesario autorizar el rango de direcciones de IP: 194.50.38.0/24.
    Las notificaciones se envían desde una dirección IP en el rango 194.50.38.0/24 en modo TEST y en modo PRODUCTION.
  • La página no debe tener una vista HTML.

    El acceso a recursos como imágenes o hojas de estilo ralentizan los intercambios entre la plataforma de pago y el sitio web vendedor.

  • Evite las tareas que consumen tanto tiempo como facturar o enviar correos electrónicos en este script.

    El tiempo de procesamiento tiene un efecto directo en el plazo de visualización de la página de resumen de pago para el comprador. Cuanto mayor sea el procesamiento de la notificación, más se demora la visualización.

    Si el tiempo de procesamiento supera los 35 segundos, la plataforma considera que la llamada ha fallado (timeout).

Error de notificación (IPN)

Si la llamada a la URL de notificación (IPN) falla, se envía un e-mail de advertencia a la dirección especificada en el Back Office Vendedor (consulte el capítulo Configurar notificaciones).

Este contiene:

  • el código HTTP del error encontrado,
  • los elementos de análisis en función del error,
  • el procedimiento que seguir para reenviar la notificación desde el Back Office Vendedor.

Para ayudar al vendedor a identificar el origen del error, la plataforma analiza sistemáticamente los primeros 512 caracteres que devuelve el sitio del vendedor.

Estos caracteres se muestran en el detalle de las transacciones, pestaña Historial:

Crear el script de procesamiento

El script de procesamiento debe incluir al menos los siguientes pasos:

  • Recuperar la lista de campos presentes en la respuesta enviada en POST
  • Calcular la firma tomando en cuenta los datos recibidos
  • Comparar la firma calculada con la recibida.
  • Analizar la naturaleza de la notificación
  • Recuperar el resultado del pago

El script puede, por ejemplo, probar el estado del pedido (o la información de su elección) para verificar que no se haya actualizado.

Una vez que se han completado estos pasos, el script puede actualizar la base de datos (nuevo estado del pedido, actualización del stock, registro de la información de pago, etc.).