Saltar al contenido principal

Guía de integración para WHMCS

Si tienes una página e-commerce desarrollada con WHMCS, 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 plataforma WHMCS 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.
  • WHMCS versión 7.
  • Verificar que tu plataforma esté visible desde internet.

Configurar pesos chilenos como moneda​

Para asegurarte que los pagos sean correctamente informados por Flow a tu plataforma, es importante que se utilice el peso chileno como moneda. Para agregar dicha moneda debes:

  1. Ingresar a la administración de WHMCS.
  2. Ir a Ajustes > Formas de pago > Monedas.
  3. Haz clic en la opción Editar de la moneda por defecto o añade una moneda adicional.

whmcs48cdfa5ab497a666037c4fdeed86f45e.png

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

  1. Ingresar en Código de moneda CLP (Peso chileno).
  2. Ingresar en Prefijo $.
  3. Ingresar en Sufijo CLP.
  4. Selecciona en Formato 1.234,56.
  5. Ingresar en Cambio 1.00000.
  6. Hacer clic en Guardar los cambios.

whmcs2ce59cfc600c1542d0fc44934340c0f47.png

Descargar e instalar​

  • Módulo Flow Webpay: Con este módulo Flow envía la transacción directo a Webpay, sin presentar una página de Flow con los datos de la transacción.
  • Módulo Flow Servipag: Con este módulo Flow envía la transacción directo a Servipag, sin presentar una página de Flow con los datos de la transacción.
  • Módulo Flow Multicaja: Con este módulo Flow envía la transacción directo a Multicaja, sin presentar una página de Flow con los datos de la transacción.
  • Módulo Flow Onepay: Con este módulo Flow envía la transacción directo a Onepay, sin presentar una página de Flow con los datos de la transacción.
  • Módulo Pasarela Flow: 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.

Copiar los archivos directamente al FTP​

Para copiar los archivos directamente al FTP, debes descomprimir el archivo zip y subir las carpetas Modules y Templates en la carpeta raíz de tu plataforma WHMCS.

Actualizar extensión de Flow​

Si ya posees una versión del módulo de Flow instalada en tu plataforma WHMCS y deseas actualizarla, debes reemplazar los archivos antiguos por los archivos actualizados.

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 WHMCS de Flow​

Para habilitar cada módulo sigue las siguientes instrucciones:

  1. Ir a Ajustes > Formas de pago > Pasarela de pago.
  2. Hacer clic en la pestaña All Payment Gateways.
  3. En dicha ventana, podrás encontrar los módulos de Flow que has agregado.
  4. A continuación, debes activar los módulos que desees utilizar, haciendo clic sobre él. Los módulos activos se diferencian por el color verde de la caja

whmcs3ee4bb25150471f6b275e9b6d212d240c.png

Configuración del medio de pago Flow​

Para configurar los módulos de Flow instalados sigue las siguientes instrucciones:

  1. Ir a Ajustes > Formas de pago > Pasarela de pago.
  2. Hacer clic en la pestaña Manage Existing Gateways.
  3. Para continuar, ubicar el medio de pago que desees configurar.

En dicha ventana, debes configurar los siguientes campos:

whmcs4f9dbd5b38470b4ad12e92ff913ea9c9d.png

Realizar pruebas en plataforma sandbox​

Para utilizar la plataforma sandbox debes:

  • Registrarte previamente en sandbox.flow.cl.
  • Configurar el plugin utilizando la plataforma sandbox. Para ello debes revisar el punto anterior.
  • Finalmente, podrás simular un pago mediante Webpay Plus con las siguientes tarjetas de prueba. Recuerda que el monto mínimo a pagar son $350 CLP.
  • Una vez concretadas las pruebas, debes configurar el plugin utilizando la plataforma de producción. Para ello debes revisar el punto anterior.

Pago exitoso​

Nº de tarjetas: 4051885600446623

Fecha de expiración: cualquiera

CVV: 123

En la simulación del banco debes usar:

RUT: 11.111.111-1

Clave: 123

Pago rechazado​

Nº de tarjetas: 5186059559590568

Fecha de expiración: cualquiera

CVV: 123

En la simulación del banco debes usar:

RUT: 11.111.111-1

Clave: 123

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.

Tengo un error de integración​

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

  1. Ir a Utilidades > Registros > Registro de actividad.
  2. 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.

whmcs6e3bff9e6d7dc058c10dc891c4a789ef7.png