VibeFox iPay88 for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo. Sin WooCommerce, el plugin no se activa.

PHP: 8.0 o posterior.

Cuenta de comerciante de iPay88: iPay88 emite el Merchant Code y el Merchant Key cuando se activa tu cuenta de comerciante. También aparecen en el portal de comerciantes de iPay88. Si todavía no eres comerciante, solicítalo en el sitio web de iPay88. Guarda el Merchant Key en secreto: firma los pagos.

Request URL: la dirección de tu sitio web debe estar registrada en iPay88 como Request URL. Si no, la página de iPay88 muestra "Permission not allow".

Moneda de la tienda: Malaysia: MYR, y USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP o THB si la opción multidivisa está activada en tu cuenta de iPay88; Philippines: PHP o USD; Indonesia: IDR; Thailand: THB.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo 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_ipay88_payment a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Payments > iPay88 > Manage, o haz clic en Settings debajo del 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. Elige tu iPay88 region e introduce el Merchant Code y el Merchant Key (véase Configuración).

6. Activa Enable/Disable. Para comprobar la configuración, haz un pago con Test mode activado y después desactívalo.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > iPay88. Encima de los campos, la página te avisa si falta el Merchant Code o el Merchant Key (en ese caso el método de pago no aparece en la finalización de compra), si la moneda de la tienda no puede cobrarse en la región seleccionada y mientras el modo de prueba está activado. En la lista de métodos de pago, iPay88 aparece como pendiente de configuración hasta que se introducen ambas claves, y muestra una insignia de modo de prueba mientras este esté activado.

General

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 ven los clientes en la finalización de compra. Por defecto: iPay88.

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

Cuenta de iPay88

iPay88 region: el país de tu cuenta de comerciante de iPay88. Determina la página de pago de iPay88 y las monedas que se pueden cobrar. 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. Mantenla en secreto.

Signature type: cómo se firman las solicitudes de pago. Las respuestas se verifican en ambos formatos.

Pago

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 delante del número de pedido 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 una respuesta de una tienda nunca pueda aplicarse a un pedido de otra. Letras, dígitos, "-" y "_", hasta 10 caracteres. Un prefijo que termina en número se corrige al guardar, porque el número de pedido se lee desde el final de la referencia.

Test mode: Charge a fixed test amount instead of the order total. iPay88 no tiene un entorno sandbox aparte: los pagos de prueba son transacciones reales en la página real de iPay88 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: only a test amount of ... will be charged. Nunca dejes el modo de prueba activado en una tienda real. Por defecto: desactivado.

URL de respuesta y de backend

El plugin envía ambas URL con cada pago, así que no hay nada que configurar. Si iPay88 las pide, cópialas de esta sección de la configuración. Tienen este aspecto: https://your-site/wc-api/ipay88_p_response/ (Response URL, el retorno del cliente) y https://your-site/wc-api/ipay88_p_backend/ (Backend URL, la notificación servidor a servidor). La sección también muestra la dirección de tu sitio web, que debe estar registrada en iPay88 como Request URL.

Ambas respuestas de iPay88 se comprueban de la misma forma: la firma hecha con tu Merchant Key, la referencia de un pago que esta tienda inició para este pedido, el importe y la moneda. Las solicitudes sin firma válida se rechazan y nunca cambian un pedido. La notificación de backend recibe RECEIVEOK solo después de procesarse; si no, iPay88 la envía de nuevo. iPay88 informa de estos estados de pago:

Avanzado

Debug log: Log payment requests and iPay88 responses en WooCommerce > Status > Logs, origen wcp_ipay88_payment, sin datos personales ni firmas. Los errores siempre se registran. Por defecto: desactivado.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. Los pedidos nunca se eliminan. Por defecto: desactivado.

Finalización de compra

El cliente elige el método de pago (por defecto iPay88) y realiza el pedido. El pedido permanece en Pending payment, y el cliente ve Redirecting to iPay88 payment gateway... 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. Los artículos del pedido, el nombre, el correo electrónico y el teléfono del cliente se transmiten a iPay88. 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.

Tras pagar, el cliente vuelve a la página de pedido recibido de tu tienda. 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. Si la confirmación aún no ha llegado, la página muestra We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. En un pago pendiente muestra Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.

Si el pago ha fallado o se ha cancelado, el cliente llega a la página Pay for order con The payment was not completed: y el motivo de iPay88, y puede volver a pagar o elegir otro método de pago. Si la respuesta no puede verificarse, el cliente ve The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. con un enlace de vuelta a la tienda.

Las existencias se reducen cuando se confirma el pago, no cuando el cliente es redirigido. 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).

El plugin solo admite pagos únicos. No ofrece reembolsos desde WooCommerce, 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 con la respuesta de iPay88 y la notificación de backend. No se usa iPay88 Indonesia API 2.0 (JSON / payment link).

Pedidos

Order statuses

Pending payment: el cliente fue enviado a iPay88 y aún no ha pagado, o iPay88 aún no ha confirmado el pago.

Processing or Completed: el pago se ha confirmado. WooCommerce asigna el estado habitual de un pedido pagado. La nota del pedido muestra el TransID, el PaymentID, el importe y la moneda de iPay88. El ID de transacción es el TransID de iPay88. En modo de prueba, una segunda nota indica que se cobró el importe de prueba en lugar del total del pedido.

On hold, pending at iPay88: iPay88 informó de que el pago está pendiente. El pedido se actualiza cuando iPay88 confirma o rechaza el pago.

On hold, for review: iPay88 informó de un pago correcto con un importe o una moneda distintos a los del pedido, o el pago llegó después de que el pedido se cancelara. El pedido no se marcó como pagado. La nota del pedido lo explica. Revisa el pago en el portal de iPay88 y completa el pedido o reembolsa el pago.

Failed: el pago ha fallado o se ha cancelado. La nota muestra el motivo de iPay88. El cliente puede volver a pagar.

Si llega otro pago correcto para un pedido que ya está pagado o reembolsado, el pedido no se modifica. Una nota te pide que lo revises en el portal de iPay88 y lo reembolses si es un duplicado. Una respuesta fallida nunca cambia un pedido pagado, reembolsado o cancelado.

Reembolsos

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

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 > iPay88. 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 eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un solo dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, iPay88 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. Un aviso aparece en la página de 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 renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

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 el Merchant Code y el Merchant Key están introducidos y que la moneda de la tienda puede cobrarse en la iPay88 region seleccionada. La página de configuración muestra un aviso cuando falta algo.

El pago se realizó, pero el pedido sigue en Pending payment: ni el retorno del cliente ni la notificación de backend llegaron a tu tienda con una firma válida. Activa el Debug log y revisa WooCommerce > Status > Logs, origen wcp_ipay88_payment. Comprueba que el Merchant Key es exactamente el que te dio iPay88 y que tu sitio puede recibir solicitudes de iPay88 en la Backend URL que aparece en la configuración.

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

Backend notification answers BAD SIGNATURE: la firma no coincide con el Merchant Key. Revisa el Merchant Key.

Backend notification answers NOT CONFIGURED: el Merchant Code o el Merchant Key no están configurados, así que la respuesta no puede verificarse. iPay88 vuelve a enviar la notificación.

Backend notification answers 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.

El pedido está On hold con una nota sobre el importe o la moneda: iPay88 informó de un pago que no coincide con el pedido, o el pedido se había cancelado. El pedido no se marcó como pagado. Revisa el pago en el portal de iPay88 y complétalo o reembólsalo.

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

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

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.

Los desarrolladores pueden cambiar la URL de la página de pago, las monedas, los decimales, el importe de prueba y el icono con los filtros ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount e ipay88_p_icon.

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, los registros y los datos de iPay88 guardados en los pedidos solo se eliminan si Delete data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos nunca se eliminan y conservan sus notas de pago y los ID de transacción.

iPay88 es una marca comercial de su respectivo titular. Este plugin no está afiliado a iPay88 ni cuenta con su aprobación.