VibeFox GMO 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.

Moneda: yen japonés (JPY). GMO-PG cobra solo en yenes, así que el método de pago se muestra solo cuando la moneda del carrito es JPY. Añade JPY en International > Localization > Currencies si tu tienda aún no lo tiene.

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 la notificación de resultado (結果通知) activada en la consola de la tienda de GMO-PG (ver Configuración). El Site ID y la Site password no se usan.

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 GMO Payment Gateway más tarde 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. Introduce el Shop ID, la Shop password y el Config ID del entorno de pruebas y/o de producción, y elige el Environment.

5. En la consola de la tienda de GMO-PG, activa 結果通知 (notificación de resultado) y configura la URL de notificación que aparece en los ajustes (ver Configuración).

6. Activa Enable/Disable y haz clic en Save. Haz un pago de prueba en el entorno de pruebas y, después, cambia Environment a producción.

Al instalarse, el módulo crea el estado de pedido GMO-PG payment on hold. PrestaShop ofrece un nuevo módulo de pago para todas las monedas, países y grupos de clientes. Puedes limitarlos en Payment > Preferences; JPY debe seguir permitido.

Configuración

Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox GMO Payment Gateway > Configure. Cada botón Save guarda la página completa. Encima de los campos, la página te avisa si la moneda predeterminada de la tienda no es JPY y si falta el Shop ID, la Shop password o el Config ID del entorno actual (en ese caso, el método de pago se oculta en el checkout). También muestra qué entorno está activo: TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. o PRODUCTION — payments go to p01.mul-pay.jp. Los espacios alrededor de las credenciales se eliminan al guardar.

GMO Payment Gateway — Credit Card

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 se muestra en el checkout. También es el nombre del método de pago que se guarda en el pedido. Por defecto: Credit card. Obligatorio.

Description: el texto que se muestra debajo del método de pago en el checkout. 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 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 distintas.

Environment: qué entorno de GMO-PG recibe los pagos nuevos.

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 config ID de Link Type Plus (設定ID) registrado en la consola de GMO-PG.

Test Shop ID: el Shop ID del entorno de pruebas.

Test Shop password: la Shop password del entorno de pruebas.

Test Config ID: el config ID de Link Type Plus (設定ID) del entorno de pruebas.

Las contraseñas 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 passwords: marca una contraseña y haz clic en Save para eliminarla. Un campo vacío conserva el valor guardado.

Payment

Capture: cuándo se cobra la tarjeta.

Order status after payment: el estado de un pedido pagado.

Notificaciones de pago (結果通知)

La notificación de resultado informa a tu tienda de que se ha realizado un pago. Es obligatoria. En la consola de GMO-PG, activa 結果通知 (notificación de resultado) y configura la URL que aparece en Notification URL en esta sección. Con URLs amigables tiene este aspecto: https://your-shop/module/wcp_gmo_payment/notify, posiblemente con un código de idioma como /ja/. Copia la URL exactamente como aparece en los ajustes. Debe ser accesible desde Internet; el modo de mantenimiento no la bloquea.

Las notificaciones de GMO-PG no van firmadas, así que el módulo nunca confía en su contenido. La notificación debe proceder de uno de los Shop ID configurados y hacer referencia a un pago creado por esta tienda, en el entorno en el que se hizo el pago. Después, el módulo pide a GMO-PG la transacción (SearchTrade) con tu Shop password y solo modifica el carrito o el pedido según esa respuesta. Una notificación que no corresponde a una transacción real no cambia nada. Las transacciones no creadas por la tienda, por ejemplo las hechas en la consola de GMO-PG, se confirman y se ignoran. Cuando el módulo no puede verificar una notificación, responde de forma que GMO-PG la envíe de nuevo (GMO-PG reintenta hasta 5 veces).

Sin la notificación, el pedido solo se crea cuando el cliente vuelve a la tienda después de pagar.

Advanced

Debug log: escribe las solicitudes a la API y las notificaciones en logs/gmo_pg_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores siempre se registran, aunque el interruptor esté desactivado. Las contraseñas y los datos del cliente se enmascaran. Por defecto: desactivado.

Log: muestra el tamaño y las entradas más recientes del registro. Haz clic en Clear log para vaciarlo.

Delete data on uninstall: si está activado, al desinstalar el módulo se eliminan los ajustes de la pasarela y el registro. Los datos de los pedidos (GMO OrderID, IDs de transacción) siempre se conservan. Por defecto: desactivado.

Checkout

En el paso de pago, el cliente elige el método de pago (por defecto, Credit card) y ve su descripción. En el entorno de pruebas, encima aparece la insignia TEST — GMO-PG test environment, no real charges.. Al confirmar, el módulo crea un pago de GMO-PG Link Type Plus por el total del carrito, redondeado a yenes enteros, y envía al cliente a la página de pago de GMO-PG. Allí el cliente paga con tarjeta de crédito. GMO-PG gestiona el 3-D Secure 2.0, y el correo electrónico del cliente se envía a GMO-PG para el 3-D Secure. La página de pago se abre en japonés, chino o inglés, según el idioma del cliente. El pago aparece en GMO-PG con PS- y el número del carrito. No se envían otros datos del cliente. En este punto todavía no existe ningún pedido.

Tras pagar, el cliente vuelve a tu tienda. El resultado firmado se verifica con la Shop password del entorno del pago, y el pedido solo se marca como pagado cuando GMO-PG lo confirma: mediante una solicitud SearchTrade desde el servidor cuando el cliente regresa, o mediante la notificación de resultado. Ambos usan la misma lógica, así que el pedido nunca se crea dos veces. Después, el cliente ve la página estándar de confirmación del pedido. Si GMO-PG aún no ha confirmado el pago, aparece una página de Payment confirmation con el mensaje Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. y un botón Check again; la notificación crea el pedido en cuanto llega.

Si la tarjeta es rechazada o el pago falla en la página de GMO-PG, el cliente vuelve al checkout con el mensaje The card payment was declined or could not be completed. Please try again or use another card.. Si el cliente sale de la página de GMO-PG sin pagar, el mensaje es The payment was not completed. You can try again or choose another payment method.. El carrito se conserva. Cada nuevo intento cancela el enlace de pago anterior no pagado. Si, mientras tanto, el enlace anterior ya se ha pagado, el pedido se crea a partir de ese pago y no se genera un enlace nuevo.

Se pueden pagar totales de carrito de entre 1 y 9.999.999 JPY. Los totales mayores ocultan el método de pago. Si el pago no puede iniciarse, el cliente se queda en el checkout con un mensaje breve, por ejemplo Card payment could not be started. Please try again or choose another payment method., y el motivo se escribe en el registro.

La notificación y el regreso funcionan mientras la tienda está en modo de mantenimiento y no se ven afectados por la restricción de países de tu tienda.

El módulo acepta pagos con tarjeta de crédito solo en JPY, siempre en la página de GMO-PG. No incluye otros métodos de pago de GMO-PG, ni varias monedas, ni tarjetas guardadas ni registro de miembros de GMO-PG, ni suscripciones ni cobros recurrentes, ni un formulario de tarjeta en la propia tienda.

Pedidos y reembolsos

Estados del pedido

Sin pedido todavía: el cliente fue enviado a GMO-PG y no ha pagado, o GMO-PG aún no ha confirmado el pago. Solo existe el carrito.

Payment accepted o Delivered: el pago fue confirmado. El estado sigue a Order status after payment. El pago se registra con el TranID de GMO-PG como ID de transacción, y una nota muestra el importe, el estado de GMO-PG, la transacción y cómo se confirmó (notificación o regreso).

GMO-PG payment on hold (autorizado): con Authorize only (仮売上) el importe fue autorizado. Captúralo con Capture payment (GMO-PG) o en la consola de GMO-PG antes de que caduque la autorización. Después de la captura, el pedido pasa a Payment accepted o Delivered. Si la autorización se cancela en GMO-PG, el pedido pasa a Canceled.

GMO-PG payment on hold después del pago: GMO-PG informó de un importe distinto al total del carrito, o el carrito no estaba en JPY. La nota lo explica, y el pago se registra por el importe que GMO-PG cobró realmente. Revisa el pedido y prepáralo o reembolsa el pago.

Refunded: el pago fue reembolsado por completo a través del módulo. Un reembolso total de una autorización que nunca se capturó pone el pedido en Canceled.

Si llega un segundo pago para un carrito cuyo pedido ya está pagado o cerrado, el pedido no se modifica. Una nota te pide que reembolses el duplicado en la consola de GMO-PG.

Bloque de GMO Payment Gateway

La página del pedido muestra un bloque GMO Payment Gateway con el GMO OrderID, el Transaction ID, el estado (con el estado de GMO-PG), Paid / refunded, una insignia TEST para los pagos de prueba, el historial de reembolsos y las GMO-PG notes del pedido. Para cobrar y reembolsar se necesita el permiso de edición de pedidos; no hace falta acceso a las páginas de Módulos.

Captura

Capture payment (GMO-PG) aparece en el bloque de un pedido en espera que solo fue autorizado. Confirma Capture the authorized GMO-PG payment?. El módulo comprueba la transacción en GMO-PG y cobra el importe autorizado. Si la transacción ya no está autorizada, por ejemplo porque ya se capturó en la consola de GMO-PG, una nota muestra el estado actual y el pedido lo sigue.

Reembolsos

En el bloque, introduce el importe (se rellena el importe aún no reembolsado), opcionalmente un motivo, y haz clic en Refund via GMO-PG. Confirma Refund this amount through GMO-PG?. Se admiten reembolsos totales y parciales, en yenes enteros. El límite es el importe que GMO-PG cobró realmente y aún retiene, no el total del pedido. 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. El reembolso se envía al entorno en el que se hizo el pago, por lo que deben estar configurados el Shop ID y la Shop password de ese entorno. Si GMO-PG no acepta el reembolso, el bloque muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas. Un reembolso total pone el pedido en Refunded; un reembolso parcial no cambia el estado.

El módulo no crea notas de crédito. Los botones de reembolso estándar de PrestaShop en la página del pedido no devuelven dinero a través de GMO-PG.

Los reembolsos y cancelaciones hechos en la consola de GMO-PG llegan mediante la notificación de resultado y se añaden a las notas. El estado del pedido y las notas de crédito no cambian automáticamente, salvo en el caso de una autorización cancelada en GMO-PG. Actualízalos manualmente si hace falta.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox GMO Payment Gateway es el primer bloque de Modules > Module Manager > VibeFox GMO Payment Gateway > Configure, por 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 de ellos están la línea Product: presta-payment-gmo 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 el inglés y el 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 un 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. Quitar la clave de la tienda no libera su dominio. Libera el dominio en tu cuenta de vibefox.net.

Sin una clave activa, el pago con tarjeta de GMO-PG no se muestra a los clientes en el checkout. Si, aun así, se inicia un pago, el cliente ve This payment method is not available. Please choose another one. El front office 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 el checkout. 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, y las capturas y los reembolsos funcionan.

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 hace falta ningún cron job. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.

Solución de problemas

La tarjeta de crédito no aparece en el checkout: comprueba que la licencia está activa, que Enable/Disable está activado, que la moneda del carrito es JPY y que el entorno actual tiene su Shop ID, Shop password y Config ID. Los totales de carrito superiores a 9.999.999 JPY no se pueden pagar con tarjeta. La página de ajustes muestra un aviso si la moneda o las credenciales son incorrectas. En Payment > Preferences, comprueba que el módulo está permitido para JPY, para el país del cliente y para el grupo del cliente.

El pago se realizó, pero no se creó ningún pedido: la notificación de resultado no funciona. En la consola de la tienda de GMO-PG del entorno que usas, comprueba que 結果通知 está activado y que la URL es exactamente la que aparece en Notification URL. Comprueba que el Shop ID y la Shop password de ese entorno están rellenados, porque el módulo verifica cada notificación con ellos. Activa Debug log y revisa el campo Log de la página del módulo. El pedido también se crea 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: OrderID is not a payment of this store: la transacción no fue creada por esta tienda, por ejemplo se hizo en la consola de GMO-PG. No hace falta hacer nada.

El registro muestra que el carrito se pagó en otro entorno: los pagos de prueba y de producción se mantienen separados. Una notificación de prueba nunca confirma un pago de producción, y viceversa.

El registro muestra Cannot create the order: the module is disabled: el módulo se desactivó mientras se confirmaba un pago. Actívalo; GMO-PG volverá a enviar la notificación.

El cliente ve un error al elegir el pago con tarjeta: activa Debug log y revisa el campo Log. El registro muestra el código de error de GMO-PG (ErrCode, ErrInfo). Un Shop ID, una Shop password o un Config ID incorrectos son la causa habitual. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. significa que el carrito no está en JPY.

El pedido está en GMO-PG payment on hold: lee las notas del bloque GMO Payment Gateway. El pedido solo fue autorizado y espera la captura, o el importe pagado no coincidía con el carrito.

Falla el reembolso o la captura: lee el mensaje del bloque. El pedido puede haberse pagado en el otro entorno, cuyo Shop ID y contraseña no están configurados; la transacción puede estar ya cancelada en GMO-PG; o el importe puede superar lo que queda en la transacción. The order is being updated by GMO-PG right now. Try again in a moment. significa que se estaba procesando una notificación al mismo tiempo.

El bloque muestra You do not have permission to refund orders.: tu perfil de empleado no tiene permiso para editar pedidos. Pide a un administrador que te lo conceda.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox GMO Payment 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 de la pasarela y el registro. Si está desactivado, se conservan todos los ajustes para una reinstalación posterior. Las transacciones y los reembolsos de GMO-PG y el estado de pedido GMO-PG payment on hold siempre se conservan, así que los pedidos pagados antes pueden seguir capturándose y reembolsándose tras una reinstalación. Los pedidos existentes conservan sus notas de pago y sus IDs de transacción.

GMO Payment Gateway es una marca comercial de su respectivo titular. Este módulo no está afiliado ni respaldado por GMO Payment Gateway.