Integra Flow como sistema de pago

Si tienes una página E-commerce desarrollada con OpenCart, puedes integrar Flow mediante las extensiones 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 OpenCart necesitas:

Agregar y 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. Para agregar dicha moneda debes:

  1. Entrar a la administración del portal.
  2. Ir a Sistema > Localización > Monedas.
  3. Hacer clic en "+" para insertar una nueva moneda.
Agregar moneda
Agregar moneda

En dicho formulario debes completar los campos con los siguientes valores:

  1. Agregar Peso Chileno como título.
  2. Agregar CLP como código.
  3. Agregar $ como símbolo a la izquierda.
  4. Dejar símbolo a derecha en blanco.
  5. Agregar 0 como decimales.
  6. Agregar 1.0000 como valor.
  7. Seleccionar el estado como activo.
  8. Hacer clic en "Guardar".
Campos de moneda
Campos de moneda

Finalmente, para configurar el peso chileno como moneda por defecto realiza lo siguiente:

  1. Entrar a la administración de OpenCart.
  2. Ir a Sistema > Configuración.
  3. Seleccionar la tienda que deseas configurar y hacer clic en "Editar".
Configurar moneda
Configurar moneda

En dicho formulario debes completar los campos con los siguientes valores:

  1. Hacer clic en el tab "Local".
  2. Seleccionar Chile como país.
  3. Seleccionar la región donde funcionas.
  4. En Moneda seleccionar "Peso Chileno" como predeterminada.
  5. Seleccionar "Si" en Auto Actualización de moneda (divisas).
  6. Clic en "Grabar".
Campos de configuración
Campos de configuración

Descargar e instalar

Con esta extensión Flow envía la transacción directo a Webpay, sin presentar una página de Flow con los datos de la transacción.

Descargar

Con esta extensión Flow envía la transacción directo a Servipag, sin presentar una página de Flow con los datos de la transacción.

Descargar

Con esta extensión Flow envía la transacción directo a Multicaja, sin presentar una página de Flow con los datos de la transacción.

Descargar

Con esta extensión Flow envía la transacción directo a Onepay, sin presentar una página de Flow con los datos de la transacción.

Descargar

Con esta extensión 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


Instalar mediante instalador de extensiones de Opencart

Para instalar la extensión desde el instalador incorporado en Opencart debes:

  1. Entrar a la administración de OpenCart.
  2. Ir a Extensiones > Instalador de extensiones.
  3. Haz clic en "Upload" para ubicar y seleccionar el archivo de la extensión que deseas instalar (las extensiones instalables de Opencart incluyen ocmod.zip en su nombre de archivo).
  4. Haz clic en "Continuar" para finalizar la instalación.
Instalar extensión
Instalar extensión

Antes de utilizar el instalador de extensiones en Opencart, debes considerar tener configurado el servidor FTP, para lo cual debes:

  1. Entrar a la administración de OpenCart.
  2. Ir a Sistema > Configuración.
  3. Seleccionar la tienda que deseas configurar y hacer clic en "Editar".
  4. Hacer clic en el tab "FTP".
  5. Ingresar datos de host, puerto, usuario, contraseña, el directorio de la instalación de Opencart y activar el FTP.
  6. Hacer clic en "Grabar".
Configurar FTP
Configurar FTP

Además debes tener permisos de escritura para los siguientes directorios:


Copiar los archivos directamente al FTP

Para copiar los archivos directamente al FTP, debes descomprimir el archivo zip y subir las carpetas y archivos contenidos en la carpeta /upload/. Dicho contenido debe ser copiado en las mismas carpetas admin y catalog de tu OpenCart.

Actualizar extensión de Flow

Si ya posees una versión de la extensión de Flow instalada en tu OpenCart y deseas actualizarla, debes reemplazar los archivos antiguos por los archivos actualizados. Para ello basta arrastrar las carpetas admin y catalog, obtenidas al descomprimir la nueva versión de la extensión, en las mismas carpetas de OpenCart. Es importante que todos los archivos sean reemplazados.

Luego, debes configurar la extensión tal como se muestra en el paso Configurar la extensión de Flow.

Habilitación de la extensión OpenCart de Flow

Para habilitar cada extensión sigue las siguientes instrucciones:

  1. En el menú de administración de OpenCart selecciona Extensiones > Extensiones > Filtra por Pagos.
  2. Podrás encontrar las extensiones Flow de los medios de pago.
  3. Instala las extensiones que desees utilizar, haciendo clic en "Instalar".
Instalar módulo Flow
Instalar módulo Flow

Configuración del medio de pago Flow

Para cada extensión de Flow instalada, debes hacer click en "Editar" y 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 de la extensión.
Nombre medio de pago Ingresa el nombre que se mostrará a las personas cuando paguen en tu tienda virtual, por ejemplo:
  • Flow Webpay: Pagar con tarjetas de crédito y débito bancarias.
  • Flow Servipag: Pagar con bancos, tarjetas CMR, Ripley, Cencosud y sucursales Servipag.
  • Flow Multicaja: Pagar en efectivo en locales Multicaja.
  • Flow Onepay: Pagar con tarjetas de crédito.
  • Flow: Pagar mediante Flow a través de Webpay, Servipag, Multicaja, Onepay y más.
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.
Secret Key Ingresa el Secret Key asociado a tu cuenta de Flow:
  • Si estás utilizando la plataforma de producción: Obtén tu Secret Key desde la sección "Mis Datos > Seguridad" en www.flow.cl.
  • Si estás utilizando la plataforma sandbox: Obtén tu Secret Key desde la sección "Mis Datos > Seguridad" en sandbox.flow.cl.
Url de retorno Sólo aplica a la extensión de Servipag, Multicaja y Pasarela Flow. 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.
Estado de pago exitoso Selecciona "Processed".
Estado de pago Fallido Selecciona "Failed".
Zona geográfica Selecciona "Todas las zonas".
Estado Selecciona "Habilitado".
Orden Corresponde al orden en que se mostrarán los medios de pago. Puedes utilizar el valor que desees.
Clic en "Guardar" Debes hacer clic en "Guardar" 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 de la extensión. Estas opciones requieren cierto nivel de conocimiento sobre HTML y programación.


Agregar imagen al medio de pago

Para agregar una imagen personalizada al medio de pago, debes seguir las siguientes instrucciones:

  1. Abrir los siguientes archivos:
    • catalog/model/extension/payment/flow_Webpay.php para Flow Webpay.
    • catalog/model/extension/payment/flow_servipag.php para Flow Servipag.
    • catalog/model/extension/payment/flow_multicaja.php para Flow Multicaja.
    • catalog/model/extension/payment/flow_Onepay.php para Flow Onepay.
    • catalog/model/extension/payment/flow.php para pasarela de Flow.
  2. Añadir el link de la imagen deseada en la línea 9:
    • 'title'=> '<img src="https://www.flow.cl/img/logos/webpay.png" style="vertical-align:middle; width: 100px;" /> '.$this->language->get('text_title'),
    • 'title'=> '<img src="https://www.flow.cl/img/logos/servipag.png" style="vertical-align:middle; width: 100px;" /> '.$this->language->get('text_title'),
    • 'title'=> '<img src="https://www.flow.cl/img/logos/multicaja.png" style="vertical-align:middle; width: 100px;" /> '.$this->language->get('text_title'),
    • 'title'=> '<img src="https://www.flow.cl/img/logos/onepay.png" style="vertical-align:middle; width: 100px;" /> '.$this->language->get('text_title'),
    • 'title'=> '<img src="https://www.flow.cl/img/logos/flow.png" style="vertical-align:middle; width: 100px;" /> '.$this->language->get('text_title'),
  3. El valor del atributo src permite insertar la URL de la imagen deseada, mientras que el valor del atributo width permite ajustar el ancho de la imagen.
  4. Finalmente, se deben guardar los cambios y revisar que la imagen se muestre correctamente.
Vista opciones Avanzadas
Vista opciones avanzadas

Tengo un error de integración

Para conocer el error de integración debes acceder al archivo de log disponible en tu FTP. Este archivo se encuentra disponible en las siguientes carpetas:

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.