VibeFox ifthenpay for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.

Moneda: solo euro (EUR). El método de pago se oculta cuando la moneda del carrito no es EUR. ifthenpay acepta importes 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 back office de ifthenpay (backoffice.ifthenpay.com) o las envía ifthenpay cuando se activa el método para 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 solo dominio.

Instalación

1. En el back office, ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.

2. Cuando termine la subida, haz clic en Configure, o busca VibeFox ifthenpay Gateway en la lista de módulos más tarde y haz clic en Configure. El módulo genera su clave anti-phishing al instalarse.

3. Introduce tu clave de licencia de VibeFox en el campo License key del bloque de licencia de la parte superior de la página Configure y haz clic en Activate (ver Clave de licencia).

4. Elige el Payment Method, introduce su clave de ifthenpay y haz clic en Save, para que la Callback URL coincida con el método elegido.

5. 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).

6. Activa Enable/Disable y haz clic en Save.

Al instalarse, el módulo crea dos estados de pedido: Awaiting ifthenpay payment y ifthenpay payment on hold. PrestaShop asigna a un nuevo módulo de pago todas las monedas, países y grupos de clientes. Puedes limitarlos en Payment > Preferences; EUR debe seguir permitido.

Configuración

Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox ifthenpay Gateway > Configure. Cada sección con un botón Save guarda la página completa. Sin la clave del método seleccionado, el método de pago no aparece en la finalización de compra. Mientras la pasarela está 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.

ifthenpay

Enable/Disable: Enable ifthenpay Payment activa o desactiva el método de pago. Por defecto: off.

Title: el título del método de pago que se muestra en la finalización de compra. También es el nombre del método de pago guardado en el pedido. 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 back office de ifthenpay o las envía ifthenpay cuando se activa el método de pago para tu cuenta.

Multibanco Key: tu clave Multibanco (MB) de ifthenpay para referencias dinámicas.

MB WAY Key: tu clave MB WAY de ifthenpay.

Credit Card Key: tu clave Credit Card de ifthenpay. También verifica la firma del retorno del cliente desde la página de tarjetas.

Las claves guardadas nunca se vuelven a mostrar. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarla.

Clear saved keys: marca una clave y haz clic en Save para eliminarla. Un campo vacío mantiene el valor guardado.

Callback (notificaciones de pago)

El callback informa a tu tienda de 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 solo se confirman con el callback; los pagos con tarjeta también se confirman con el retorno firmado desde la página de la tarjeta.

Anti-phishing Key: generada por el módulo, 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, se muestra para copiarla. Con URLs amigables empieza así: https://your-shop/module/wcp_ifthenpay_gateway/callback, posiblemente con un código de idioma como /en/, 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 una respuesta 403, y el pedido no cambia. El callback también debe corresponder a un pago de este módulo: en Multibanco, por entidad y referencia; en MB WAY, por el carrito y una de sus solicitudes MB WAY; en Credit Card, por el carrito y una de sus solicitudes 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 con el retorno firmado. El callback funciona mientras la tienda está en modo de mantenimiento y no se ve bloqueado por la restricción de países de tu tienda.

Avanzado

Test Mode: Credit Card y Multibanco usan los endpoints sandbox de ifthenpay; no se cobra dinero real y usas las claves de prueba que te proporciona 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: off.

Order Status After Payment: el estado que se asigna al pedido tras un pago confirmado, en un único cambio de estado.

Debug Log: las solicitudes a la API y los callbacks se escriben en logs/ifthenpay_p_debug.log.php en la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores siempre se registran. Las claves, la clave anti-phishing y los números de teléfono completos nunca se registran. Por defecto: off.

Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.

Delete Data on Uninstall: si está activado, al desinstalar el módulo se eliminan sus ajustes, la clave anti-phishing y el registro. Los pedidos y los registros de pagos de ifthenpay siempre se conservan. Por defecto: off.

Finalización de compra

Multibanco. En la finalización de compra el cliente ve You will receive a Multibanco reference to complete the payment. Cuando el cliente confirma, el módulo crea una referencia Multibanco dinámica por el total del carrito y el pedido se crea en Awaiting ifthenpay payment. La página de confirmación del pedido muestra Multibanco Payment Details: entidad, referencia e importe, con Please use these details to pay at any Multibanco ATM or through your online banking. Los mismos datos se añaden al e-mail de confirmación del pedido. El pedido se paga 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 la dirección de facturación se rellena. El módulo envía una solicitud de pago al teléfono y el pedido se crea en Awaiting ifthenpay payment. La página de confirmación del pedido dice A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. El pedido se paga cuando ifthenpay envía el callback. Solo se guarda un número de teléfono enmascarado.

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. Todavía no existe ningún pedido y el carrito se conserva. Tras un pago correcto, el cliente vuelve a tu tienda. El retorno se acepta solo con una firma válida de ifthenpay, la clave segura del carrito, un secreto de ese intento y la solicitud de tarjeta del carrito; entonces el pedido se crea como pagado y el cliente ve la página estándar de confirmación del pedido. Si el retorno no se puede verificar, no cambia nada y una página Payment confirmation muestra Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. con un botón Check again; el callback crea el pedido en cuanto llega. Si el pago con tarjeta falla o se cancela, el cliente vuelve a la finalización de compra 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. Se conserva cada intento de pago con tarjeta del carrito, por lo que un pago hecho en una pestaña anterior también se acepta.

El pedido se marca como pagado solo cuando ifthenpay lo confirma, y el importe se comprueba al céntimo frente al total del pedido. Si el pago no puede iniciarse, el cliente se queda en la finalización de compra con 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 motivo técnico se escribe en el registro.

El módulo ofrece un método de ifthenpay a la vez. No incluye Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX o 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

Estados del pedido

No order yet: se ha iniciado un pago con tarjeta que todavía no está confirmado, o ha fallado o se ha cancelado. Solo existe el carrito.

Awaiting ifthenpay payment: se ha emitido una referencia Multibanco o se ha enviado una solicitud MB WAY. PrestaShop reduce el stock cuando se crea el pedido. Las referencias sin pagar y las solicitudes MB WAY rechazadas no cancelan el pedido automáticamente; cancela tú esos pedidos si es necesario.

Payment accepted or Delivered: el pago se ha confirmado. El estado sigue a Order Status After Payment. El pago se registra con la referencia Multibanco, el ID de la solicitud MB WAY o el ID de la solicitud de tarjeta como ID de transacción, y una nota indica cómo se confirmó.

ifthenpay payment on hold: el importe recibido era distinto del total del pedido (por ejemplo, el carrito se cambió después de iniciar un pago con tarjeta), o el pago llegó después de que se cancelara el pedido. La nota lo explica y no se pide al cliente que pague de nuevo. Comprueba el pago en el back office de ifthenpay y completa o reembolsa el pedido manualmente. Un pago correcto posterior para ese pedido no lo cambia.

Un segundo pago para un pedido que ya está pagado solo añade una nota para comprobar si hay un pago duplicado en el back office de ifthenpay. Los pedidos reembolsados y los pedidos cancelados tras el pago nunca se reabren.

Bloque de pago de ifthenpay

La página del pedido muestra un bloque ifthenpay payment con los intentos de pago del pedido (fecha, método, una insignia Sandbox para los pagos de prueba, importe, entidad y referencia de Multibanco o el teléfono MB WAY enmascarado, ID de solicitud de ifthenpay y estado), una advertencia Manual review mientras el pedido esté en ifthenpay payment on hold, y las ifthenpay notes del pedido.

Reembolsos

Los reembolsos desde PrestaShop no son compatibles. Reembolsa el pago en el back office de ifthenpay y regístralo manualmente en PrestaShop. Un callback de devolución (DEVOLVIDO) solo añade una nota. Los demás estados comunicados por ifthenpay también solo añaden una nota.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox ifthenpay Gateway es el primer bloque de Modules > Module Manager > VibeFox ifthenpay Gateway > Configure, encima de los ajustes. Introduce la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-payment-ifthenpay y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).

Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on y una fecha. Después de cambiar la dirección de la tienda, o después de liberar un hueco de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.

Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Eliminar la clave de la tienda no libera su hueco de dominio. Libera el hueco en tu cuenta de vibefox.net.

Sin una clave activa, ifthenpay no se muestra a los clientes en la finalización de compra. Si de todos modos se inicia un pago, el cliente ve This payment method is not available. Please choose another one. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el método de pago también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados: los pagos ya iniciados se siguen confirmando.

Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días después de introducir la clave y, después, una vez por semana. No se necesita ninguna tarea cron. Al desinstalar o restablecer el módulo, siempre se eliminan la clave de licencia y el estado de la licencia.

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á rellenada, que la moneda del carrito es EUR y que el total está entre 0,01 y 99.999,99 EUR. En Payment > Preferences comprueba que el módulo está permitido para EUR, para el país del cliente y para el grupo del cliente.

El cliente ha pagado, pero el pedido sigue en Awaiting ifthenpay payment o no se ha creado ningún pedido: 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. La tienda debe ser accesible desde internet, no en localhost ni detrás de un inicio de sesión. Busca las líneas Callback rejected en el campo Log de la página del módulo.

El callback responde 403 Forbidden: la clave anti-phishing del callback falta o no coincide con la de los ajustes. Vuelve a enviar a ifthenpay la clave que aparece en los ajustes.

El callback responde 503 Not configured: la clave anti-phishing todavía no se ha generado. Abre los ajustes del módulo una vez; ifthenpay volverá a intentar el callback.

El callback responde 503 Busy: el mismo carrito estaba siendo procesado por otra solicitud en ese momento. ifthenpay volverá a intentar el callback.

El callback responde Order not found: la referencia o la solicitud no pertenece a un pago de este módulo, o el carrito se pidió con otro método de pago.

¿Por qué se puso en espera un pedido pagado? El importe recibido era distinto del total del pedido, o el pago llegó después de que se cancelara el pedido. Lee las notas del bloque ifthenpay payment, comprueba el pago en el back office de ifthenpay y completa o reembolsa el pedido manualmente.

No se pudo enviar la solicitud 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 de MB WAY; usa una clave de prueba proporcionada por ifthenpay.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox ifthenpay Gateway y elige Uninstall. La clave de licencia y el estado de la licencia de este módulo siempre se eliminan. Si Delete Data on Uninstall está activado, se eliminan los ajustes del módulo, la clave anti-phishing y el registro; tras una reinstalación se genera una nueva clave anti-phishing que hay que volver a enviar a ifthenpay. Si está desactivado, se conservan todos los ajustes para una reinstalación posterior. Los registros de pagos de ifthenpay (referencias e IDs de solicitud) y los estados de pedido Awaiting ifthenpay payment y ifthenpay payment on hold siempre se conservan, de modo que los callbacks de referencias emitidas antes siguen encontrando sus pedidos tras una reinstalación. Los pedidos existentes conservan sus notas de pago e IDs de transacción.

ifthenpay es una marca comercial de su respectivo titular. Este módulo no está afiliado ni avalado por ifthenpay.