VibeFox ifthenpay for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Moneda: solo euro (EUR). El método de pago se oculta cuando la moneda de la tienda o del pedido no es EUR. ifthenpay acepta totales de 0,01 a 99.999,99 EUR.
Cuenta de ifthenpay: regístrate en ifthenpay.com. Necesitas la clave del método que ofreces: Multibanco, MB WAY o Credit Card (formato ABC-123456). Las claves se muestran en el backoffice de ifthenpay (backoffice.ifthenpay.com) o las envía ifthenpay cuando se activa el método en tu cuenta. ifthenpay también debe activar el callback para tu clave (ver Configuración), y tu tienda debe ser accesible desde internet.
Clave de licencia de VibeFox: se compra 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_ifthenpay_gateway a /wp-content/plugins/ por FTP.
2. Haz clic en Activate. El plugin genera su clave anti-phishing.
3. Abre la configuración: WooCommerce > Settings > Payments > ifthenpay > Manage, o haz clic en Settings debajo del nombre del plugin en la página 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. Elige el Payment Method e introduce su clave de ifthenpay. Guarda los cambios para que la Callback URL coincida con el método elegido.
6. Copia la Anti-phishing Key y la Callback URL que aparecen en la configuración y pide a ifthenpay que active el callback para tu clave (en el backoffice o a través del soporte de ifthenpay).
7. Activa Enable/Disable.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > ifthenpay. Sin la clave del método seleccionado, el método de pago no se muestra en la finalización de compra, y la lista de métodos de pago lo marca como pendiente de acción. Al guardar una pasarela activada sin esa clave, la página muestra ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout.
Enable/Disable: Enable ifthenpay Payment activa o desactiva el método de pago. Por defecto: desactivado.
Title: el título del método de pago que se muestra en la finalización de compra. Por defecto: ifthenpay.
Description: la descripción del método de pago que se muestra en la finalización de compra. Por defecto: Pay via Multibanco, MB WAY or Credit Card. Cámbiala para que coincida con el método que ofreces.
Payment Method: el método que se ofrece en la finalización de compra. Solo es obligatoria la clave de este método.
Claves de ifthenpay
Las claves (formato ABC-123456) se muestran en el backoffice de ifthenpay o las envía ifthenpay cuando el método de pago se activa en tu cuenta.
Multibanco Key: tu clave de ifthenpay Multibanco (MB) para referencias dinámicas.
MB WAY Key: tu clave de ifthenpay MB WAY.
Credit Card Key: tu clave de ifthenpay Credit Card. También verifica la firma del retorno del cliente desde la página de tarjetas.
Callback (notificaciones de pago)
El callback indica a tu tienda que se ha realizado un pago. Pide a ifthenpay que active el callback para cada clave que uses, con la clave anti-phishing y la URL de callback indicadas abajo. Los pedidos de Multibanco y MB WAY se confirman solo mediante el callback; los pagos con tarjeta se confirman también mediante el retorno firmado desde la página de tarjetas.
Anti-phishing Key: generada por el plugin, se muestra para copiarla. ifthenpay la envía de vuelta en cada callback; los callbacks sin ella se rechazan.
Callback URL: la URL de callback del método de pago seleccionado, con los marcadores de ifthenpay, que se muestra para copiarla. Empieza así: https://your-site/wc-api/ifthenpay_payment_callback/ y continúa con los parámetros del método. Copia la URL completa exactamente como aparece en la configuración.
La clave anti-phishing de cada callback se compara con la tuya. Una clave ausente o incorrecta recibe la respuesta 403 y el pedido no cambia. El callback también debe corresponder a un pedido de esta pasarela: en Multibanco, por entidad y referencia; en MB WAY, por el pedido y una de sus solicitudes MB WAY; en tarjeta de crédito, por el pedido y su solicitud de tarjeta. Sin un callback que funcione, los pedidos de Multibanco y MB WAY nunca se confirman, y los pagos con tarjeta solo se confirman mediante el retorno firmado.
Avanzado
Test Mode: Enable test/sandbox mode. La tarjeta de crédito y Multibanco usan los endpoints sandbox de ifthenpay; no se cobra dinero real y usas las claves de prueba que facilita ifthenpay. MB WAY no tiene sandbox: pruébalo con una clave de prueba de ifthenpay. La finalización de compra muestra una insignia TEST MODE. Por defecto: desactivado.
Order Status After Payment: el estado del pedido que se asigna tras un pago confirmado, con un único cambio de estado y un único e-mail al cliente. Los pedidos que contienen solo productos virtuales descargables los completa siempre WooCommerce.
Debug Log: Enable logging. Las solicitudes de API y los callbacks se escriben en WooCommerce > Status > Logs, origen wcp_ifthenpay_gateway. Los errores siempre se registran. Las claves, la clave anti-phishing y los números de teléfono nunca se registran. Por defecto: desactivado.
Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept). Por defecto: desactivado.
Finalización de compra
Multibanco. En la finalización de compra el cliente ve You will receive a Multibanco reference to complete the payment. Al realizar el pedido, el plugin crea una referencia Multibanco dinámica por el total del pedido. El pedido pasa a En espera, se reduce el stock y se vacía el carrito. La página de pedido recibido y los e-mails de pedido que se envían mientras el pedido está en espera muestran Multibanco Payment Details: entidad, referencia e importe, con Please use these details to pay at any Multibanco ATM or through your online banking. Si el cliente vuelve a realizar el pedido por el mismo importe, se reutiliza la misma referencia. El pedido se confirma cuando ifthenpay envía el callback de pago.
MB WAY. El cliente introduce el MB WAY phone number (912 345 678, +351 912 345 678 o 351#912345678 para otros países); el teléfono de facturación se rellena. El plugin envía una solicitud de pago al teléfono, el pedido pasa a En espera, se reduce el stock y se vacía el carrito. La página de pedido recibido indica A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Se mantienen todas las solicitudes del pedido, así que una solicitud anterior aprobada en la aplicación se sigue aceptando. El pedido se confirma mediante el callback.
Tarjeta de crédito. El cliente ve You will be redirected to a secure page to enter your card details. y es enviado a la página de tarjetas de ifthenpay. El pedido permanece como Pendiente de pago hasta que se paga, y el stock no se reduce antes. Tras un pago correcto, el cliente vuelve a tu tienda. El retorno solo se acepta con una firma válida de ifthenpay, la clave del pedido, un secreto de ese intento y la solicitud de tarjeta del pedido; entonces el pedido se marca como pagado. Si el retorno no se puede verificar, el pedido no cambia y la página de pedido recibido muestra Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. Un pago con tarjeta fallido marca el pedido como Fallido, y uno cancelado lo deja como Pendiente de pago. En ambos casos el cliente va a la página Pay for order con The card payment was not completed. You can try again or choose another payment method. o The card payment was cancelled. You can try again or choose another payment method.
El pedido se marca como pagado solo después de que ifthenpay confirme el pago, y el importe se comprueba al céntimo frente al total del pedido. Si el pago no se puede iniciar, el cliente ve un mensaje breve, por ejemplo The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. o The payment service is temporarily unavailable. Please try again in a few minutes.
El método de pago funciona en la finalización de compra clásica, en los bloques Carrito y Finalizar compra (con el campo de teléfono de MB WAY) y en la página Pay for order. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
El plugin ofrece un método de ifthenpay a la vez. No incluye Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX ni Pay-by-Link, ni suscripciones o tarjetas guardadas, ni expiración o cancelación automática de las referencias Multibanco sin pagar, ni consulta del estado del pago.
Pedidos
Order statuses
On hold (waiting for payment): se emitió una referencia Multibanco o se envió una solicitud de MB WAY. Las referencias sin pagar no se cancelan automáticamente; cancela tú esos pedidos si es necesario.
Pending payment: se inició un pago con tarjeta que aún no está confirmado, o se canceló.
Processing or Completed: el pago se confirmó. El estado sigue a Order Status After Payment. La nota del pedido muestra la entidad y la referencia Multibanco, la transacción de MB WAY o el ID de la solicitud de tarjeta.
On hold after payment: el importe recibido era distinto del total del pedido, o el pago llegó después de que el pedido se cancelara. La nota del pedido lo explica. Revisa el pago en el backoffice de ifthenpay y completa o reembolsa el pedido manualmente.
Failed: el cliente volvió de la página de tarjetas con un error.
Una segunda notificación de pago para un pedido ya pagado solo añade una nota para comprobar si hay un pago duplicado en el backoffice de ifthenpay. Los pedidos reembolsados, y los cancelados después del pago, nunca se reabren.
Reembolsos
Los reembolsos desde WooCommerce no son compatibles. Reembolsa el pago en el backoffice de ifthenpay y regístralo manualmente en WooCommerce. Un callback de devolución (DEVOLVIDO) solo añade una nota al pedido. Los demás estados que comunica ifthenpay también solo añaden una nota.
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 > ifthenpay. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa, 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 plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, ifthenpay no se muestra a los clientes en la finalización de compra. Si un pago se inicia de todos modos, el cliente ve This payment method is not available. Please choose another one. Los gestores de la tienda que han 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 Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando.
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
ifthenpay no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que la clave del Payment Method seleccionado está rellena, que la moneda es EUR y que el total está entre 0,01 y 99.999,99 EUR. En la página Pay for order cuenta la moneda del pedido.
El cliente pagó, pero el pedido sigue On hold o Pending payment: el callback no llega a tu tienda. Comprueba que ifthenpay ha activado la URL de callback y la clave anti-phishing para la clave que usas, y que la URL es la del método seleccionado. El sitio debe ser accesible desde internet, no en localhost ni detrás de un login. Busca las líneas Callback rejected en WooCommerce > Status > Logs, origen wcp_ifthenpay_gateway.
El callback responde 403 Forbidden: la clave anti-phishing del callback falta o no coincide con la de la configuración. Envía de nuevo a ifthenpay la clave que aparece en la configuración.
El callback responde 503 Not configured: la clave anti-phishing todavía no se ha generado. Abre la página de configuración una vez; ifthenpay volverá a intentar el callback.
El callback responde Order not found: la referencia o la solicitud no pertenece a un pedido de esta pasarela, por ejemplo porque se cambió el método de pago después de realizar el pedido.
¿Por qué se puso On hold un pedido pagado? El importe recibido era distinto del total del pedido, o el pago llegó después de que el pedido se cancelara. Lee la nota del pedido, comprueba el pago en el backoffice de ifthenpay y completa o reembolsa el pedido manualmente.
No se pudo enviar la solicitud de MB WAY: el número de teléfono no está vinculado a MB WAY o tiene un formato incorrecto. Usa 912 345 678, o 351#912345678 para números de otros países.
Modo de prueba y MB WAY: ifthenpay no tiene sandbox para MB WAY; usa una clave de prueba que facilite ifthenpay.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. La configuración de la pasarela, la clave anti-phishing y los registros se eliminan solo si Delete Data on Uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos y sus datos de ifthenpay (referencias, ID de solicitud) siempre se conservan. Los pedidos existentes conservan sus notas de pago e ID de transacción.
ifthenpay es una marca comercial de su respectivo titular. Este plugin no está afiliado a ifthenpay ni cuenta con su respaldo.