VibeFox iPay88 for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo se niega a instalarse en versiones anteriores de PHP.

Cuenta de comerciante de iPay88: iPay88 emite el Merchant Code y el Merchant Key cuando se activa tu cuenta de comerciante. También se muestran en el portal de comerciante de iPay88. Si todavía no eres comerciante, solicítalo en el sitio web de iPay88. Mantén el Merchant Key en secreto: firma los pagos. iPay88 no tiene un sandbox independiente, así que no hay claves de prueba.

URL de solicitud: la dirección de tu sitio web debe estar registrada en iPay88 como URL de solicitud. De lo contrario, la página de iPay88 muestra "Permission not allow".

Moneda: Malaysia — MYR, y USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP o THB si la opción multimoneda está activada en tu cuenta de iPay88; Philippines — PHP o USD; Indonesia — IDR; Thailand — THB. Si la moneda del carrito no puede cobrarse en tu región, el método de pago se oculta en la finalización de compra.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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 carga, haz clic en Configure, o busca después VibeFox iPay88 Payment en la lista de módulos y haz clic en Configure.

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

4. Elige tu iPay88 region, introduce el Merchant Code y el Merchant Key, activa Enable/Disable y haz clic en Save.

5. Para comprobar la configuración, haz un pago con Test mode activado y, después, desactiva el modo de prueba.

Al instalarse, el módulo crea dos estados de pedido: Awaiting iPay88 payment e iPay88 payment on hold. PrestaShop habilita el nuevo módulo de pago para todas las monedas, países y grupos de clientes. Puedes limitarlos en Payment > Preferences. Un país que actives después de instalar el módulo también debe estar marcado para el módulo allí; de lo contrario, los clientes de ese país no verán iPay88. Las URL de respuesta y de backend se envían con cada pago.

Configuración

Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox iPay88 Payment > Configure. Cada botón Save guarda toda la página. Encima de los campos, la página muestra Introduce el Merchant Code y el Merchant Key de iPay88; hasta entonces, el método de pago no se muestra en la finalización de compra. mientras falte una clave, un aviso cuando la moneda predeterminada de la tienda no puede cobrarse en la región seleccionada (el método de pago se oculta entonces en la finalización de compra) y un aviso mientras el modo de prueba esté activado.

iPay88

Enable/Disable: Enable iPay88 Payment Gateway activa o desactiva el método de pago. Por defecto: desactivado.

Title: el nombre del método de pago que ve el cliente en la finalización de compra. También es el nombre del método de pago guardado en el pedido. Por defecto: iPay88.

Description: el texto que se muestra bajo el método de pago en la finalización de compra. Por defecto: Pay securely via iPay88 (credit card, online banking, e-wallet).

iPay88 account

iPay88 region: el país de tu cuenta de comerciante de iPay88. Determina la página de pago de iPay88 y las monedas que pueden cobrarse. El pedido siempre se cobra en su propia moneda. Por defecto: Malaysia.

Merchant Code: tu Merchant Code de iPay88, por ejemplo M01234.

Merchant Key: tu Merchant Key de iPay88. Firma las solicitudes de pago y verifica las respuestas de iPay88. Manténla en secreto. La clave guardada nunca se vuelve a mostrar: el campo queda vacío y muestra Guardada: deja el campo vacío para conservarla. Escribe un valor nuevo solo si quieres cambiarla. La clave se guarda exactamente como la introduces, incluidas las comillas y las barras invertidas.

Clear saved secret: marca Merchant Key y haz clic en Save para eliminar la clave guardada. Un campo vacío conserva el valor guardado.

Signature type: cómo se firman las solicitudes de pago. Las respuestas se verifican en ambos formatos, así que los pagos iniciados antes de un cambio siguen siendo verificables.

Payment

Payment method: preselecciona un método de pago de iPay88 de la lista de PaymentId de Malaysia, o deja Let the customer choose on the iPay88 page (por defecto). La lista incluye Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay y ShopeePay.

Reference prefix: opcional. Se añade antes del número de carrito en la referencia de iPay88 (RefNo), por ejemplo SHOP1-. Usa un prefijo distinto en cada tienda que utilice la misma cuenta de iPay88, para que la respuesta de una tienda nunca se aplique al carrito de otra. Letras, dígitos, "-" y "_", hasta 10 caracteres. Los demás caracteres se eliminan al guardar, y un prefijo que termina en dígito recibe "-" al final, porque el número de carrito se lee desde el final del RefNo. La página muestra entonces el valor que se guardó. Si pasas de WooCommerce a PrestaShop con la misma cuenta de iPay88, define un prefijo para que las nuevas referencias nunca repitan números de pedido antiguos.

Test mode: Charge a fixed test amount instead of the order total. iPay88 no tiene sandbox independiente: los pagos de prueba son transacciones reales en la página de iPay88 en vivo con un importe pequeño (1,00; IDR 10.000). El pedido se marca como pagado cuando se recibe el importe de prueba, y la nota del pedido lo indica. Mientras el modo de prueba esté activado, la finalización de compra muestra TEST MODE: solo se cobrará un importe de prueba de ... . Un pago iniciado en modo de prueba siempre se comprueba frente al importe de prueba, incluso si desactivas el modo de prueba antes de que iPay88 responda. Nunca dejes el modo de prueba activado en una tienda real. Por defecto: desactivado.

URL de respuesta y de backend

El módulo envía ambas URL con cada pago, así que no hay nada que configurar. Si iPay88 las pide, cópialas desde esta sección. Con URL amigables tienen este aspecto: https://your-shop/module/wcp_ipay88_payment/response (Response URL, el retorno del cliente) y https://your-shop/module/wcp_ipay88_payment/backend (Backend URL, la notificación servidor a servidor), posiblemente con un código de idioma como /en/. La sección también muestra la dirección de tu sitio web, que debe estar registrada en iPay88 como URL de solicitud.

Ambas respuestas de iPay88 se comprueban de la misma manera: los campos obligatorios, la firma hecha con tu Merchant Key y la referencia de un pago que esta tienda inició para este carrito. Las respuestas sin firma válida se rechazan y nunca modifican un carrito ni un pedido. La notificación de backend recibe RECEIVEOK solo después de haberse procesado; de lo contrario, iPay88 la envía de nuevo. Funciona mientras la tienda está en modo de mantenimiento y no la bloquea la restricción de países de tu tienda. iPay88 informa de estos estados de pago:

Advanced

Debug log: registra las solicitudes de pago y las respuestas de iPay88 en logs/ipay88_p_debug.log.php de la carpeta del módulo. El archivo no se puede abrir desde la web. No se registran datos personales, Merchant Key ni firmas. Los errores y las advertencias siempre se registran, incluso con el interruptor desactivado. Por defecto: desactivado.

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

Delete data on uninstall: elimina los ajustes, los registros y los datos de pago de iPay88 al desinstalar el módulo. Los pedidos y los estados de pedido nunca se eliminan. Por defecto: desactivado.

Finalización de compra

En el paso de pago, el cliente elige el método de pago (por defecto iPay88) y confirma. La página siguiente muestra Redirigiendo a la pasarela de pago de iPay88... y Por favor, no cierres esta ventana. mientras se envía un formulario a la página de pago de iPay88 de tu región. Sin JavaScript, el cliente hace clic en Pay Now. Todavía no existe ningún pedido en este momento. El módulo envía el total del carrito en la moneda del carrito (el importe de prueba en modo de prueba), los nombres de los productos y el nombre, el correo electrónico y el teléfono del cliente. En la página de iPay88, el cliente paga con tarjeta, banca en línea FPX, monedero electrónico u otro método que ofrezca tu cuenta.

El pedido se marca como pagado solo cuando iPay88 lo confirma con una respuesta firmada, ya sea en el retorno del cliente o mediante la notificación de backend. Tras un pago correcto, el pedido se crea y el cliente ve la página estándar de confirmación del pedido con Hemos recibido tu pago de iPay88. Para un pago pendiente, la página muestra Tu pago está pendiente de confirmación por parte de iPay88. Actualizaremos tu pedido en cuanto se confirme el pago. Para un pedido en espera, muestra Hemos recibido una notificación de pago de iPay88 y la estamos revisando. Te contactaremos si hace falta algo. Si el pedido está en Payment error o se canceló, muestra El pago no se completó. Ponte en contacto con nosotros.

Si la confirmación la procesa al mismo tiempo la notificación de backend, el cliente ve Todavía no hemos recibido la confirmación del pago de iPay88. Si completaste el pago, tu pedido se actualizará en breve. con los botones Check again y Back to checkout.

Si el pago falló o se canceló, no se crea ningún pedido y el carrito se conserva. El cliente vuelve a la finalización de compra con El pago no se completó: y el motivo de iPay88, seguido de Puedes intentarlo de nuevo o elegir otro método de pago. Todos los intentos del mismo carrito usan el mismo RefNo. Si la respuesta no puede verificarse, el cliente ve No se pudo verificar la respuesta del pago. Si completaste el pago, ponte en contacto con nosotros indicando tu número de pedido; el pago se comprobará manualmente. con un botón Return to the store.

Si el pago no puede iniciarse, el cliente vuelve a la finalización de compra con Este método de pago no está disponible temporalmente. Elige otro método de pago. (faltan claves o el total es cero) o iPay88 no puede aceptar pagos en ... Elige otro método de pago. (moneda no cobrable en la región). Si el carrito ya tiene un pedido (pagado o a la espera de un pago pendiente), no se genera un segundo formulario de pago y el cliente es enviado a la página de confirmación del pedido.

El módulo admite solo pagos únicos. No ofrece reembolsos desde PrestaShop, tarjetas guardadas, suscripciones, preautorización y captura, ni campos de tarjeta en tu sitio. No consulta a iPay88 el estado del pago: los pedidos solo se actualizan mediante la respuesta de iPay88 y la notificación de backend.

Pedidos

Order statuses

No order yet: el cliente fue enviado a iPay88 y aún no ha llegado ningún resultado, o el pago falló. Solo existe el carrito.

Payment accepted: iPay88 informó de un pago correcto con el importe y la moneda esperados. El pago se registra con el TransId de iPay88 como ID de transacción. Una nota privada muestra el TransID, el PaymentID, el importe y la moneda. En modo de prueba, una segunda nota indica que se cobró el importe de prueba en lugar del total del pedido.

Awaiting iPay88 payment: iPay88 informó del pago como pendiente. El pedido pasa a Payment accepted cuando iPay88 lo confirma, o a Payment error si falla.

Payment error: un pago pendiente falló después. La nota muestra el motivo de iPay88. Este carrito ya tiene un pedido, así que el cliente no puede volver a pagarlo y realiza un pedido nuevo.

iPay88 payment on hold: iPay88 informó de un pago correcto con un importe o una moneda distintos del pedido, o el pago llegó después de que se cancelara el pedido. El pedido NO se marcó como pagado. La nota lo explica. Comprueba el pago en el portal de iPay88 y completa el pedido o reembolsa el pago.

Un pedido pagado o reembolsado nunca se modifica con una respuesta posterior. Si llega otro pago correcto para él, una nota te pide que lo compruebes en el portal de iPay88 y lo reembolses si es un duplicado. Una respuesta fallida nunca modifica un pedido pagado, reembolsado o cancelado. Las respuestas repetidas no añaden nada nuevo.

Bloque de pago de iPay88

La página del pedido muestra un bloque iPay88 payment con el RefNo, TransId, estado, el importe solicitado, el importe recibido, el PaymentId, el AuthCode, el error y la región, y una insignia TEST MODE para los pagos de prueba.

Reembolsos

Los reembolsos no se envían a iPay88 desde PrestaShop. Reembolsa el pago en el portal de comerciante de iPay88 y luego registra el reembolso manualmente en PrestaShop.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox iPay88 Payment es el primer bloque de Modules > Module Manager > VibeFox iPay88 Payment > 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-ipay88 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 seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no responde, 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. Quitar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, iPay88 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 aviso en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados: los pagos ya iniciados siguen confirmándose.

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 a la semana. No hace falta ninguna tarea cron. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.

Solución de problemas

iPay88 no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que Merchant Code y Merchant Key estén introducidos, y que la moneda del carrito pueda cobrarse en la iPay88 region seleccionada. La página de ajustes muestra un aviso cuando falta algo. En Payment > Preferences, comprueba que el módulo esté permitido para la moneda del carrito, el país del cliente y el grupo del cliente.

El pago se realizó, pero no se creó ningún pedido: ni el retorno del cliente ni la notificación de backend llegaron a tu tienda con una firma válida. Revisa el campo Log: los errores siempre se registran. Comprueba que el Merchant Key sea exactamente el que te dio iPay88 y que tu servidor acepte solicitudes de iPay88 en la Backend URL que aparece en los ajustes.

La página de iPay88 muestra "Permission not allow": la dirección de tu sitio web no está registrada en iPay88 como URL de solicitud. Pide a iPay88 que registre la dirección que se muestra en la sección Response and backend URLs.

La notificación de backend responde BAD SIGNATURE: la firma no coincide con el Merchant Key. Comprueba el Merchant Key. No se cambió nada.

La notificación de backend responde NOT CONFIGURED: el Merchant Code o el Merchant Key no están definidos, así que la respuesta no puede verificarse. iPay88 vuelve a enviar la notificación.

La notificación de backend responde UNKNOWN ORDER: no se inició ningún pago de iPay88 para esta referencia en esta tienda; por ejemplo, porque otra tienda con la misma cuenta no usa Reference prefix o usa el mismo, o porque los datos de pago de iPay88 se eliminaron al desinstalar.

La notificación de backend responde RETRY: el carrito se estaba confirmando en ese momento mediante el retorno del cliente, o el pedido no pudo crearse (por ejemplo, el módulo está desactivado). iPay88 vuelve a enviar la notificación.

La Backend URL muestra BAD REQUEST en el navegador: es normal. La URL acepta solo solicitudes firmadas de iPay88.

El pedido está en iPay88 payment on hold: iPay88 informó de un pago que no coincide con el pedido, o el pedido se había cancelado. Comprueba la nota del pedido y el pago en el portal de iPay88, y después completa el pedido o reembolsa el pago.

El cliente ve "iPay88 cannot accept payments in" una moneda: la moneda del carrito no puede cobrarse en la región seleccionada. En iPay88 Malaysia, las monedas distintas de MYR también necesitan la opción multimoneda en tu cuenta de iPay88.

Los clientes reales solo pagan 1,00: el Test mode está activado. Desactívalo.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox iPay88 Payment y elige Uninstall. La clave de licencia y el estado de licencia de este módulo siempre se eliminan. La confirmación indica que los ajustes y los datos de pago de iPay88 se conservan, salvo que esté activada la opción Delete data on uninstall. Si está activada, se eliminan los ajustes, los registros y los datos de pago de iPay88. Si está desactivada, todo se conserva para una reinstalación posterior. Los estados de pedido Awaiting iPay88 payment e iPay88 payment on hold siempre se conservan. Los pedidos nunca se eliminan y conservan sus notas de pago y sus ID de transacción.

iPay88 es una marca comercial de su respectivo titular. Este módulo no está afiliado a iPay88 ni cuenta con su respaldo.