VibeFox GMO for WooCommerce — Ayuda
Requisitos
WordPress: 6.0 o posterior.
WooCommerce: 8.0 o posterior, instalado y activo. El plugin no permite su activación sin él.
PHP: 8.0 o posterior.
Moneda de la tienda: yen japonés (JPY). Si la tienda usa otra moneda, el método de pago se oculta en la finalización de compra. En la página Pay for order se tiene en cuenta la moneda del pedido.
Cuenta de GMO Payment Gateway: un contrato de comerciante de GMO-PG con Link Type Plus. Necesitas el Shop ID, la Shop password y el Config ID de Link Type Plus (設定ID) del entorno de pruebas y/o de producción, y activar la notificación del resultado (結果通知) en la consola de la tienda de GMO-PG (consulta Configuración). No se utilizan el Site ID ni la Site password.
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_gmo_payment a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > 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. Introduce el Shop ID, la Shop password y el Config ID del entorno de pruebas y/o de producción y selecciona Environment.
6. En la consola de la tienda de GMO-PG activa 結果通知 (notificación del resultado) y configura la URL de notificación que aparece en los ajustes (consulta Configuración).
7. Activa Enable/Disable. Haz un pago de prueba en el entorno de pruebas y después cambia Environment a producción.
Configuración
Todos los ajustes están en una página: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. El título de la página muestra una insignia TEST o PRODUCTION para el entorno actual. Encima de los campos, la página te avisa si la moneda de la tienda no es JPY o si falta el Shop ID, la Shop password o el Config ID del entorno actual. En ambos casos, el método de pago se oculta en la finalización de compra. En la lista de métodos de pago, la pasarela se indica como pendiente de configuración hasta que el entorno actual tenga sus credenciales. Los espacios al principio y al final de las credenciales se eliminan al guardar.
Enable/Disable: Enable GMO Payment Gateway — Credit Card activa o desactiva el método de pago. Por defecto: desactivado.
Title: el nombre del método de pago que aparece en la finalización de compra. Por defecto: Credit card.
Description: el texto que aparece debajo del método de pago en la finalización de compra. Por defecto: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.
Cuenta de GMO-PG
El Shop ID y la Shop password están en la consola de la tienda de GMO-PG, en Shop management > Shop information, y el Config ID en Link Type Plus > Settings (設定ID). Los entornos de pruebas y de producción tienen credenciales diferentes.
Environment: el entorno de GMO-PG que recibe los pagos.
Credenciales de producción (p01.mul-pay.jp)
Production Shop ID: el Shop ID del entorno de producción.
Production Shop password: la Shop password del entorno de producción.
Production Config ID: el ID de configuración de Link Type Plus (設定ID) registrado en la consola de GMO-PG.
Credenciales de pruebas (pt01.mul-pay.jp)
Test Shop ID: el Shop ID del entorno de pruebas.
Test Shop password: la Shop password del entorno de pruebas.
Test Config ID: el ID de configuración de Link Type Plus (設定ID) del entorno de pruebas.
Pago
Capture: cuándo se cobra la tarjeta.
Order status after payment: el estado de un pedido pagado. El estado se establece de inmediato, con un único cambio de estado y un único correo electrónico al cliente.
Notificaciones de pago (結果通知)
La notificación del resultado informa a tu tienda de que se ha realizado un pago. Es obligatoria. En la consola de la tienda de GMO-PG activa 結果通知 (notificación del resultado) y configura la URL de notificación que aparece en esta sección de los ajustes. Tiene un formato como https://your-site/wc-api/gmo_pg_webhook/. Copia la URL exactamente como aparece en los ajustes.
Las notificaciones de GMO-PG no están firmadas, por lo que el plugin nunca confía en su contenido. La notificación debe proceder de uno de tus Shop ID configurados y referirse a un pago creado por esta tienda, en el entorno en el que se pagó el pedido. El plugin solicita entonces la transacción a GMO-PG (SearchTrade) con tu Shop password y solo modifica el pedido a partir de esa respuesta. Una notificación que no coincide con una transacción real no cambia nada. Las transacciones no creadas por la tienda, por ejemplo las realizadas en la consola de GMO-PG, se acusan de recibo y se ignoran. Cuando el plugin no puede verificar una notificación, responde de forma que GMO-PG vuelva a enviarla (GMO-PG lo reintenta hasta 5 veces).
Sin la notificación, un pedido solo se confirma cuando el cliente vuelve a la tienda después de pagar.
Avanzado
Debug log: Log API requests and notifications los escribe en WooCommerce > Status > Logs, fuente wcp_gmo_payment. Los errores siempre se registran. Las contraseñas y los datos de clientes se ocultan. Por defecto: desactivado.
Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. La desactivación nunca elimina nada. Los datos de pedidos (ID de transacción) siempre se conservan. Por defecto: desactivado.
Finalización de compra
El cliente elige el método de pago (por defecto Credit card) y realiza el pedido. El plugin crea un pago de GMO-PG Link Type Plus por el total del pedido, redondeado a yenes enteros, y redirige al cliente a la página de pago de GMO-PG. Allí paga con tarjeta de crédito. GMO-PG gestiona 3-D Secure 2.0 y recibe el correo electrónico de facturación del cliente para 3-D Secure. La página de pago se abre en japonés, chino o inglés, según el idioma de tu sitio. El pago aparece en GMO-PG con WC- y el número de pedido. No se envían otros datos del cliente.
Tras pagar, el cliente vuelve a tu tienda. El resultado firmado se verifica con tu Shop password y el pedido solo se marca como pagado cuando GMO-PG lo confirma: mediante una solicitud SearchTrade del servidor al regresar el cliente, o mediante la notificación del resultado. Ambas vías usan la misma lógica, por lo que el pedido nunca se procesa dos veces. Si el pago aún no está confirmado, la página de pedido recibido muestra Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed.
Si se rechaza la tarjeta o falla el pago en la página de GMO-PG, el pedido pasa a Fallido y el cliente vuelve a la página Pay for order con el mensaje The card payment was declined or could not be completed. Please try again or use another card. Si el cliente abandona la página de GMO-PG sin pagar, la misma página muestra The payment was not completed. You can try again or choose another payment method. Cada nuevo intento cancela el enlace de pago anterior sin pagar. Si mientras tanto ya se había pagado el enlace anterior, se aplica ese pago y no se crea un enlace nuevo.
Se pueden pagar pedidos con totales de 1 a 9.999.999 JPY. Con importes superiores se oculta el método de pago. Si no se puede iniciar el pago, el cliente ve un mensaje breve, por ejemplo Card payment could not be started. Please try again or choose another payment method., y el motivo se añade a las notas del pedido.
El método de pago funciona en la finalización de compra clásica, en los bloques de Carrito y Finalizar compra y en la página Pay for order. En el bloque de Finalizar compra muestra el icono de tarjeta y la descripción. En el entorno de pruebas, tanto la finalización de compra clásica como el bloque de Finalizar compra muestran la insignia Test mode — no real charge. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
El plugin solo acepta pagos con tarjeta de crédito en JPY, siempre en la página de GMO-PG. No incluye otros métodos de pago de GMO-PG, varias monedas, tarjetas guardadas ni registro de miembros de GMO-PG, suscripciones ni facturación recurrente, ni un formulario de tarjeta en tu sitio.
Pedidos y reembolsos
Estados de los pedidos
Pending payment: se ha redirigido al cliente a GMO-PG y aún no ha pagado, o GMO-PG aún no ha confirmado el pago.
Processing or Completed: el pago se ha confirmado. El estado sigue el ajuste Order status after payment. La nota del pedido muestra el importe, el estado de GMO-PG, la transacción y cómo se confirmó (notificación o retorno). El ID de transacción es el TranID de GMO-PG.
On hold (authorized): con Authorize only (仮売上) se ha autorizado el importe. Captúralo con la acción del pedido Capture payment (GMO-PG) o en la consola de GMO-PG antes de que caduque la autorización. Tras la captura, el pedido pasa a Procesando o Completado. Si se cancela la autorización en GMO-PG, se cancela el pedido.
On hold after payment: GMO-PG ha comunicado un importe distinto al total del pedido, o el pago llegó después de haberse cancelado el pedido. La nota del pedido lo explica. Revisa el pedido y complétalo o reembolsa el pago.
Failed: se ha rechazado la tarjeta o no se ha completado el pago en la página de GMO-PG.
Si llega un segundo pago para un pedido ya pagado o cerrado, el pedido no cambia. Una nota te pide que reembolses el duplicado en la consola de GMO-PG.
Captura
La acción del pedido Capture payment (GMO-PG) aparece en los pedidos En espera que solo se han autorizado. Cobra el importe autorizado. Si la transacción ya no está autorizada, por ejemplo porque ya se capturó en la consola de GMO-PG, la acción añade una nota con el estado actual y actúa según ese estado.
Reembolsos
Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Credit card (el botón muestra tu Title). Se admiten reembolsos totales y parciales, en yenes enteros. Reembolsar todo el importe restante cancela la transacción de GMO-PG, y GMO-PG decide si se trata de una anulación o de una devolución. Un reembolso parcial reduce el importe de la transacción y la entidad de la tarjeta autoriza el nuevo importe. El reembolso se envía al entorno en el que se pagó el pedido, por lo que deben estar configurados su Shop ID y su Shop password. Si GMO-PG no acepta el reembolso, WooCommerce muestra el error y no se registra ningún reembolso. Los reembolsos correctos se añaden a las notas del pedido.
Los reembolsos y las cancelaciones realizados en la consola de GMO-PG llegan mediante la notificación del resultado y se añaden a las notas del pedido. No se registran automáticamente como reembolsos de WooCommerce. Si es necesario, crea un reembolso manual en WooCommerce sin el botón de GMO-PG.
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 > GMO Payment Gateway — Credit Card. 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, el método de pago 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 con sesión iniciada 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 y las capturas funcionan.
Cuando caduca una licencia, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se comprueba de nuevo automáticamente en segundo plano.
Solución de problemas
La tarjeta de crédito no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable/Disable esté activado, que la moneda de la tienda sea JPY y que el entorno actual tenga su Shop ID, Shop password y Config ID. Los pedidos con totales superiores a 9.999.999 JPY no se pueden pagar con tarjeta. La página de ajustes muestra una advertencia si la moneda o las credenciales son incorrectas.
El pago se ha realizado, pero el pedido sigue en Pending payment: la notificación del resultado no funciona. En la consola de la tienda de GMO-PG del entorno que uses, comprueba que 結果通知 esté activado y que la URL sea exactamente la que aparece en los ajustes. Comprueba que estén introducidos el Shop ID y la Shop password de ese entorno, ya que el plugin los usa para verificar cada notificación. Activa Debug log y consulta WooCommerce > Status > Logs, fuente wcp_gmo_payment. El pedido también se confirma cuando el cliente vuelve a la tienda después de pagar.
El registro muestra Notification rejected: unknown ShopID: la notificación procede de una tienda cuyo Shop ID no está en los ajustes. Introduce el Shop ID de ese entorno.
El registro muestra Notification ignored ... is not a payment of this store: la transacción no fue creada por esta tienda, por ejemplo se realizó en la consola de GMO-PG. No es necesario hacer nada.
El registro indica que el pedido se pagó en otro entorno: los pagos de pruebas y de producción se mantienen separados. Una notificación de pruebas nunca confirma un pedido de producción, ni a la inversa.
El cliente ve un error al realizar el pedido: abre las notas del pedido o activa Debug log. La nota muestra el código de error de GMO-PG (ErrCode, ErrInfo). La causa suele ser un Shop ID, una Shop password o un Config ID incorrectos. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. significa que el pedido no está en JPY.
El pedido está On hold después del pago: lee la nota del pedido. El pedido solo se ha autorizado y espera la captura, el importe pagado era distinto al del pedido, o el pago llegó después de cancelarse el pedido.
El reembolso falla: lee el mensaje. Puede que el pedido se pagara en el otro entorno y no estén configurados su Shop ID y su contraseña, que la transacción ya esté cancelada en GMO-PG o que el importe supere lo que queda en la transacción.
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 ha cambiado la dirección del sitio, haz clic en Check now para activar la clave para el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Al desactivar el plugin se conservan 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. Los ajustes de la pasarela y los registros solo se eliminan si Delete data on uninstall estaba activado. De lo contrario, se conservan para una reinstalación posterior. Los datos de GMO-PG almacenados en los pedidos forman parte del historial de pagos y siempre se conservan. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
GMO Payment Gateway es una marca comercial de su respectivo propietario. Este plugin no está afiliado a GMO Payment Gateway ni cuenta con su respaldo.