Saltar al contenido principal

Integración Flow con VTEX

Si tu tienda está desarrollada en VTEX, puedes integrar Flow como medio de pago y comenzar a recibir pagos online.

¿Aún no tienes cuenta en 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 previos​

Para integrar Flow en tu tienda VTEX necesitas:

  • Estar registrado en Flow como vendedor (con acceso a API Key y Secret Key).
  • Tener una cuenta en VTEX con permisos de Admin (Payments).
  • Que tu tienda esté activa y visible en internet (URLs públicas).
  • Moneda de la tienda configurada en CLP (si contrataste Flow en CLP).
  • Acceso al Portal Gateway de Flow: https://gateway.flow.cl/account (obligatorio para gestionar la integración).

Importante: El Portal Gateway es donde obtendrás las credenciales que usarás para vincular VTEX con Flow.

Llaves secretas de Flow (API Key y Secret Key)​

Si no recuerdas tus credenciales, Accede a este enlace

Ahí podrás ver

  • API Key → clave pública de integración asignada a tu comercio.
  • Secret Key → clave privada para firmar la cadena enviada a flow(guárdala de forma segura).

Configuración en el Portal Gateway de Flow​

  1. Ingresa a https://gateway.flow.cl/account con tus credenciales de Flow.
  2. Ubica el formulario de credenciales, se deben rellenar en la siguiente sección:



  1. Ingresa tu API Key y Secret Key → clic en Probar Integración.
    • Si es correcto, aparecerá: “La Integración fue Exitosa”.
    • Si no, debes revisar tus credenciales, ya que podría existir un error en el copiar las llaves desde tu cuenta de flow (Ingresa aquí para ver tus llaves) o también recomendamos revisar el punto.
  2. Una vez que el mensaje diga que la integración fue exitosa se debe dar click a guardar.
  3. En el menú lateral, selecciona VTEX.
  4. Copia los valores:
    • Clave de aplicación (App Key)
    • Token de aplicación (App Token) Estos parámetros los usarás en la configuración de VTEX.

Verificar moneda en VTEX​

La divisa de tu tienda en VTEX debe coincidir con la contratada en Flow.

  • Ingresa al VTEX Admin.
  • Menú → Configuración de la tienda → Canales → Políticas comerciales.
  • Confirma que la moneda sea Chile – Peso Chileno (CLP).

Configuración de Flow en VTEX​

Paso 1: Configurar proveedor Flow en VTEX​

Ruta: Configuración de la tienda → Pagos → Proveedores
(en inglés: Payments → Settings → Payment Methods (Gateways/Providers))

  1. Ingresa al VTEX Admin.
  2. Ve a Pagos → Proveedores y busca "Flow".
  3. Haz clic en Flow. Se abrirá una nueva ventana con el formulario de configuración.
  4. Completa los campos con la información del Portal Gateway:
    • Autorización del proveedor
    • Clave de aplicación (App Key)
    • Token de aplicación (App Token)
    • Opciones:
      • Activar modo de prueba: No habilitado.
      • Liquidación automática: elige según tu política de captura/liquidación.
  5. Guarda los cambios.

Paso 2: Configurar condición de pago Flow en VTEX​

Ruta: Configuración de la tienda → Pagos → Configuración
(Payments → Settings → Payment Conditions)

  1. Ingresa al VTEX Admin.
  2. Haz clic en + Nuevo.
  3. En la lista de categorías, baja hasta Otros (Others).
  4. Selecciona Flow Pagos.
  5. Configura:
    • Nombre interno: “Flow” o “Flow Pagos”.
    • Proveedor asociado: selecciona Flow (el proveedor configurado en el Paso 1).
    • Activar condición de pago: habilita el switch.
  6. Guarda los cambios.

Validar la integración​

  1. En VTEX Admin ve a: Configuración de la tienda → Pagos → Configuración.
  2. Verifica que Flow aparezca en la lista de medios de pago activos.
  3. Realiza una compra de prueba para confirmar el flujo.

Flujo de pago (alto nivel)​

  1. El comprador selecciona Flow en el checkout de VTEX.
  2. VTEX crea la transacción y redirige/invoca el Create Payment en Flow.
  3. El cliente paga en la pasarela de Flow.
  4. Flow:
    • Redirige al comprador a la URL de confirmación con el resultado.
    • Envía una notificación firmada (callback) a la tienda VTEX.
  5. VTEX confirma el estado y actualiza la orden.

Preguntas Frecuentes (FAQ)​

1. ¿Qué hago si Flow no aparece en la lista de proveedores de VTEX?​

Verifica que tu cuenta de VTEX tenga habilitados los permisos de Admin (Payments). Si aún no aparece, abre un ticket con el soporte de VTEX para que activen el proveedor Flow en tu cuenta.

2. ¿Qué pasa si la integración de credenciales falla en el Portal Gateway?​

Asegúrate de copiar la API Key y Secret Key completas, sin espacios adicionales.
Revisa que estés usando las credenciales vigentes desde el Dashboard de Flow.
Si el error persiste, genera nuevas llaves desde el portal de Flow.

3. ¿Puedo usar Flow en modo prueba antes de salir a producción?​

Por el momento no se encuentra disponible el modo de prueba, se encuentra en proceso de desarrollo.

4. ¿Qué medios de pago estarán disponibles en Flow dentro de VTEX?​

Los medios de pago dependen de los que tengas contratados en tu cuenta Flow (ejemplo: tarjetas crédito/débito, Servipag, Onepay, transferencias, etc.).

Solo se mostrarán en VTEX los que estén activos en tu contrato con Flow.

5. ¿Qué hago si el cliente paga, pero la orden no cambia de estado en VTEX?​

Te recomendamos que te comuniques directamente con soporte@flow.cl para que podamos revisar la razón del no cambio de estado de la orden.

6. ¿Puedo vender en otra moneda distinta de CLP?​

Sí, es posible, pero dependerá de los medios de pago que tengas contratados en tu cuenta Flow.

En caso de que el comprador use una tarjeta extranjera, la conversión se realizará en base a la moneda enviada al momento de generar la orden, aplicando el tipo de cambio y comisiones definidas por el banco o emisor de la tarjeta.

  • Posibles Fallas envió incorrecto de Divisa.

    • Si tu tienda envía un pago en una moneda que no está habilitada en tu contrato de flow, el sistema retornará un error de validación y el pago podría no ser procesado. Esto aplicara siempre que se mande una moneda diferente a las contratadas en tu cuenta de flow.