Comprobaciones previas

Antes de instalar y configurar el módulo de Addon Payments para WooCommerce, hay que hacer algunas comprobaciones para asegurar su correcto funcionamiento.

Requisitos de la plataforma

El módulo de Addon Payments para WooCommerce es compatible con las siguientes configuraciones:

• WooCommerce instalado sobre WordPress.
• PHP 7.x con las siguientes extensiones instaladas y habilitadas:
  • mbstring
  • bcmath o gmp (GNU Multiple Precision)
• Servidor web Apache2 o Nginx.

La compatibilidad de otras configuraciones no ha sido probada. Por lo tanto, no podemos ofrecer soporte sobre las mismas.

Configurar PHP

El módulo requiere que las siguientes extensiones de PHP estén instaladas y habilitadas:

• mbstring
• bcmath o gmp (GNU Multiple Precision)

Como el módulo de Addon Payments tiene un tamaño superior a 13 MB, es necesario modificar los siguientes parámetros de configuración de PHP, estableciendo un valor mínimo de 20 MB:

• post_max_size (8 MBs por defecto)
• upload_max_filesize (2 MBs por defecto)

Para modificar los valores indicados, realiza los siguientes pasos:

1. Localiza el archivo de configuración de PHP (php.ini) y ábrelo con un editor de texto. La localización de este archivo depende de la plataforma, puedes verificar su ruta mediante el ítem “Loaded Configuration File” de phpinfo() que se explica en la siguiente sección.
2. Localiza los siguientes ítems y amplía su valor a 20MB (20M) o superior:
   • post_max_size
   • upload_max_filesize 
3. Para ampliar su valor escribe “20M” o un valor superior, a continuación de los ítems. 
4. Guarda cambios y cierra el editor.
5. Si estás usando PHP FPM/FastCGI, reinicia el servicio FPM de PHP. El comando para hacerlo dependerá de la distribución de linux/unix, y requiere permisos de administrador. Los comandos más probables son:
   • “systemctl restart php-fpm”, distribuciones con systemd.
   • “service php-fpm restart”, distribuciones con SysVinit.
   • Si tienes más de una versión de PHP instalada en el servidor, es recomendable indicar la versión del demonio a reiniciar. Por ejemplo «systemctl restart php7.1-fpm«.
6. Reinicia el servicio del servidor web. El comando depende de la distribución de linux/unix y del servidor web instalado, y requiere permisos de administrador. Los más usuales son:
   • “systemctl restart apache2”, servidor web Apache2.
   • “systemctl restart nginx”, servidor web Nginx.
7. Comprueba que las modificaciones en la configuración de PHP se han aplicado correctamente. Para ello, usa la función phpinfo().

Verificar configuración mediante la función phpinfo()

Para verificar los pasos de la configuración del PHP, puedes hacer uso de la función de PHP phpinfo():

1. Sube un archivo .php a tu servidor de hosting con el siguiente código: <?php phpinfo(); ?>
2. Para mayor fiabilidad de la información mostrada, sitúa el archivo dentro del directorio que contiene la plataforma de comercio electrónico (WordPress).
3. Abre en el navegador web la ruta al archivo que has creado en el servidor web.
4. Se mostrará una web con información, como:

• PHP Version: Versión de PHP instalada en el servidor web.
• Loaded Configuration File: Ruta del archivo de configuración de PHP en el servidor web.
• post_max_size/upload_max_filesize: Valores de configuración de PHP

• BCMath/GMP/Multibyte: Módulos instalados y/o habilitados.

• $_SERVER[‘SERVER_SOFTWARE’]: Servidor web y versión.

Añadir dominio seguro y activar compatibilidad con módulos

Addon Payments requiere que los dominios en los que aparezca la pasarela de pago estén registrados como dominios seguros en la configuración de tu comercio.
En el panel de gestión de Addon Payments, puedes configurar los dominios seguros en el entorno que corresponda (pruebas/producción). Para ello, sigue estos pasos:

1. 1. Accede al panel de gestión de Addon Payments en el entorno adecuado (pruebas/producción).
      • Pruebas: https://smb-stg.easypaymentgateway.com
      • Producción: https://smb.easypaymentgateway.com
   2. Si la configuración es para un sub comercio, accede al mismo pulsando en “Configuración de Comercio” > “Gestión de Merchants” y selecciona el comercio que necesites.
   3. Pulsa en “Configuración de Dominio”.

1. Verifica que el dominio desde el cual se lanza la pasarela de pago esté en la “Lista de dominios seguros” mostrada.
2. Para añadir un dominio o agregar uno adicional, pulsa el botón “Añadir dominio” e introduce su URL. Las URLs introducidas sólo requieren estos elementos: (https://), subdominio y dominio. No son necesarias rutas, parámetros ni etiquetas. Por ejemplo:
   • “https://www.midominio.com/es/tienda” tan solo hace falta introducir: “https://www.midominio.com”.
   • En caso de operar con subdominios (https://sub.midominio.com) también será necesario incluirlos como dominios seguros.
3. Verifica que la casilla “Voy a utilizar plataformas de ecommerce con plugins” está marcada.
4. Pulsa en el botón “Guardar” para guardar los cambios.
5. Recarga la página del panel de gestión de Addon Payments y verifica que todos los cambios han sido guardados.

IPs de notificación de Addon Payments

Si el firewall bloquea las conexiones entrantes, puedes tener problemas al recibir las notificaciones de Addon Payments en tu plataforma de comercio electrónico. Verifica que las siguientes IPs tengan acceso a las URIs de entrega de notificaciones:

Entorno	Servidor	IP
Pruebas	STG-WEST1	35.189.207.233
	STG-WEST3	35.246.248.42
Producción	PRD-WEST1	35.195.204.5
	PRD-WEST3	35.234.68.27

Descargar, instalar o actualizar el módulo

Puedes descargar de forma gratuita la versión actualizada del módulo de Addon Payments en el siguiente enlace. Al hacer clic en el enlace, se iniciará la descarga del módulo. Guarda el archivo en el lugar de tu equipo que selecciones.

Si ya has descargado el módulo, sigue estos pasos:

1. Accede al panel de gestión de tu WordPress.
2. En el menú lateral izquierdo, haz clic en “Plugins” > “Añadir nuevo”.
3. Haz clic en el botón “Subir plugin” situado en la parte superior izquierda.
4. Arrastra el archivo .zip que has descargado o haz clic en el botón “Examinar” y usa el explorador de archivos para subirlo a la plataforma. Aparecerá el nombre de archivo que has seleccionado y se habilitará el botón “Instalar ahora”.
5. Haz clic en el botón “Instalar ahora”. El módulo se subirá a la plataforma de WordPress y se instalará.
6. Tras unos segundos, aparecerá un mensaje informando si el módulo se ha instalado correctamente, o si por el contrario se ha producido algún error. En caso de que se produzca algún error, consulta la sección [ENLACE errores frecuentes WooCommerce].
7. Si el módulo se ha instalado correctamente, pulsa el botón “Activar plugin”. El módulo se activará y aparecerá “Addon Payments” en la lista de métodos de pago de WooCommerce.

Acceder a la configuración

Para acceder a la configuración del módulo sigue estos pasos:

1. Accede al panel de gestión de tu WordPress.
2. En el menú lateral izquierdo, haz clic en “WooCommerce” > “Ajustes”.
3. Pulsa en la pestaña “Pagos” en la parte superior. En el listado de métodos de pago debe aparecer “Addon Payments”.
4. Pulsa en el botón “Finalizar Configuración” situado en la parte derecha para acceder  a la configuración del módulo.

Configurar el módulo

En la página de configuración del módulo se muestran las siguientes opciones:

• Activar/Desactivar: Define si el método de pago Addon Payments está activo. Si está activado se mostrará a los clientes en el proceso de compra. Si está desactivado no se mostrará a los clientes.
• Modo de producción: Define si el módulo va a operar en un entorno de pruebas o un entorno de producción. Cambiar de un entorno a otro puede requiere configurar la “Clave API” y la “Contraseña” propia de cada entorno.
  • Operar en entorno de pruebas: La casilla debe estar marcada.
  • Operar en entorno de producción: La casilla debe estar desmarcada.
• Identificador de comercio: Identificador de tu comercio en Addon Payments. Es facilitado por el soporte en el correo de bienvenida.
  • Tiene entre cinco (5) y seis (6) dígitos numéricos.
  • Es el mismo en el entorno de pruebas y el de producción.
• API Key: Clave API de tu comercio en Addon Payments. Tiene formato UUID. Por ejemplo: “6a18ecb3-bb1e-49cb-b532-264ddc18ed86”.
• Contraseña: Contraseña de tu comercio en Addon Payments. Tiene formato MD5. Por ejemplo: “a9d046669c59606d6fde0694967a23be”. La clave API y la contraseña son diferentes en el entorno de pruebas y en el de producción. Hay que configurarlas según el entorno donde vayas a operar.
  • Las claves (API y contraseña) para el entorno de pruebas llegan en el correo de bienvenida. También puedes recuperarlas y actualizarlas mediante el panel de gestión de pruebas.
  • Las claves (API y contraseña) para el entorno de producción no se envían por correo electrónico. Sólo se pueden recuperar y actualizar mediante el panel de gestión.
• ID de producto: Identificador del producto creado en tu comercio en Addon Payments. Es facilitado en el correo de bienvenida.
  • Tiene entre seis (6) y diez (10) dígitos numéricos.
  • Puede ser diferente entre el entorno de pruebas y de producción.
• Liquidación automática: Puedes elegir entre dos métodos para liquidar los cobros durante el proceso de compra: la liquidación automática (que es la opción predeterminada) o el modo manual. En el modo manual, los cobros autorizados se quedarán en estado “En espera” hasta que des manualmente la orden de liquidar.
• Título: Permite cambiar el nombre del método de pago. Este nombre se mostrará a los clientes en el proceso de compra.

• Logo: Muestra el logotipo del método de pago que visualizan los clientes en el proceso de compra. Puedes modificarlo siguiendo estos pasos:
  1. Pulsa en el botón “Selecciona un fichero”, situado debajo de la URL del logotipo.
  2. Se abrirá el explorador de archivos. Selecciona la nueva imagen.
  3. Pulsa “Seleccionar”. La imagen se mostrará como logotipo.

Los siguientes campos son opcionales. Permiten introducir URLs personalizadas que redirigen a los clientes al finalizar la compra. Al dejarlos en blanco, el módulo redirigirá a una página de la propia plataforma WordPress.

• URL de éxito: Página a la que irá el cliente cuando el pago sea autorizado.
• URL de fallo: Página a la que irá el cliente cuando el pago sea denegado.
• URL de cancelación: Página a la que irá el cliente cuando cancele el proceso de pago.

Al introducir o modificar cualquier valor, pulsa el botón “Guardar los cambios”, situado en la parte inferior izquierda para guardar los cambios en la configuración del módulo.

Opciones relativas a financiación

Sólo aplican si tienes contratado y activado el servicio de pago por financiación Quix de CaixaBank Payments & Consumer (CPC). Estas son las opciones disponibles:

• Tipo de financiación: Permite seleccionar entre los siguientes tipos de financiación:
  • Pago fraccionado (por defecto): Permite a los clientes fraccionar el pago entre 10 y 12 meses.
  • Pago a plazos: Permite a los clientes realizar el pago en tres (3) plazos.
• Posición del banner de financiación: Permite definir la posición del banner en la página de producto.
• Color del banner de financiación: Color que se utilizará para personalizar algunos de los elementos del banner.
• Variación del banner de financiación: Permite seleccionar el tipo de widget a mostrar. Los valores posibles son: “Banner de texto, Texto, Selección, Banner de selección”.
• Marca de estilo del banner de financiación: Quix proporciona este valor. En función de este valor se mostrará una versión del widget u otra. Esto incluye textos legales y componentes visuales distintos. Actualmente no se puede modificar.

Al introducir o modificar cualquier valor, pulsa el botón “Guardar los cambios” situado en la parte inferior derecha para guardar los cambios en la configuración del módulo.

Sección de ayuda

Para acceder a la sección de ayuda del módulo de Addon Payments sigue estos pasos: 

1. Accede a los plugins instalados en WordPress desde el menú de la izquierda.
2. Busca la fila del módulo de Addon Payments.
3. Bajo el nombre se encuentra el enlace “Ayuda”. Haz clic.

Al hacer clic se mostrará la siguiente información: 

• Manual: esta guía de instalación.
• Guías de consulta y gestión de transacciones, así como devoluciones.
• Guías para probar los diferentes métodos de pago.
• Tarjetas para realizar transacciones en entorno de pruebas.