Guía de integración para PrestaShop
Si tienes una página e-commerce desarrollada con Prestashop 1.6, 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 tienes una cuenta regístrate aquí.
Requisitos
Para integrar Flow a tu sitio de E-commerce basado en Prestashop necesitas:
- Estar registrado en Flow como vendedor.
- Obtener el ApiKey y Secret Key desde la sección Integraciones > Integración por API de tu cuenta Flow.
- Prestashop versión 1.6.
- Verificar que tu tienda esté visible desde internet.
Configurar pesos chilenos como moneda
Para asegurarte que los pagos sean correctamente informados por Flow a tu sitio de E-commerce, es importante que se utilice el peso chileno como moneda.
Si has definido la locación en Chile y has importado la configuración, PrestaShop configurará esto de forma automática. Para estar seguro de ello te recomendamos realizar las siguientes verificaciones:
- Ingresar a la administración de Prestashop.
- Ir a Localización > Monedas.
- Hacer clic en Editar del registro Peso CLP.
En la edición de la moneda debes:
- Marcar campo Decimales con la opción No.
- Hacer clic en Guardar.
En forma adicional debes verificar el valor seleccionado para los siguientes campos:
- Ir a Preferencias > Configuración.
- Seleccionar en el campo Modo de redondeo la opción Redondeo al alza, cuando se ha pasado la mitad (recomendado).
- Seleccionar en el campo Tipo de redondeo la opción Redondea en el total.
- Ingresar en el campo Número de decimales un 0 (cero decimales).
- Hacer clic en Guardar.
Descargar e instalar
Con este módulo antes de enviar la transacción a un medio de pago, se presenta una página de Flow con los datos de la transacción. Además, en dicha página se muestran los medios de pago habilitados por el vendedor, permitiendo al pagador elegir el deseado.
Descargar el módulo Pasarela Flow.
Instalar mediante instalador de módulos de Prestashop
Para instalar el módulo desde el instalador incorporado en Prestashop debes:
- Entrar a la administración de Prestashop.
- Ir a Módulos y servicios > Módulos y servicios.
- Hacer clic en Añadir nuevo módulo.
En la ventana desplegada debes:
- Seleccionar el archivo con la extensión .zip del módulo de Flow descargado.
- Haz clic en Subir este módulo.
- La instalación exitosa desplegará el mensaje El módulo se ha descargado correctamente.
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:
- Carpetas: 755
- Archivos: 644
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:
- Instalar el módulo mediante el instalador de módulos de Prestashop.
- 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.
Habilitación del módulo Prestashop de Flow
Para habilitar cada módulo debes realizar los siguientes pasos:
- Ir a Módulos y servicios > Módulos y servicios.
- Haz clic en Instalar para habilitar el módulo.
En el mensaje de advertencia haz clic en Seguir con la instalación.
Configuración del medio de pago Flow
Para configurar los módulos de Flow instalados debes realizar los siguientes pasos:
- Ir a Módulos y servicios > Módulos y servicios.
- 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).
- Haz clic en Configurar en el módulo activo.
En dicha ventana, debes configurar los siguientes campos:
| Campo | Descripción |
|---|---|
| Plataforma flow | Selecciona si utilizarás la plataforma de producción o la plataforma sandbox de Flow: |
| Nombre del medio de pago | Ingresa el nombre que se mostrará a las personas cuando paguen en tu tienda virtual (dependiendo los medios de pago disponibles en el país donde operas), por ejemplo: |
| Api Key | Ingresa el Api Key asociado a tu cuenta de Flow: |
| Secret Key | Ingresa el Secret Key asociado a tu cuenta de Flow: |
| Cobro adicional (en %) | Corresponde a un cobro adicional que puedes agregar al total del pedido. Este cobro adicional se define en porcentaje. |
| 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. |
| 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. |
| Click 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:
- Registrarte previamente en sandbox.flow.cl.
- Configurar el módulo utilizando la plataforma sandbox. Para ello debes revisar el punto anterior.
- Una vez concretadas las pruebas, debes configurar el módulo utilizando la plataforma de producción. Para ello debes revisar el punto anterior.
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 |
Tarjeta de prueba para México
Podrás simular un pago de Perú con la siguiente tarjeta de prueba. Recuerda que el monto mínimo a pagar son MXP $ 12.00.
| Dato | Valor |
|---|---|
| N° Tarjeta de Crédito | |
| 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:
- Entrar a la administración de Prestashop.
- Ir al menú Parámetros avanzados > Registros / Logs.
- 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.
