VibeFox Moneris for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior con la extensión SimpleXML. El módulo no se instala en versiones anteriores de PHP ni sin SimpleXML.
Moneda de la tienda: CAD para una cuenta canadiense de Moneris, USD para una cuenta heredada de Moneris USA. El método de pago solo se muestra cuando la moneda del carrito es la moneda 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 Moneris Merchant Resource Center > Admin > Store Settings. Para las pruebas, la tienda de prueba pública de Moneris ya viene rellenada. 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 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 más tarde VibeFox Moneris Gateway en la lista de módulos y haz clic en Configure.
3. Introduce tu clave de licencia de VibeFox en el campo License key del bloque de licencia de la parte superior de la página Configure y haz clic en Activate (véase Clave de licencia).
4. 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.).
5. Elige Purchase o Pre-Authorization y los logotipos de tarjeta, luego activa Enable / Disable y haz clic en Save.
6. Haz un pedido de prueba con una tarjeta de prueba de Moneris y luego desactiva Test mode.
Al instalarse, el módulo crea dos estados de pedido: Moneris payment authorized y Moneris payment on hold. PrestaShop habilita el nuevo módulo de pago para todas las monedas, países y grupos de clientes. Puedes limitarlo en Payment > Preferences.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Moneris Gateway > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. 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 el método de pago se oculta en la finalización de compra) y si SSL no está activado en la tienda. También avisa si la moneda predeterminada de la tienda no es la moneda de la cuenta de Moneris; el método de pago se oculta en la finalización de compra para las demás monedas.
Moneris
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. También es el nombre del método de pago guardado en el pedido. Por defecto: Credit card (Moneris). En modo de prueba se añade (Test Mode) al título. Obligatorio.
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, las estadounidenses en USD. El método de pago solo se muestra cuando la moneda del carrito coincide. Por defecto: Canada (CAD).
Test mode: usa la pasarela QA de Moneris y las credenciales de prueba; no se realiza ningún cargo real. Las capturas, anulaciones y reembolsos siempre se envían al entorno en el que se realizó 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.
Los API tokens guardados 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 cambiarlo.
Clear saved tokens: marca la casilla de un token y haz clic en Save para eliminarlo. Un campo vacío mantiene el valor guardado.
Pago
Transaction type: cómo se cobra la tarjeta. Por defecto: Purchase.
Card logos: las marcas de tarjeta que se muestran con el método de pago en la finalización de compra: Visa, Mastercard, Discover, American Express, JCB. Las marcas aceptadas dependen de tu cuenta de Moneris. Por defecto: Visa y Mastercard.
Avanzado
Debug log: registra las peticiones y respuestas de la API en logs/wc_mng_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. El número de tarjeta, el CVV, la caducidad y el API token se enmascaran. Los errores siempre se registran, también con esta opción desactivada. 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: si está activado, al desinstalar el módulo se eliminan los ajustes de la pasarela y el registro. Los datos de Moneris de los pedidos (necesarios para los reembolsos) y los estados de pedido siempre se conservan. Por defecto: desactivado.
Finalización de compra
En el paso de pago, el cliente elige el método de pago (por defecto Credit card (Moneris)) e introduce Card number, Expiry (MM/YY) y Card code (CVC) en el formulario de tarjeta que aparece debajo de la opción. Los tres campos son obligatorios. Al realizar el pedido, tu servidor envía la tarjeta a Moneris por el total del carrito y recibe el resultado al instante. No hay redirección ni webhook. Los datos de la tarjeta se usan solo para esta petición; nunca se almacenan, y el registro solo muestra los últimos cuatro dígitos.
El pedido solo se crea a partir de una respuesta aprobada de Moneris. Después, el cliente ve la página estándar de confirmación del pedido. Con Pre-Authorization, el pedido espera en Moneris payment authorized hasta que captures los fondos. Si Moneris procesó un importe distinto del total del carrito, o el carrito cambió durante el pago, el pedido se crea en Moneris payment on hold con una nota.
Si la tarjeta es rechazada, el cliente permanece en la finalización de compra con Your card was declined y el motivo indicado por Moneris, y puede revisar los datos de la tarjeta o usar otra. No se crea ningún pedido. Si Moneris no pudo procesar la petición (por ejemplo, un Store ID o API Token incorrecto), el cliente ve The payment could not be processed. Please try again or use another payment method. El motivo se escribe en el registro. Los datos de tarjeta incorrectos dan mensajes breves, como Invalid card number. o Invalid card expiry date., y no se envía nada a Moneris.
Un segundo clic o una segunda pestaña del navegador mientras se procesa un pago muestra A payment for this order is already being processed. Please wait a moment and check your order status before trying again. Un carrito que ya tiene un pedido nunca se vuelve a cobrar; el cliente es redirigido al pedido existente.
Si Moneris no responde (error de red o tiempo de espera agotado), el módulo envía a Moneris un Status Check con el mismo ID de pedido de Moneris para averiguar si la transacción se completó. Si Moneris no tiene ninguna transacción así, el cliente puede volver a pagar. Si el Status Check tampoco obtiene respuesta, el pedido se crea en Moneris payment on hold con el ID de pedido de Moneris, y no se invita al cliente a pagar por segunda vez.
El módulo no tiene tarjetas guardadas ni Moneris Vault, ni suscripciones, 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
No order yet: la tarjeta fue rechazada o no se procesó. Solo existen el carrito y el intento en el registro. El cliente puede volver a pagar.
Payment accepted: la compra fue aprobada. El pago se registra con el número de transacción de Moneris como ID de transacción.
Moneris payment authorized: la preautorización fue aprobada y espera la captura. Todavía no se registra ningún pago.
Moneris payment on hold: el importe procesado difería del total del carrito, el carrito cambió durante el pago, Moneris no confirmó el resultado o PrestaShop escribió un estado de pagado aunque la captura había fallado. Las notas lo explican. En una compra con un importe distinto, el pago se registra con el importe que procesó Moneris.
Canceled: en un pedido preautorizado, cancelar libera los fondos reservados (anulación).
Refunded: el pago fue reembolsado por completo a través del módulo.
Bloque de pago de Moneris
En la página del pedido aparece un bloque Moneris payment con el ID de pedido de Moneris, el país y el modo de la cuenta, una insignia Test mode en los pagos de prueba, el Trans ID (y el Trans ID de la preautorización tras una captura), el tipo de transacción y su estado (no capturada, capturada o liberada), el recibo y el tipo de tarjeta, el importe procesado, el total del pedido y el importe reembolsado, el historial de reembolsos y las Moneris notes del pedido. En un pago no confirmado, el bloque te pide que busques el ID de pedido de Moneris en el Merchant Resource Center. Todas las acciones del bloque solo requieren el permiso para editar pedidos.
Captura y anulación
Para capturar una preautorización, haz clic en Capture payment en el bloque y confirma, o cambia el estado del pedido a un estado de pagado como Pago aceptado, Enviado o Entregado. Se captura el total del pedido menos los reembolsos; no puede ser mayor que el importe autorizado. Tras una captura con el botón, el pedido pasa a Payment accepted; el pago se registra con el Trans ID de la captura. Si Moneris rechaza la captura, el estado no cambia, no se envía el correo electrónico de pedido pagado y una nota lo explica: Status not changed: the Moneris pre-authorization could not be captured, con el motivo. Las preautorizaciones de Moneris caducan a los pocos días, así que captúralas a tiempo.
Para liberar los fondos, haz clic en Void pre-authorization (cancel order) o cambia el pedido a Cancelado. Cambiar el pedido a Reembolsado también libera una preautorización abierta. Si la liberación falla, una nota te pide que la liberes en el Merchant Resource Center.
Reembolsos
En el bloque Moneris payment, introduce el importe (se rellena el importe que aún no se ha reembolsado), opcionalmente un motivo, y haz clic en Refund via Moneris. Confirma la pregunta Refund this amount through Moneris? This cannot be undone. Se admiten reembolsos totales y parciales. Los reembolsos están limitados al importe que Moneris cobró realmente, así que tras una diferencia de importes puedes reembolsar hasta lo que pagó el cliente, no el total del pedido. 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 realizó el pago, por lo que las credenciales de ese modo deben seguir rellenadas. Si Moneris no acepta el reembolso, el bloque muestra Refund failed con el motivo y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas con el Trans ID de Moneris. 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 Moneris.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Moneris Gateway es el primero de la página Modules > Module Manager > VibeFox Moneris 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 están la línea Product: presta-payment-moneris y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure para el 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 es aceptada, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on con una fecha. Tras cambiar la dirección de la tienda, o después de liberar un hueco de 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. Eliminar la clave de la tienda no libera su hueco de dominio. Libéralo en tu cuenta de vibefox.net.
Sin una clave activa, Moneris 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 recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados: las capturas, anulaciones y reembolsos de pagos anteriores siguen funcionando.
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 tras introducir la clave, y después una vez a la semana. No se necesita 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
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 Store ID y 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 del carrito es la moneda de la cuenta: CAD para Canadá, USD para una cuenta de EE. UU. En Payment > Preferences, comprueba que el módulo está permitido para esa moneda, el país del cliente y el grupo de clientes.
El pago se completó, pero el pedido está en Moneris payment on hold: el módulo no tiene webhook; el resultado solo llega a través de la respuesta de Moneris. Lee las Moneris notes del bloque. Si Moneris no confirmó el resultado, significa que Moneris no respondió y que el Status Check también falló. Busca el ID de pedido de Moneris en el Merchant Resource Center: si la transacción está ahí, envía el pedido (y reembólsalo allí si hace falta); si no está, cancela el pedido o pide al cliente que pague de nuevo. Si el importe fue distinto, revisa el pedido y gestiónalo, o reembolsa el pago.
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 API Token de producción.
El cliente ve This payment method does not support the order currency.: la moneda del carrito no es la moneda de la cuenta de Moneris.
El cliente ve un error al pagar: revisa el campo Log de la página del módulo. Los errores siempre se escriben; activa Debug log para ver las peticiones y respuestas completas.
La captura falla: el pedido no tiene una preautorización pendiente de captura, el total del pedido es cero, o el importe es mayor que el importe autorizado. Las preautorizaciones de Moneris también 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 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 de los ataques de prueba de tarjetas. Usa las reglas eFraud o de velocidad de tu cuenta de Moneris, y un módulo CAPTCHA o de limitación de frecuencia para tu tienda.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Moneris 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, todos los ajustes se conservan para una reinstalación posterior. Las transacciones y reembolsos de Moneris y los estados de pedido Moneris payment authorized y Moneris payment on hold siempre se conservan, así que los pedidos pagados antes pueden seguir capturándose o reembolsándose tras una reinstalación. Los pedidos existentes conservan sus notas de pago y sus ID de transacción.
Moneris es una marca comercial de su respectivo titular. Este módulo no está afiliado a Moneris ni avalado por Moneris.