Integra Flow como sistema de pago

Si tienes una página E-commerce desarrollada con Prestashop, puedes integrar Flow mediante los módulos y comenzar a operar con pagos online.

¿No eres parte de Flow?

Antes de continuar, debes registrarte en Flow y seleccionar la opción "Quiero recibir pagos a través de Flow". Si aún no estas registrado puedes hacerlo aquí:

Regístrate

Requisitos

Para integrar Flow a tu sitio de E-commerce basado en Prestashop necesitas:

Configuración de moneda de pago

Para asegurarte que los pagos sean correctamente informados por Flow a tu sitio de E-commerce, es importante que tengas correctamente configurada la moneda de pago con la contratada en la plataforma de Flow.

Para verificar la configuración de la moneda:

  1. Ingresar a la administración de Prestashop.
  2. Ir a Internacional > Localización.
  3. Hacer clic en la pestaña "Monedas" y verificar la configuración.

Descargar e instalar

A continuación encontrarás las instrucciones para descargar e instalar Flow en tu carro de compras.


Descargar el módulo "Pasarela Flow"


Con este único módulo tu cliente podrá acceder a todos los medios de pago que tengas activados en tu cuenta Flow, sin requerir instalaciones adicionales:

Descargar



Instalar mediante instalador de módulos de Prestashop


Para instalar el módulo desde el instalador incorporado en Prestashop debes:

  1. Entrar a la administración de Prestashop.
  2. Ir a Módulos > Catálogo de Módulos.
  3. Haz clic en "Instalar módulo".
Añadir módulo
Añadir módulo

En la ventana desplegada debes:

  1. Seleccionar el archivo con la extensión .zip del módulo de Flow descargado.
  2. Arrastra el archivo o haz clic en "Selecciona archivo".
  3. La instalación exitosa desplegará el mensaje "Módulo instalado".
Añadir módulo
Añadir módulo

Copiar los archivos directamente al FTP


Para copiar los archivos directamente al FTP, debes descomprimir el archivo zip y subir las carpetas en la carpeta /modules/ de la instalación de Prestashop.

Sugerimos revisar los permisos de las carpetas y archivos una vez subidos al FTP, estos deben ser:

Actualizar módulo de Flow

Si ya posees una versión del módulo de Flow instalada en tu Prestashop y deseas actualizarla, debes reemplazar los archivos antiguos por los archivos actualizados. Para ello tienes 2 opciones:

  1. Instalar el módulo mediante el instalador de módulos de Prestashop.
  2. Copiar los archivos directamente al FTP.

En los puntos anteriores "Instalar mediante instalador de módulos de Prestashop" y "Copiar los archivos directamente al FTP" puedes conocer el procedimiento para ambas opciones de actualización.

Luego, debes configurar el módulo tal como se muestra en el paso "Configuración del medio de pago Flow".

Configuración del medio de pago Flow

Para configurar los módulos de Flow instalados debes realizar los siguientes pasos:

  1. Ir a Módulos > Gestor de módulos.
  2. Ubica el módulo de Flow que deseas configurar (sugerimos que en el campo de búsqueda escribas "Flow" para llegar más rápido al resultado).
  3. Haz clic en "Configurar" en el módulo.
Configurar módulo Flow
Configurar módulo Flow

En dicha ventana, debes configurar los siguientes campos:

Configurar forma de pago
Configurar forma de pago
Campo Descripción
Plataforma de Flow Selecciona si utilizarás la plataforma de producción o la plataforma sandbox de Flow:
  • Plataforma de producción: Se encuentra disponible en www.flow.cl y corresponde al sitio oficial, el cual debes utilizar para recibir tus pagos.
  • Plataforma sandbox: Se encuentra disponible en sandbox.flow.cl y corresponde al sitio de pruebas, donde podrás realizar pagos de test para verificar el correcto funcionamiento del módulo.
Nombre del medio de pago Ingresa el nombre que se mostrará a las personas cuando paguen en tu tienda virtual, por ejemplo:
  • Flow: Pagar mediante Flow a través de Webpay, Servipag, Multicaja, Onepay y más.
Llave de integración seguridad (Api Key) Ingresa el Api Key asociado a tu cuenta de Flow:
  • Si estás utilizando la plataforma de producción: Obtén tu Api Key desde la sección "Mis Datos > Seguridad" en www.flow.cl.
  • Si estás utilizando la plataforma sandbox: Obtén tu Api Key desde la sección "Mis Datos > Seguridad" en sandbox.flow.cl.
Cobro adicional (en %) Corresponde a un cobro adicional que puedes agregar al total del pedido. Este cobro adicional se define en número de porcentaje.
Logo a mostrar Si deseas modificar la imagen que por defecto se mostrará cuando un cliente pague en tu tienda virtual, puedes seleccionar una nueva haciendo clic en "Seleccionar archivo". Una vez que guardes los cambios, se habrá actualizado la imagen.
Url de retorno Corresponde a la página donde volverá el cliente una vez que generó un cupón de pago. Recomendamos que dicha url sea la página principal de tu tienda.
Clic en "Guardar los cambios" Debes hacer clic en "Guardar los cambios" para confirmar tu configuración.

Realizar pruebas en plataforma sandbox

Para utilizar la plataforma sandbox debes:


Tarjeta de prueba para Chile


Podrás simular un pago de Chile mediante Webpay Plus con las siguientes tarjetas de prueba. Recuerda que el monto mínimo a pagar son $350 CLP.


Pago exitoso


Dato Valor
N° Tarjeta de Crédito 4051885600446623
Año de Expiración Cualquiera
Mes de Expiración Cualquiera
CVV 123
En la simulación del banco usar:
Rut 11.111.111-1
Clave 123

Pago rechazado


Dato Valor
N° Tarjeta de Crédito 5186059559590568
Año de Expiración Cualquiera
Mes de Expiración Cualquiera
CVV 123
En la simulación del banco usar:
Rut 11.111.111-1
Clave 123

Tarjeta de prueba para Perú


Podrás simular un pago de Perú con la siguiente tarjeta de prueba. Recuerda que el monto mínimo a pagar son 2 Soles.



Dato Valor
N° Tarjeta de Crédito 5293138086430769
Año de Expiración Cualquiera
Mes de Expiración Cualquiera
CVV Cualquiera

Opciones avanzadas

A continuación, se muestran opciones adicionales para personalizar la configuración del módulo. Estas opciones requieren cierto nivel de conocimiento sobre HTML y programación.


Tengo un error de integración


Para conocer el error de integración debes revisar el archivo de log disponible en tu Prestashop. Para ubicar este registro debes:

  1. Entrar a la administración de Prestashop.
  2. Ir al menú Parámetros avanzados > Registros / Logs.
  3. Ubica el registro de la orden que deseas revisar.

Si no conoces como solucionar el problema de integración, puedes contactarnos al correo soporte@flow.cl, indicándonos el error, la plataforma de Flow que estás utilizando y tu Api Key.

Log Prestashop
Log Prestashop

Se pierde la sesión del pagador


Si al finalizar el flujo del pago se pierde la sesión iniciada del pagador en tu portal desarrollado con Prestashop 1.7.8.X, debes configurar el siguiente dato en tu tienda:

  1. Entrar a la administración de Prestashop.
  2. Ir al menú Parámetros avanzados > Administración.
  3. Ubica el título Configuración.
  4. En la opción Cookie SameSite debes seleccionar Ninguno.
  5. Haz click en Guardar.
Configuración cookie
Configuración cookie

Permisos de carpetas y archivos de módulos Flow en el FTP


En caso de error de integración se sugiere revisar los permisos de todas las carpetas y archivos de los módulos de Flow en su servidor FTP. Siendo los siguientes los permisos recomendados:

Las carpetas y archivos de los módulos de Flow los encontrarás en la carpeta /modules/, en la raíz de la instalación de Prestashop.

Como ejemplo para un módulo de Flow los permisos serían los siguientes:

Permisos carpetas módulos Prestashop
Permisos carpetas módulos Prestashop
Permisos carpetas y archivos módulos Prestashop
Permisos carpetas y archivos módulos Prestashop