Bienvenida para las integraciones en CMS

Introducción

La siguiente guía informativa tiene como objetivo los primeros pasos en las integraciones de la pasarela de pagos en tu plataforma de comercio online. Los pasos a seguir son los siguientes:

1. Integrar Addon Payments en tu página web.
2. Configurar tu pasarela en entorno de Staging/Pruebas.
3. Probar el correcto funcionamiento en entorno de Staging/Pruebas.
4. Solicitar el pase a Producción.

Durante la fase de integración, podrás realizar todas las pruebas que consideres necesarias sobre la pasarela, a fin de verificar el correcto funcionamiento de la misma. Para ello, consulta las siguientes secciones de esta guía:

• Realizar consultas en el Portal BackOffice.
• Los pedidos no se actualizan en mi plataforma.

Integrar Addon Payments en tu página web

El primer paso para poder operar es la correcta instalación de una pasarela de pago compatible y su posterior configuración con los datos facilitados en el correo de bienvenida.

La instalación corresponde al comercio, o bien, al proveedor de servicios o empresa integradora que esté desarrollando o integrando tu plataforma para venta online. Este proceso no corresponde a CaixaBank ni a Addon Payments.

Para las plataformas modulares dispones de un plugin gratuito que puedes descargar en esta página o en las guías de integración correspondientes. En estas guías encontrarás cómo integrar, errores comunes con las incidencias y sus pasos a seguir; y guías de gestión de transacciones.

Estas son las plataformas disponibles, haz clic para ir a la guía de instalación:

• PrestaShop
• WooCommerce
• Magento
• Salesforce

Para poder operar con módulos debes añadir como autorizados los dominios en los que vas a integrar la pasarela y activar la compatibilidad con módulos. Para ello, sigue los pasos indicados en la sección Anexo 1 – Añadir dominio seguro y activar compatibilidad con módulos de esta guía.

Si tu plataforma de comercio online no está incluida en el listado anterior (plataforma de desarrollo propio o a medida o plataforma modular sin módulo compatible por Addon Payments), puedes consultar más detalles sobre estas integraciones en esta guía de introducción.

Configurar tu pasarela en entorno de Staging

Una vez hayas realizado la integración de Addon Payments en tu plataforma de comercio online, es necesario introducir los datos de configuración de tu comercio. Los datos necesarios para poder realizar operaciones de prueba en entorno de Staging/Pruebas son:

• Entorno o URL:

• • PrestaShop y WooCommerce:  “Modo producción”: “deshabilitado” en la configuración del módulo.
  • Magento: “Sandbox” fijado a “Sí” en la configuración del módulo.
  • Desarrollos a medida: URLs del entorno de Staging/Pruebas indicadas en las guías de integración correspondientes al tipo de integración.

• Id. de comercio: Facilitado en el correo de alta en Staging/Pruebas recibido.
• Id. de producto: Facilitado en el correo de alta en Staging/Pruebas recibido.
• Contraseña del comercio (cifrado): Facilitado en el correo de alta en Staging/Pruebas recibido.
• Clave API (módulos e integración JS): Facilitado en el correo de alta en Staging/Pruebas recibido.

En plataformas modulares (PrestaShop, WooCommerce y Magento), puedes consultar cómo configurar la pasarela según la guía de integración específica para tu plataforma:

• PrestaShop
• WooCommerce
• Magento

Probar el correcto funcionamiento en entorno de Staging

Con la pasarela de pagos configurada para operar en entorno de Staging/Pruebas, es el momento de realizar una serie de operaciones para comprobar el correcto funcionamiento de la misma, así como la correcta configuración de los datos de tu comercio.

El proceso recomendado consiste en finalizar varios pedidos a través de tu plataforma de comercio online, seleccionando método de pago por tarjeta de crédito y llegando hasta la pasarela de pago, donde se solicitará la numeración de la tarjeta.

En el siguiente enlace, tienes una lista de tarjetas para pruebas que te permitirán simular diferentes operativas.

Una vez se finalicen las operaciones correctamente, comprueba a través del Portal BackOffice de Addon Payments que todas las pruebas aparecen en el listado de operaciones. Consulta la sección sobre realizar consultas en el Portal BackOffice de esta guía.

Por último, verifica que las operaciones han actualizado el estado de los pedidos en la plataforma de comercio online, marcando como autorizado o denegado el pago según corresponda. Si no ha sucedido, consulta la sección sobre los pedidos no se actualizan en mi plataforma de esta guía.

Solicitar pase a Producción

Si tras las verificaciones y comprobaciones el funcionamiento de la pasarela de pago es correcto, puedes solicitar el pase a Producción o entorno real.

Para ello, envía un correo electrónico a support@addonpayments.com, indicando en la solicitud el id. de comercio para el cual se solicita el pase a Producción.

Una vez recibida la solicitud, nuestro equipo verificará el correcto funcionamiento de la pasarela de pagos en tu plataforma online en entorno de Staging/Pruebas. Para agilizar el proceso de pase a Producción, recomendamos que antes de enviar la solicitud de pase a Producción verifiques estos puntos:

1. Acceder a la URL informada con el TPV virtual instalado. En caso de que la URL no esté accesible, o el TPV virtual esté instalado de forma temporal en otra URL para desarrollo o pruebas, podrás indicarnos la URL a la que acceder para realizar la validación en el mismo correo de solicitud de pase a Producción.
2. Si es necesario usuario y contraseña o cuenta registrada para poder finalizar el proceso de compra, agradecemos que nos facilites unas credenciales con las que poder acceder. Pueden ser incluidas en el mismo correo de solicitud de pase a Producción.
3. Se revisará si los productos o servicios ofertados son acordes a la legislación vigente y están admitidos por CaixaBank para venta no presencial. Consulta el Anexo 2 – Productos o servicios no admitidos para venta no presencial. Por ello, es necesario que la mayoría de productos o servicios estén cargados en tu tienda online junto a una imagen del mismo. Si ofreces productos o servicios no autorizados, será necesaria su retirada para superar la validación.
4. Seleccionaremos un par de artículos o realizaremos una reserva, en el caso de alquileres u hoteles. El carrito de la compra, motor de reservas, o equivalente debe estar operativo y permitir finalizar el proceso. En caso de ser necesarios pasos específicos para poder finalizar el pedido, pueden ser indicados en el mismo correo de solicitud de pase a Producción.
5. Seleccionaremos tarjeta de crédito como método de pago. La tienda online debe generar y enviar la operación a la pasarela de pago en entorno de Staging/Pruebas, donde verificaremos la correcta configuración de los datos del comercio. Nota: No está permitida la captura, tratamiento ni envío de datos de tarjeta de clientes por plataformas del comercio si no dispones de certificación PCI-DSS.
6. Si tu comercio online es una farmacia con venta de medicamentos sin receta, además de los requisitos descritos, deberás cumplir los indicados en el listado de requisitos específicos para farmacias con venta de medicamentos.
7. Una vez tu página web haya superado el proceso de validación, recibirás un correo electrónico en la cuenta autorizada indicando los pasos para operar en entorno real o Producción con tu TPV virtual.
8. Si tu tienda online no supera el proceso de validación se responderá a la solicitud indicando el motivo. Podrás volver a solicitar el pase a Producción una vez hayas corregido el motivo.

A continuación, se resume el listado de requisitos para conceder el pase a Producción:

• URL accesible, o facilitar una URL alternativa en su lugar.
• Credenciales, en caso de ser necesarias para finalizar un pago.
• Productos o servicios cargados junto a imágenes o fotografías.
• Carrito de la compra, motor de reservas o equivalente funcional.
• Que no se realice redirección a otra página al seleccionar los artículos.
• Pasarela web activa para pago con tarjeta y correctamente configurada en entorno de Staging.
• Productos o actividades permitidas para venta no presencial. Consulta el Anexo 2 de esta guía.
• Farmacias con venta de medicamentos. Deben cumplir las indicaciones del Anexo 3 de esta guía.

Realizar consultas en el Portal BackOffice

Dispones de un portal web de BackOffice que te permitirá, entre otras cosas, consultar, capturar o anular operaciones que estén pendientes y realizar devoluciones sobre operaciones previas.

Dispones de la guía de consulta de operaciones en el Portal BackOffice de Addon Payments donde encontrarás toda la información.

Los pedidos no se actualizan en mi plataforma

Las incidencias más comunes que impiden la correcta actualización de los estados de los pedidos son los errores de URL y los errores de permisos en el servidor web.

Mediante el Portal BackOffice puedes revisar la correcta recepción de las notificaciones enviadas desde Addon Payments a tu plataforma de comercio electrónico con el estado de los pedidos.

Para ello, tienes que localizar la sección de “Notificaciones de la transacción” en la parte inferior de los detalles de la transacción que quieres revisar:

• La información se organiza en las columnas:
  • Fecha de creación: Fecha en la que se ha realizado el envío de la notificación.
  • URL de notificación: URL a la que se ha enviado la notificación.
  • Recibido: Booleano que indica si tu plataforma de comercio electrónico ha recibido la notificación.
    • true: La notificación ha sido correctamente recibida por tu servidor web. Se ha recibido un código de confirmación (HTTP 200).
    • false: La notificación no ha sido correctamente recibida por el servidor web de tu plataforma de comercio electrónico. Puede deberse por URL inexistente, URL con acceso restringido (HTTP 403), URL no encontrada (HTTP 404) o error interno del servidor web (HTTP 500) de tu plataforma.

• • Mensaje: Contenido de la notificación generada.

Nota: Si una notificación no se puede entregar en la página de tu comercio que has indicado, AP lo reintentará otras cuatro (4) veces más cada cinco (5) segundos.

En caso de que falle la entrega de las notificaciones, te recomendamos seguir los siguientes pasos para localizar y corregir la causa de la incidencia:

1. Accede a la lista de notificaciones de la transacción. Guarda la URL y el contenido de una de las notificaciones fallidas.
2. Usa un buscador para localizar una herramienta web que te permita el envío de peticiones HTTP POST.
3. En la herramienta web de tu elección, introduce la URL de notificación de tu plataforma en la URL de envío. Usa el formato XLS o tipo de contenido y el mensaje de la notificación como contenido.
4. Pulsa el botón “Enviar” de la herramienta web y revisa el código de respuesta recibido.
5. Consulta el código recibido así como las posibles soluciones propuestas en el punto listado de códigos de respuesta y denegaciones HTTP más comunes de esta guía.

Listado de códigos de respuesta y denegaciones HTTP más comunes