VibeFox Moneris for OpenCart — Ayuda

Requisitos

OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posteriores (probado en 4.1.0.3).

PHP: 8.0 o posterior.

Moneda: 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 de la finalización de compra es la moneda de la cuenta.

HTTPS y PCI DSS: los números de tarjeta se introducen en la 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, utiliza en su lugar 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 solo dominio.

Instalación

La descarga es un único archivo zip con los paquetes para ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 wcp_moneris_gateway-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_moneris_gateway.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.

OpenCart 3

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_moneris_gateway-oc3-(version).ocmod.zip. La extensión no tiene modificaciones OCMOD, por lo que Extensions > Modifications no necesita actualizarse. En lugar del instalador, también puedes copiar el contenido de la carpeta upload de este paquete en la carpeta raíz de tu tienda.

2. Ve a Extensions > Extensions, elige el tipo Payments, busca VibeFox Moneris Gateway y haz clic en Install (el botón verde +). Tu usuario administrador necesita el permiso para modificar la lista de extensiones de pago.

3. Haz clic en Edit (el botón del lápiz) para abrir la página de configuración. Pega tu clave de licencia de VibeFox en License key, en el bloque de licencia de la parte superior de la página, y haz clic en Activate (consulta License key).

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 el tipo de transacción y los logotipos de tarjetas; después, activa Enable / Disable y haz clic en Save.

6. Realiza un pedido de prueba con una tarjeta de prueba de Moneris y, después, desactiva Test mode.

OpenCart 4

1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_moneris_gateway.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión del nombre del archivo, y un paquete renombrado no funciona.

2. El paquete aparece en la lista de extensiones instaladas, en la misma página. Haz clic en Install (el botón verde +) junto a él.

3. Ve a Extensions > Extensions y elige el tipo Payments. Busca VibeFox Moneris Gateway, haz clic en Install (el botón verde +) y después en Edit (el botón del lápiz).

4. Introduce la clave de licencia y los ajustes como en los pasos 3 a 6 para OpenCart 3. La página de ajustes y sus campos son los mismos en ambas versiones.

Una instalación nueva empieza con el método de pago desactivado y el modo de prueba activado.

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Payments > VibeFox Moneris Gateway > Edit. Las secciones aparecen a la izquierda; el botón Save situado debajo de la lista guarda toda la página. Encima de los ajustes, 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, te avisa cuando 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 cuando SSL no está activado en la tienda (en OpenCart 4, cuando la dirección de la tienda empieza por http://). También te avisa cuando el método de pago está activado pero el Store ID o el API Token del modo actual están vacíos, y cuando la moneda predeterminada de la tienda no es la moneda de la cuenta de Moneris; en ambos casos, el método de pago se oculta en la finalización de compra. Sin el permiso para modificar la extensión, la página muestra los ajustes pero no permite guardarlos.

Al guardar, Title debe tener de 1 a 128 caracteres, Sort Order debe ser un número entero y Total debe ser un número igual o mayor que 0. Si un valor es incorrecto, la página muestra el error y no se guarda nada.

Moneris

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

Title: el título del método de pago que se muestra al cliente. También es el nombre del método de pago guardado en el pedido. Predeterminado: Tarjeta de crédito (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 el paso Confirm Order. Predeterminado: Pay securely with your credit card.

Sort Order: la posición de Moneris entre los métodos de pago de la finalización de compra. Déjalo vacío o introduce un número entero.

Geo Zone: muestra el formulario de tarjeta solo para las direcciones de pago de la zona geográfica seleccionada. Predeterminado: All zones. Las zonas geográficas se configuran en System > Localisation > Geo Zones.

Total: el importe total de la finalización de compra, en la moneda predeterminada de la tienda, que debe alcanzar un pedido para que se ofrezca el método de pago. Déjalo vacío para ofrecerlo con cualquier importe.

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. Esta sección enlaza a ambos.

Moneris account country: las cuentas canadienses cobran en CAD; las cuentas de EE. UU., en USD. El método de pago solo se muestra cuando la moneda del pedido coincide. Predeterminado: Canadá (CAD).

Test mode: usa la pasarela de QA de Moneris y las credenciales de prueba; no se realiza ningún cargo real. Los reembolsos, las capturas y las anulaciones siempre se envían 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. Predeterminado: 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.). Predeterminado: store5.

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

Los API Token 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. Para eliminar un token guardado, marca Clear the saved token on save debajo del campo y haz clic en Save.

Pago

Transaction type: la forma en que se cobra la tarjeta. Predeterminado: 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. Predeterminado: Visa y Mastercard.

Pedidos

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido ausente). El pedido recibe un estado solo después de que Moneris haya respondido. Cada campo siguiente muestra tus estados de pedido de OpenCart.

Order Status After Payment: la tarjeta fue cobrada (una compra, o la captura de una preautorización). Predeterminado: En proceso.

Authorized Status: una preautorización: los fondos solo están reservados, todavía no se han cobrado. Captúralos en la pestaña del pedido o asignando un estado de pagado. Predeterminado: Pendiente.

On Hold (Review) Status: se requiere revisión manual: el importe que procesó Moneris es distinto del pedido, o Moneris no respondió y la comprobación de estado también falló (es posible que la tarjeta se haya cobrado). Una nota explica por qué. Predeterminado: Pendiente, porque OpenCart no tiene un estado En espera. Puedes crear tus propios estados en System > Localisation > Order Statuses y seleccionarlos aquí y en Authorized Status.

Canceled Status: lo establece Void pre-authorization (cancel order) en la pestaña del pedido. Asignar este estado a un pedido libera (anula) una preautorización no capturada. Predeterminado: Cancelado.

Refunded Status: se establece cuando el pago se reembolsa por completo desde la pestaña del pedido. Asignar este estado a un pedido también libera una preautorización no capturada. Predeterminado: Reembolsado.

Avanzado

Debug log: registra las solicitudes y respuestas de la API en wc_mng_debug.log.php, en la carpeta de registros de OpenCart (storage/logs). 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, incluso con esta opción desactivada. Predeterminado: 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 la extensión se eliminan los ajustes de la pasarela y el registro. Los datos de Moneris de los pedidos (necesarios para las capturas y los reembolsos) siempre se conservan. Predeterminado: desactivado.

Importar / Exportar

Export: Download JSON guarda los ajustes en un archivo JSON. Los API Token no se exportan.

Import: pega el JSON exportado previamente y haz clic en Import para restaurar los ajustes. Los API Token guardados se conservan.

Finalización de compra

En el paso Payment Method, el cliente elige el método de pago (por defecto, Credit card (Moneris)). En el paso Confirm Order, el cliente ve tu descripción, los logotipos de las tarjetas y los campos Card number, Expiry (MM/YY) y Card code (CVC). Los tres campos son obligatorios. En OpenCart 4, el cliente elige el método de pago con el botón Choose del bloque del método de pago, en la ventana Payment method options; después, los campos de la tarjeta aparecen en el bloque de confirmación del pedido, al final de la página de finalización de compra, encima del botón Confirm Order. Cuando el cliente hace clic en Confirm Order, tu servidor envía la tarjeta a Moneris por el total del pedido y obtiene el resultado al instante. No hay redirección ni webhook. Los datos de la tarjeta se usan solo para esta solicitud; nunca se almacenan, y el registro solo muestra los últimos cuatro dígitos.

El pedido solo recibe su estado a partir de una respuesta aprobada de Moneris, de la forma habitual de OpenCart, con los correos electrónicos de pedido habituales y la actualización del stock. El carrito se vacía y el cliente ve la página de éxito del pedido de OpenCart. Con la preautorización, el pedido espera en el Authorized Status hasta que captures los fondos. Si Moneris procesó un importe distinto del total del pedido, el pedido recibe el estado de revisión con una nota.

Si la tarjeta es rechazada, el cliente permanece en el paso Confirm Order con Your card was declined y el motivo que indica Moneris, y puede revisar los datos de la tarjeta o usar otra. El pedido no conserva ningún estado; el motivo del rechazo también se escribe en el registro. Si Moneris no pudo procesar la solicitud (por ejemplo, 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 escribe en el registro. Los campos de tarjeta incorrectos generan mensajes breves, como Please enter your card details., Invalid card number. o Invalid card expiry date., y no se envía nada a Moneris.

Un segundo clic 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. OpenCart 3 crea un pedido nuevo cada vez que se muestra el paso Confirm Order, OpenCart 4 mantiene un solo pedido para la finalización de compra, y tras una tarjeta rechazada el cliente paga el mismo pedido. En ambos casos, la extensión trata todos los pedidos de un mismo carrito como un único pago: un carrito que ya se pagó, o cuyo resultado se desconoce, nunca se vuelve a cobrar, y el cliente va a la página de éxito. OpenCart 4 mantiene el pedido en la finalización de compra hasta que se muestra la página de éxito. Si ese pedido ya tiene un estado y el carrito vuelve a contener productos (por ejemplo, el pago se completó pero no se mostró la página de éxito y el cliente añadió productos), o si el pedido se canceló, reembolsó o anuló entretanto, el cliente vuelve a la página de finalización de compra, en el paso Confirm Order, y el siguiente Confirm Order paga un pedido nuevo. Encima de la página de finalización de compra, el cliente ve This order was cancelled or refunded by the store, so it cannot be paid again. Please check your cart and confirm the new order. cuando el pedido se cerró, o This order has already been paid, and your cart now holds a new purchase. Please check your cart and confirm the new order. cuando se pagó por un carrito anterior.

Si Moneris no responde (error de red o tiempo de espera agotado), la extensión envía a Moneris una comprobación de estado 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 la comprobación de estado tampoco obtiene respuesta, el pedido recibe el estado de revisión con una nota que indica el ID de pedido de Moneris, y no se invita al cliente a pagar por segunda vez. Si el pago se completó pero no se pudo asignar el estado del pedido, el cliente ve Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again.

La extensión 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 de pedido

Sin estado (pedido ausente): la tarjeta fue rechazada o no se procesó. El cliente puede volver a pagar. En Sales > Orders, estos pedidos solo se muestran con el filtro Order Status establecido en Missing Orders.

Order Status After Payment (predeterminado En proceso): la compra fue aprobada, o se capturó una preautorización. Una nota muestra el importe, el Moneris Trans ID y el recibo.

Authorized Status (predeterminado Pendiente): una preautorización fue aprobada y espera la captura.

On Hold (Review) Status (predeterminado Pendiente): el importe procesado difería del total del pedido, o Moneris no confirmó el resultado. Las notas lo explican.

Canceled Status (predeterminado Cancelado): en un pedido con preautorización, los fondos reservados se liberaron (anulación).

Refunded Status (predeterminado Reembolsado): el pago se reembolsó por completo a través de la extensión.

Las notas son entradas del History del pedido que el cliente no ve.

Pestaña VibeFox Moneris Gateway

En Sales > Orders abre un pedido pagado con Moneris. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Moneris Gateway muestra el Trans ID (y el Trans ID de la preautorización tras una captura), el Moneris order ID, el Receipt, el Transaction type y su estado (no capturado, capturado o liberado), la Account / environment con una etiqueta Test mode para los pagos de prueba, la Card con el código de autorización, los importes Authorized / charged / refunded, los botones de captura, anulación y reembolso, el historial de reembolsos y las Moneris notes del pedido. Si un pago no está confirmado, la pestaña te pide que busques el ID de pedido de Moneris en el Merchant Resource Center. La pestaña se muestra a los usuarios que tienen acceso a la extensión; la captura, la anulación y el reembolso requieren el permiso para modificar la extensión (configurado en System > Users > User Groups).

Captura y anulación

Para capturar una preautorización, haz clic en Capture payment en la pestaña y confirma Capture the pre-authorized amount through Moneris?, o cambia el estado del pedido con Add History a un estado de pagado, como Order Status After Payment u otro estado de OpenCart de proceso o completado. 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 recibe Order Status After Payment. Si Moneris rechaza la captura, el estado no cambia, no se envía ningún correo electrónico, Add History muestra el motivo en lugar de un mensaje de éxito, y una nota lo explica: Moneris: status not changed — the pre-authorization could not be captured, seguido del motivo. Las preautorizaciones de Moneris caducan al cabo de unos días, así que captúralas a tiempo.

Para liberar los fondos, haz clic en Void pre-authorization (cancel order) y confirma, o asigna al pedido el Canceled Status. Asignar al pedido el Refunded Status también libera una preautorización abierta. Si la liberación falla, una nota te pide que la liberes en el Merchant Resource Center.

Estos cambios de estado también funcionan mientras la extensión está desactivada (pero instalada), por lo que las preautorizaciones realizadas antes todavía se pueden capturar y liberar.

Reembolsos

En la pestaña VibeFox Moneris Gateway introduce el Amount (se rellena el importe que aún no se ha reembolsado), opcionalmente un Reason (optional), 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; por tanto, tras una diferencia de importe, 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 de eso, anúlala para liberar los fondos. El reembolso se envía al entorno y a la cuenta en la que se hizo el pago, por lo que las credenciales de ese modo deben seguir rellenadas. Si Moneris no acepta el reembolso, la pestaña 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 Moneris Trans ID. Un reembolso total asigna al pedido el Refunded Status; un reembolso parcial no cambia el estado. La captura, la anulación y el reembolso cambian el estado del pedido directamente, sin notificar al cliente y sin devolver productos al stock, como un cambio manual de estado.

Las devoluciones de productos en Sales > Returns no devuelven dinero a través de Moneris.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox obtenida en vibefox.net. El bloque de licencia License — VibeFox Moneris Gateway es el primer bloque de Extensions > Extensions > Payments > VibeFox Moneris Gateway > Edit, encima de los ajustes. Pega 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 aparecen la línea Product: opencart-payment-moneris y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso Modify para la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del panel de administración (se incluyen inglés y 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 una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no está disponible, la extensión sigue funcionando con el último estado conocido.

Una clave funciona en un solo dominio: la dirección de la tienda de la configuración de OpenCart. Eliminar la clave de la tienda 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 de todas formas se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Un usuario administrador que haya iniciado sesión en el panel de administración en el mismo navegador sigue viendo el método de pago en la tienda, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve la sesión de administración, así que sin una clave activa el método de pago se oculta a todos. Después de abrir la página Edit una vez, aparece un recordatorio en el Dashboard del panel de administración. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados: las capturas, anulaciones y reembolsos de pagos anteriores siguen funcionando.

Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente cuando abres el Dashboard o la página Edit del panel de administración: 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 se necesita ninguna tarea cron. Al desinstalar la extensión siempre se eliminan 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 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 finalización de compra es la moneda de la cuenta (CAD para Canadá, USD para una cuenta de EE. UU.), que la dirección de pago está en la Geo Zone seleccionada y que el pedido alcanza el Total establecido en los ajustes.

El pago se realizó, pero el pedido está en estado de revisión: la extensión no tiene webhook; el resultado procede únicamente de la respuesta de Moneris. Lee las Moneris notes de la pestaña. Si Moneris no confirmó el resultado, Moneris no respondió y la comprobación de estado también falló. Busca el ID de pedido de Moneris en el Merchant Resource Center: si la transacción aparece allí, envía el pedido (y, si hace falta, reembólsalo desde allí); si no aparece, cancela el pedido o pide al cliente que pague de nuevo. Si el importe era distinto, revisa el pedido y complétalo o reembolsa el pago.

El cliente ve This payment method is not available. Please reload the checkout page.: la sesión de finalización de compra ya no coincide con el pedido, el método de pago se desactivó entretanto, o faltan las credenciales del modo actual (o el modo real usa credenciales de prueba de Moneris).

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: consulta el campo Log de la página de la extensión. Los errores siempre se escriben; activa Debug log para ver las solicitudes 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. Además, las preautorizaciones de Moneris caducan al cabo de unos 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 establecidas, 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 objetivo de las pruebas de tarjetas. Usa las reglas eFraud o de velocidad de tu cuenta de Moneris y una extensión de CAPTCHA o de limitación de solicitudes para tu tienda.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Moneris Gateway. La clave de licencia y el estado de la licencia de esta extensión siempre se eliminan. OpenCart siempre elimina los ajustes propios de la extensión: Enable / Disable, Sort Order, Geo Zone, Total y los estados de pedido de la sección Orders, que vuelven a sus valores predeterminados al reinstalar. También se eliminan los eventos de OpenCart de la extensión, por lo que los cambios de estado ya no capturan ni liberan preautorizaciones. Si Delete data on uninstall está activado, se eliminan el resto de ajustes de la pasarela (título, descripción, país de la cuenta, modo de prueba, Store ID y API Token, tipo de transacción, logotipos de tarjetas, registro) y el registro. Si está desactivado, se conservan para una reinstalación posterior. Las transacciones y los reembolsos de Moneris siempre se conservan, por lo que los pedidos pagados antes pueden seguir capturándose o reembolsándose después de una reinstalación. Los pedidos existentes conservan sus notas de pago.

En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer después de la desinstalación, haz clic en Uninstall (el botón naranja −) junto a VibeFox Moneris Gateway en la lista de extensiones instaladas y, después, en Delete (el botón rojo de la papelera) para eliminar el paquete subido.

Moneris es una marca registrada de su titular. Esta extensión no está afiliada a Moneris ni cuenta con su respaldo.