VibeFox Flow for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo.
PHP: 8.0 o posterior.
Moneda de la tienda: peso chileno (CLP) o dólar estadounidense (USD). Para otras monedas, el método de pago se oculta en la finalización de compra. En tiendas con CLP, establece WooCommerce > Settings > General > Number of decimals en 0, porque Flow cobra pesos enteros.
Cuenta de Flow: necesitas la API Key y la Secret Key de tu cuenta de Flow, en Mis datos, Datos técnicos de Flow. Para pruebas, crea una cuenta de sandbox independiente en sandbox.flow.cl y usa sus claves. Las claves de sandbox y de producción son diferentes. No necesitas configurar nada en la cuenta de Flow.
Sitio web público: las URL de confirmación, retorno y reembolso de tu tienda deben ser accesibles desde Internet, sin modo de mantenimiento, protección por contraseña ni un cortafuegos que bloquee Flow.
Clave de licencia de VibeFox: comprada en vibefox.net. Una clave funciona en un dominio.
Instalación
1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta wcp_flow_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > Flow.cl > Manage, o haz clic en Settings bajo el nombre del plugin en la página de plugins.
4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.
5. Introduce la API Key y la Secret Key de sandbox, activa Enable / Disable, guarda y realiza un pedido de prueba.
6. Para aceptar pagos reales, introduce las claves de producción y desmarca Sandbox mode.
Configuración
Todos los ajustes están en una página: WooCommerce > Settings > Payments > Flow.cl. Encima de los campos, la página te avisa si las claves del modo actual están vacías (Flow se oculta entonces en la finalización de compra), si la moneda de la tienda no es compatible y si una tienda con CLP usa decimales (Flow cobra pesos enteros, por lo que debes establecer Number of decimals en 0 para que precios, totales y reembolsos coincidan exactamente). En modo sandbox muestra Sandbox mode: los pagos van a sandbox.flow.cl y no se cobra dinero real. En la lista de métodos de pago, Flow aparece como pendiente de configuración hasta que el modo actual tenga claves, y muestra una insignia de modo de prueba en sandbox.
General
Enable / Disable: Enable Flow.cl payments activa o desactiva el método de pago. Predeterminado: desactivado.
Title: el nombre del método de pago que el cliente ve en la finalización de compra. Predeterminado: Flow.
Description: el texto mostrado bajo el método de pago en la finalización de compra. Predeterminado: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.
Credenciales de la API de Flow
Copia la API Key y la Secret Key de tu cuenta de Flow (Mis datos, Datos técnicos): claves de producción en www.flow.cl, claves de sandbox en sandbox.flow.cl (una cuenta de sandbox independiente).
Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys. En modo sandbox no se cobra dinero real. Predeterminado: activado. Desactívalo e introduce las claves de producción para aceptar pagos reales. Los reembolsos siempre usan el entorno en el que se pagó el pedido.
Sandbox API Key: la API Key de tu cuenta de sandbox.flow.cl.
Sandbox Secret Key: la Secret Key de tu cuenta de sandbox.flow.cl. Se usa para firmar cada solicitud.
Live API Key: la API Key de tu cuenta de www.flow.cl.
Live Secret Key: la Secret Key de tu cuenta de www.flow.cl. Mantenla en secreto.
Notificaciones
El plugin envía tres URL a Flow con cada pago y reembolso, por lo que no necesitas configurar nada en la cuenta de Flow. La sección las enumera:
La confirmación solo contiene un token de pago. El plugin consulta después el estado del pago a Flow con una solicitud firmada en el entorno en el que se creó el pago y aplica únicamente la respuesta de Flow. Se rechaza cualquier pago que esta tienda no haya creado para el pedido. Sin confirmación, el pedido se actualiza cuando el cliente vuelve de Flow.
Avanzado
Debug log: Log API calls and notifications en WooCommerce > Status > Logs, fuente wcp_flow_gateway, sin claves ni datos de clientes. Los errores siempre se registran. Predeterminado: desactivado.
Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept). Predeterminado: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Flow) y realiza el pedido. En modo sandbox, la finalización de compra muestra SANDBOX MODE: los pagos van al sandbox de Flow. No hay cargos reales. Se requiere un correo electrónico de facturación válido. El plugin crea un pago de Flow por el total del pedido en su moneda, con el asunto Order # seguido del número de pedido y el nombre del sitio, y envía al cliente a la página de pago de Flow. Allí el cliente elige un método de pago habilitado en tu cuenta de Flow.
Tras pagar, el cliente vuelve a tu tienda. El pedido solo se marca como pagado cuando Flow lo confirma: mediante la confirmación o una solicitud de estado firmada al volver el cliente. Un pedido pagado, o un cupón de efectivo pendiente de pago, lleva a la página de pedido recibido.
Si se rechaza el pago, el cliente vuelve a la página Pay for order (o a la finalización de compra) con Your Flow payment was rejected. Please try again or choose another payment method. Si el cliente sale de la página de Flow sin pagar, el mensaje es The Flow payment was not completed. You can try again or choose another payment method. Si no se puede comprobar el resultado, el mensaje es We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. Cada nuevo intento crea un nuevo pago de Flow vinculado al pedido.
Si Flow no puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo Could not connect to Flow. Please try again in a moment. Los detalles están en el registro.
El método de pago funciona en la finalización de compra clásica, en el bloque de Finalizar compra y en la página Pay for order. Es compatible con WooCommerce High-Performance Order Storage (HPOS). Los textos para los clientes están traducidos al español (Chile y España).
El plugin solo acepta pagos únicos. No tiene tarjetas guardadas, suscripciones, cargos recurrentes ni enlaces de pago, y no preselecciona un método de pago de Flow. Flow no puede cancelar un enlace de pago ya creado: si un cliente paga un enlace antiguo después de pagar uno más reciente, se añade al pedido una nota que te pide reembolsar el duplicado en Flow.
Pedidos y reembolsos
Estados del pedido
Pending payment: el cliente ha sido enviado a Flow y todavía no ha pagado. La nota del pedido muestra el importe y el número de pedido de Flow del intento.
On hold, awaiting coupon payment: el cliente ha generado un cupón de pago de Servipag o Multicaja. El pedido cambia cuando Flow confirma el pago.
Processing: Flow ha comunicado que el pago se ha realizado y el importe y la moneda coinciden (los pedidos con solo productos virtuales descargables pasan a Completado, el comportamiento predeterminado de WooCommerce). La nota del pedido muestra el importe y el número de pedido de Flow. El ID de transacción del pedido es el número de pedido de Flow.
On hold, amount/currency mismatch: Flow ha comunicado un importe o una moneda distintos de los del pedido. El pedido no se ha marcado como pagado; compruébalo manualmente.
On hold, payment for a cancelled order: ha llegado un pago para un pedido cancelado sin haber sido pagado. Comprueba el pedido y envíalo o reembolsa el pago en Flow.
Failed: Flow ha rechazado el último intento de pago de un pedido sin pagar. El cliente puede volver a intentarlo.
Cancelled: el último intento de pago se ha anulado en Flow.
Si llega otro pago para un pedido ya pagado, el pedido no cambia. Una nota te pide reembolsar el duplicado en tu cuenta de Flow. Nunca se reabre un pedido pagado y después cancelado o reembolsado.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Flow. Se admiten reembolsos totales y parciales. El reembolso se envía al entorno en el que se pagó el pedido (sandbox o producción), por lo que deben estar configuradas las claves de ese entorno y el pedido necesita un correo electrónico de facturación. Flow envía un correo al cliente para completar el reembolso. Si Flow rechaza el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Una solicitud correcta se añade a las notas del pedido con el número y el estado del reembolso de Flow.
Los cambios posteriores de estado del reembolso comunicados por Flow se añaden a las notas del pedido. Si Flow rechaza o cancela después un reembolso, la nota indica que el dinero no se devolvió al cliente; se conserva el registro del reembolso de WooCommerce, por lo que debes gestionarlo manualmente. Los reembolsos creados en el panel de Flow no se importan a WooCommerce.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Flow.cl. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que está activa la licencia y tu dominio. Usa Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.
Una clave funciona en un dominio. Quitar la clave de un sitio no libera su espacio de dominio. Libera el espacio en tu cuenta de vibefox.net.
Sin una clave activa, Flow no se muestra a los clientes en la finalización de compra. Si aun así se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Los gestores de la tienda que hayan iniciado sesión siguen viendo el método de pago, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. Aparece un recordatorio en la página de plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados siguen confirmándose y los reembolsos funcionan.
Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Flow no aparece en la finalización de compra: comprueba que la licencia esté activa, Enable / Disable esté activado, las claves del modo actual estén introducidas (claves de sandbox en modo sandbox y de producción en modo de producción) y la moneda de la tienda sea CLP o USD. En la página Pay for order se comprueba la moneda del pedido.
El pago se ha realizado, pero el pedido sigue en Pending payment: la confirmación de Flow no llega a tu tienda y el cliente no ha vuelto. Comprueba que la URL de confirmación mostrada en los ajustes sea accesible desde Internet y no esté bloqueada por el modo de mantenimiento, protección por contraseña o un cortafuegos. Activa Debug log y consulta WooCommerce > Status > Logs, fuente wcp_flow_gateway.
La confirmación responde Payment does not belong to the order o Unknown order: el pago no fue creado por esta tienda para este pedido, o se creó en otro entorno. El pedido no cambia.
La confirmación responde Gateway not configured: las claves del entorno del pago están vacías. Introdúcelas de nuevo.
La confirmación responde Flow API unavailable: ha fallado la solicitud de estado a Flow. Flow vuelve a intentar la confirmación.
El cliente ve Flow payments are not available at the moment: faltan las claves o Flow las ha rechazado. Comprueba la API Key y la Secret Key del modo actual.
El cliente ve A valid billing email is required for Flow payments: Flow necesita el correo electrónico del cliente.
El cliente ha pagado, pero el pedido está On hold: lee la nota del pedido. El cliente ha generado un cupón de efectivo aún sin pagar, o el importe o la moneda comunicados por Flow no coinciden con el pedido. Los totales en CLP con decimales se redondean a pesos enteros, por lo que debes establecer Number of decimals en 0.
El reembolso falla con un mensaje sobre las claves de sandbox o de producción: el pedido se pagó en ese entorno y sus claves están vacías. Introdúcelas y vuelve a intentarlo.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera un espacio en tu cuenta de vibefox.net y haz clic en Check now. Si la dirección del sitio ha cambiado, haz clic en Check now para activar la clave para el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Para desarrolladores, el archivo readme enumera el filtro wc_flw_supported_currencies (monedas para las que se ofrece la pasarela).
Desinstalación
Al desactivar el plugin se conservan todos los datos. Para quitarlo, desactívalo y elimínalo en la página Plugins. La clave y el estado de licencia de este plugin siempre se eliminan. Los ajustes de la pasarela y los registros solo se eliminan si Delete data on uninstall estaba activado. En caso contrario se conservan para una reinstalación posterior. Los datos de Flow guardados en los pedidos siempre se conservan. Los pedidos existentes conservan sus notas de pago e ID de transacción.
Flow es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Flow ni cuenta con su respaldo.