VibeFox Moneris for WooCommerce — Ayuda

Requisitos

WordPress: 6.0 o posterior.

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

PHP: 8.0 o posterior.

Moneda de la tienda: CAD para una cuenta canadiense de Moneris, USD para una cuenta heredada de Moneris USA. La pasarela solo se muestra cuando la moneda del pedido coincide con la de la cuenta.

HTTPS y PCI DSS: los números de tarjeta se introducen en tu página de finalización de compra y pasan por tu servidor. Los pagos reales requieren HTTPS y el cumplimiento de PCI DSS SAQ D. Si no puedes cumplirlo, usa una solución de página de pago alojada.

Cuenta de Moneris: necesitas el Store ID y el API Token de tu tienda de Moneris Gateway, que encontrarás en el Moneris Merchant Resource Center > Admin > Store Settings. Para las pruebas, la tienda de prueba pública de Moneris viene rellenada por defecto. Las credenciales de prueba y las tarjetas de prueba están en el portal para desarrolladores de Moneris.

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_moneris_gateway a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Payments > Moneris > Manage, o haz clic en Settings debajo del nombre del plugin en la página 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 el país de la cuenta e introduce el Live Store ID y el Live API Token. El modo de prueba está activado por defecto y usa la tienda de prueba pública (store5 / yesguy para Canadá, monusqa002 / qatoken para EE. UU.).

6. Elige Purchase o Pre-Authorization y los logotipos de tarjeta, y luego activa Enable / Disable.

7. Haz un pedido de prueba con una tarjeta de prueba de Moneris y, después, desmarca Test mode.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Payments > Moneris. Encima de los campos, la página muestra Moneris gateway is in TEST MODE. No real charges will be made. mientras el modo de prueba está activado. En modo real, avisa si los campos reales contienen credenciales de prueba de Moneris (en ese caso, la pasarela se oculta en la finalización de compra) y si el sitio no usa HTTPS. También avisa si la moneda de la tienda no es la moneda de la cuenta de Moneris; entonces la pasarela se oculta en la finalización de compra.

General

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

Title: el nombre del método de pago que ve el cliente. Por defecto: Credit card (Moneris). En modo de prueba, se añade (Test Mode) al título en la finalización de compra.

Description: el texto que se muestra encima de los campos de la tarjeta en la finalización de compra. Por defecto: Pay securely with your credit card.

Cuenta de Moneris

Tu Store ID y tu API Token están en el Moneris Merchant Resource Center, en Admin > Store Settings. Las credenciales de prueba y las tarjetas de prueba están en el portal para desarrolladores de Moneris. La sección incluye enlaces a ambos.

Moneris account country: las cuentas canadienses cobran en CAD y las estadounidenses en USD. La pasarela solo se muestra cuando la moneda del pedido coincide. Por defecto: Canada (CAD).

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). Los reembolsos, las capturas y las anulaciones se envían siempre al entorno en el que se hizo el pago. Los clientes ven TEST MODE: use a Moneris test card, no real charges are made. encima de los campos de la tarjeta. Por defecto: activado.

Live Store ID: el Store ID de producción, por ejemplo monca01234.

Live API Token: el API Token de producción.

Test Store ID: la tienda de prueba pública de Moneris: store5 (Canadá) o monusqa002 (EE. UU.). Por defecto: store5.

Test API Token: el token de prueba público: yesguy (Canadá) o qatoken (EE. UU.). Por defecto: yesguy.

Pago

Transaction type: cómo se cobra la tarjeta. Por defecto: Purchase.

Card logos: los logotipos de las marcas de tarjeta que se muestran junto al título del método de pago: Visa, Mastercard, Discover, American Express, JCB. Las marcas aceptadas dependen de tu cuenta de Moneris. Por defecto: Visa and Mastercard.

Avanzado

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked). Los errores siempre se registran. Consulta el registro en WooCommerce > Status > Logs, origen wcp_moneris_gateway. Por defecto: desactivado.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Por defecto: desactivado.

Finalización de compra

El cliente elige el método de pago (por defecto, Credit card (Moneris)) e introduce el número de la tarjeta, la fecha de caducidad y el código de seguridad en el formulario de tarjeta de WooCommerce de tu página de finalización de compra. Al realizar el pedido, tu servidor envía la tarjeta a Moneris por el total del pedido y recibe el resultado al instante. No hay redirección ni webhook. El código de seguridad (CVD) siempre se envía, por lo que siguen aplicándose las reglas eFraud de tu tienda de Moneris.

Un pago aprobado solo se marca como pagado cuando Moneris informa de que la transacción está completa y el importe procesado coincide con el total del pedido. Después, el cliente va a la página de pedido recibido. Con Pre-Authorization, el pedido pasa a En espera hasta que captures los fondos.

Si la tarjeta es rechazada, el cliente ve Your card was declined con el motivo indicado por Moneris y puede revisar los datos de la tarjeta o usar otra. Si Moneris no pudo procesar la solicitud (por ejemplo, por un Store ID o un API Token incorrectos), el cliente ve The payment could not be processed. Please try again or use another payment method. El motivo se añade a las notas del pedido y al registro. Si se hace un segundo clic mientras se procesa un pago, se muestra A payment for this order is already being processed. Please wait a moment and check your order status before trying again. Un pedido pagado o preautorizado nunca se vuelve a cobrar.

Si Moneris no responde (error de red o tiempo de espera agotado), el plugin envía una Status Check a Moneris para saber si la transacción se completó. Si tampoco es posible, el pedido pasa a En espera con el ID de pedido de Moneris, y no se invita al cliente a pagar por segunda vez.

El método de pago funciona en la finalización de compra clásica, en el bloque Finalizar compra y en la página Pay for order. Es compatible con WooCommerce High-Performance Order Storage (HPOS).

El plugin no tiene tarjetas guardadas ni Moneris Vault, ni WooCommerce Subscriptions, ni Apple Pay, Google Pay o Interac Online, ni Moneris Checkout o Hosted Tokenization, ni 3-D Secure, AVS o Kount, ni precios en varias monedas.

Pedidos y reembolsos

Estados del pedido

Pendiente de pago: el pedido se creó y la tarjeta todavía no se ha cobrado, por ejemplo tras un intento rechazado. La nota del pedido muestra el código y el mensaje de Moneris. El cliente puede volver a pagar.

Procesando: la compra fue aprobada. Los pedidos con solo productos virtuales descargables pasan a Completado, el valor predeterminado de WooCommerce. La nota del pedido muestra el importe, el ID de transacción de Moneris y el recibo. El ID de transacción es el número de transacción de Moneris.

En espera: una preautorización fue aprobada y espera la captura, el importe procesado era distinto del total del pedido o Moneris no confirmó el resultado. La nota del pedido lo explica.

Cancelado: en un pedido preautorizado, cancelarlo libera los fondos reservados (anulación).

Captura y anulación

Para capturar una preautorización, cambia el estado del pedido a Procesando o Completado, o elige Capture Moneris pre-authorization en las acciones del pedido. Se captura el total actual del pedido menos los reembolsos; no puede superar el importe autorizado. Si Moneris rechaza la captura, el estado vuelve a En espera con una nota y no se envían los correos de pedido en proceso ni de pedido completado. Las preautorizaciones de Moneris caducan a los pocos días, así que captúralas a tiempo.

Para liberar los fondos, cancela el pedido o elige Void Moneris pre-authorization (cancel order) en las acciones del pedido. Cambiar el pedido a Reembolsado también libera una preautorización abierta. Si la liberación falla, una nota te pide liberarla en el Merchant Resource Center.

Reembolsos

Abre el pedido, haz clic en Refund, introduce el importe y haz clic en Refund via Credit card (Moneris) (el botón muestra tu Title). Se admiten reembolsos totales y parciales. Una preautorización solo se puede reembolsar después de capturarla; antes, cancela el pedido para liberar los fondos. El reembolso se envía al entorno y a la cuenta en los que se hizo el pago, por lo que las credenciales de ese modo deben estar rellenadas. Si Moneris no acepta el reembolso, WooCommerce muestra Refund failed con el motivo y no se registra ningún reembolso. Un reembolso correcto se añade a las notas del pedido con el ID de transacción de Moneris.

Clave de licencia

El plugin funciona con una clave de licencia de VibeFox obtenida en vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Payments > Moneris. 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 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 plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Moneris no se muestra a los clientes en la finalización de compra. Si se inicia un pago 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. Aparece un recordatorio en la página de Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados: las capturas, las anulaciones y los reembolsos funcionan.

Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Moneris no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable / Disable está activado y que el modo actual tiene un Store ID y un API Token. En modo real, los campos reales deben contener tus credenciales de producción, no las de prueba de Moneris. Comprueba que la moneda de la tienda (o la moneda del pedido en la página Pay for order) es la moneda de la cuenta: CAD para Canadá, USD para una cuenta de EE. UU. La página de ajustes muestra un aviso cuando la moneda no coincide.

El pago se realizó, pero el pedido sigue en Pendiente de pago o En espera: el plugin no tiene webhook; el resultado procede solo de la respuesta de Moneris. Si el pedido está En espera con una nota que indica que Moneris no confirmó el resultado, Moneris no respondió y la Status Check también falló. Busca el ID de pedido de Moneris indicado en la nota en el Merchant Resource Center: si la transacción aparece allí, envía el pedido (y reembólsalo allí si hace falta); si no aparece, cancela el pedido o pide al cliente que vuelva a pagar.

El cliente ve Payment gateway is misconfigured. Please contact the store administrator.: faltan las credenciales del modo actual, o el modo real está activado con credenciales de prueba de Moneris en los campos reales. Introduce tu Store ID y tu API Token de producción.

El cliente ve This payment method does not support the order currency.: la moneda del pedido no es la moneda de la cuenta de Moneris.

El cliente ve un error al pagar: abre las notas del pedido o activa Debug log y revisa WooCommerce > Status > Logs, origen wcp_moneris_gateway.

La captura falla: el pedido no tiene una preautorización pendiente de captura, el total del pedido es cero o el importe es superior al autorizado. Además, las preautorizaciones de Moneris caducan a los pocos días.

El reembolso, la captura o la anulación fallan con un mensaje sobre el modo o la cuenta: el pago se hizo en modo de prueba o en modo real, y las credenciales de ese modo no están configuradas, o el pago se hizo con una cuenta de Moneris del otro país. Introduce las credenciales o procesa el pago en el Merchant Resource Center.

Ataques de prueba de tarjetas: los formularios de tarjeta directos son un objetivo habitual de las pruebas de tarjetas. Activa la limitación de frecuencia de la finalización de compra de WooCommerce, un plugin de CAPTCHA y las reglas eFraud o de velocidad de tu cuenta de Moneris.

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 contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.

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. Los ajustes de la pasarela y los registros solo se eliminan si Delete data on uninstall estaba activado; si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.

Moneris es una marca registrada de su respectivo propietario. Este plugin no está afiliado a Moneris ni cuenta con su respaldo.