VibeFox MercadoPago 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 de la tienda: la moneda del país de tu cuenta de MercadoPago debe estar activada en la tienda: ARS (Argentina), BRL (Brasil), CLP (Chile), COP (Colombia), MXN (México), PEN (Perú) o UYU (Uruguay). MercadoPago cobra en la moneda de la cuenta y no convierte divisas, por lo que el método de pago solo se muestra a los clientes que paguen en esa moneda.
Cuenta de MercadoPago: necesitas una aplicación en el panel de desarrolladores de MercadoPago (Your integrations > your application > Credentials) con sus credenciales de prueba (empiezan por TEST-) y de producción (empiezan por APP_USR-): una Public Key y un Access Token para cada una. Para la comprobación opcional de la firma de las notificaciones también necesitas la firma secreta de your application > Webhooks.
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_mercadopago_gateway-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_mercadopago_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_mercadopago_gateway-oc3-(version).ocmod.zip. La extensión no tiene modificaciones OCMOD, así 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 y elige el tipo Payments. Busca VibeFox MercadoPago 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 (ver Clave de licencia).
4. Elige el Account country, introduce las credenciales de prueba y de producción y, opcionalmente, configura las notificaciones en tu aplicación de MercadoPago (ver Configuración). Comprueba que la moneda de la cuenta esté activada en System > Localisation > Currencies.
5. Activa Enable / Disable y haz clic en Save. Prueba un pago en modo de prueba con las tarjetas de prueba de MercadoPago 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_mercadopago_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 MercadoPago Gateway, haz clic en Install (el botón verde +) y luego en Edit (el botón del lápiz).
4. Introduce la clave de licencia, las credenciales y las notificaciones como en los pasos 3 a 5 de OpenCart 3. La página de configuración y sus campos son los mismos en ambas versiones. Solo la URL de notificación es distinta (consulta Notificaciones de pago (webhooks)).
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 MercadoPago 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 Test mode is on: the TEST- credentials are used and no real money is charged. mientras el modo de prueba esté activado. Avisa cuando falta la Public Key o el Access Token del modo actual (en ese caso el método de pago se oculta en la finalización de compra), cuando la moneda predeterminada de la tienda no es la moneda de tu cuenta de MercadoPago (entonces el método solo se muestra a los clientes que paguen en la moneda de la cuenta, o se oculta si la tienda no tiene esa moneda activada) y cuando las credenciales pertenecen a una cuenta de un país distinto al de Account country. Sin el permiso para modificar la extensión, la página muestra los ajustes pero no puede guardarlos.
Si guardas con un Title vacío (o de más de 128 caracteres), no se guarda nada y la página muestra Enter a title for the payment method (1 to 128 characters). Cualquier otro valor incorrecto no se guarda y conserva su valor anterior, con un error que indica el campo y termina en — the previous value was kept. Esto se aplica a una credencial que no empieza por el prefijo esperado (TEST- para los campos de prueba, APP_USR- para los de producción), a un valor de Maximum installments fuera de 1–24, a un Sort Order que no es un número entero (Sort Order must be a whole number), a un Total que no es un número igual o mayor que 0, y a una zona geográfica o un estado de pedido que no existen. Tras guardar, la extensión consulta a MercadoPago a qué país pertenece cada access token. Si no se puede comprobar el token del modo actual, si la cuenta no está en un país admitido o si el país es distinto de Account country, se muestra una advertencia. La extensión usa entonces el país de la cuenta.
MercadoPago
Enable / Disable: Enable MercadoPago card payments activa o desactiva el método de pago. El método se muestra en la finalización de compra solo cuando las credenciales del modo activo están completas y el cliente paga en la moneda de la cuenta de MercadoPago. Predeterminado: desactivado.
Title: el nombre del método de pago que ve el cliente en la finalización de compra. También es el nombre del método de pago guardado en el pedido. Predeterminado: Credit or debit card (MercadoPago). Obligatorio, hasta 128 caracteres.
Description: el texto que aparece encima de los campos de la tarjeta en el paso Confirm Order. Predeterminado: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.
Sort Order: la posición de MercadoPago entre los métodos de pago de la finalización de compra. Déjalo vacío o introduce un número entero.
Geo Zone: ofrece MercadoPago solo para 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 total de la compra, en la moneda predeterminada de la tienda, que debe alcanzar un pedido para que se ofrezca MercadoPago. Déjalo vacío para ofrecer MercadoPago con cualquier importe.
Cuenta de MercadoPago
Obtén las credenciales de tu aplicación en el panel de desarrolladores de MercadoPago: Your integrations > your application > Credentials (la página enlaza allí). Las credenciales de prueba empiezan por TEST-; las de producción, por APP_USR-.
Account country: el país de tu cuenta de MercadoPago. Determina la moneda de cobro, el idioma de los campos de la tarjeta y si se pide el documento del titular. El cliente debe pagar en la misma moneda, por ejemplo ARS para Argentina. Al guardar las credenciales, el país se comprueba con la cuenta. Predeterminado: Argentina (ARS).
Test mode: en modo de prueba se usan las credenciales TEST- y pagas con tarjetas de prueba de MercadoPago; en la finalización de compra aparece una insignia TEST MODE con Use MercadoPago test cards. No real charges.. Desactívalo para cobrar tarjetas reales con las credenciales de producción. Los reembolsos y las notificaciones siempre usan las credenciales del modo en el que se hizo el pago. Predeterminado: activado.
Test Public Key: empieza por TEST-. Se usa en el navegador para tokenizar la tarjeta.
Test Access Token: empieza por TEST-. Se usa solo en el servidor. Manténlo en secreto.
Production Public Key: empieza por APP_USR-.
Production Access Token: empieza por APP_USR-. Se usa solo en el servidor. Manténlo en secreto.
Los access tokens guardados y la firma secreta del webhook nunca vuelven a mostrarse. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Para eliminar un valor guardado, marca Clear the saved value on save debajo del campo y haz clic en Save.
Opciones de pago
Maximum installments: el número máximo de cuotas o parcelas que puede elegir el cliente, de 1 a 24. 1 = solo pago único. El límite también se aplica en el servidor. Predeterminado: 1.
Notificaciones de pago (webhooks)
Los pagos con tarjeta suelen obtener una respuesta final de inmediato. Los pagos que MercadoPago mantiene en revisión (en proceso o pendientes) se completan mediante notificaciones de MercadoPago. La extensión envía la URL de notificación con cada pago cuando tu tienda tiene una dirección pública (no localhost ni un dominio .local o .test). También puedes añadirla en your application > Webhooks, evento Payments. La URL se muestra en Notification URL en esta sección. En OpenCart 3 tiene este aspecto: https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks; en OpenCart 4, https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks. Se genera a partir de la dirección de la tienda de tu instalación de OpenCart. Copia la URL exactamente como la muestra la configuración.
Una notificación nunca se da por válida sin más. La extensión vuelve a leer el pago desde la API de MercadoPago con el access token del entorno en el que se hizo el pago y lo vincula a un intento de pago de tu tienda. Sin notificaciones, los pedidos en revisión permanecen en Awaiting MercadoPago Status hasta que los actualices a mano.
La extensión gestiona estos estados de pago de MercadoPago:
Webhook secret signature: opcional. La firma secreta que se muestra en your application > Webhooks. Si se configura, las notificaciones sin una x-signature válida se rechazan (HTTP 401).
Pedidos
OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido sin completar). Solo recibe un estado después de que MercadoPago haya respondido. Si la tarjeta es rechazada, el pedido queda sin estado (una nota explica el motivo) y el cliente permanece en el paso Confirm Order. Cada uno de los campos siguientes muestra tus estados de pedido de OpenCart.
Order Status After Payment: MercadoPago aprobó el pago y su importe y moneda coinciden con el pedido. Predeterminado: Procesando.
Awaiting MercadoPago Status: el pago está en revisión en MercadoPago (en proceso o pendiente); la notificación completa el pedido. Predeterminado: Pendiente.
On Hold (Review) Status: MercadoPago aprobó un importe o una moneda distintos a los del pedido, o devolvió un estado inesperado. Una nota explica qué revisar en el panel de MercadoPago. Predeterminado: Pendiente, porque OpenCart no tiene el estado On hold. Puedes crear tus propios estados en System > Localisation > Order Statuses para distinguir los pedidos en espera de los pedidos en revisión.
Payment Failed Status: un pago que estaba en revisión fue rechazado o cancelado por MercadoPago. Predeterminado: Fallido.
Cancelled Status: un pedido en este estado (o en el estado de reembolsado) está cerrado: una aprobación tardía de MercadoPago solo añade una nota. Predeterminado: Cancelado.
Refunded Status: el pago se reembolsa en su totalidad desde la página del pedido. Los reembolsos parciales solo añaden una nota. Predeterminado: Reembolsado.
Avanzado
Debug log: escribe las solicitudes y notificaciones de MercadoPago en wc_mpg_debug.log.php en la carpeta de registros de OpenCart (storage/logs). El archivo no se puede abrir desde la web. Los errores siempre se registran, incluso con este ajuste desactivado. Los access tokens, los tokens de tarjeta y los datos del pagador no se registran. Predeterminado: 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 la extensión se eliminan los ajustes de la pasarela y el registro. Los registros de pagos de MercadoPago y los reembolsos siempre se conservan, así que los pedidos pagados antes se pueden reembolsar tras una reinstalación. Predeterminado: desactivado.
Importar / Exportar
Export: Download JSON guarda los ajustes en un archivo JSON. Los access tokens y la firma secreta del webhook no se exportan.
Import: pega el JSON exportado previamente y haz clic en Import para restaurar los ajustes. Las claves secretas guardadas se conservan.
Finalización de compra
En el paso Payment Method el cliente elige el método de pago (por defecto Credit or debit card (MercadoPago)). OpenCart crea el pedido en el paso Confirm Order, todavía sin estado. Allí el cliente ve tu descripción y rellena los campos de la tarjeta: Card number, Expiry (MM/YY), Security code y Cardholder name. Según el país y la tarjeta, el cliente también elige Document type e introduce Document number, selecciona el Card issuer y el número de Installments. Las opciones de cuotas y los intereses los proporciona MercadoPago para el total del pedido.
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. Los campos de la tarjeta aparecen entonces en el bloque de confirmación del pedido al final de la finalización de compra, encima del botón Confirm Order.
Cuando el cliente hace clic en Confirm Order, MercadoPago convierte la tarjeta en un token de un solo uso y tu tienda crea el pago en el servidor por el total del pedido en la moneda del pedido. El correo electrónico y el nombre del cliente, así como el documento, se envían a MercadoPago; el pago aparece como Order #, el número del pedido y el nombre de tu tienda. Los importes en CLP y COP se cobran sin decimales.
Un pago aprobado establece el estado del pedido de la forma estándar de OpenCart, con los correos habituales del pedido y la actualización del stock; el carrito se vacía y el cliente ve la página de éxito del pedido de OpenCart. Un pago en revisión establece Awaiting MercadoPago Status, y la página también muestra MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. Un pedido en estado de revisión muestra Your payment is being reviewed. We will update your order as soon as the review is complete.
Una tarjeta rechazada deja el pedido sin estado. El cliente permanece en el paso Confirm Order con un motivo breve, por ejemplo Your card has insufficient funds. Please use another card or payment method. o Please check the security code of your card. El cliente puede corregir los datos o usar otra tarjeta; se crea un nuevo token de tarjeta en cada intento. Si faltan datos de la tarjeta, aparece Please fill in all card fields.
Si MercadoPago no responde, el cliente ve We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. El siguiente intento primero busca el pago, de modo que la tarjeta no se cobre dos veces. Si el cliente hace un segundo clic mientras el carrito se está pagando, aparece This order is already being paid. Please wait a moment and check your e-mail before trying again. OpenCart 3 crea un pedido nuevo cada vez que se muestra el paso Confirm Order, OpenCart 4 mantiene un pedido para la finalización de compra, y tras una tarjeta rechazada el cliente paga el mismo pedido. En ambos casos, un carrito con un pedido pagado o en espera nunca se vuelve a cobrar; el cliente pasa 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 se ha cerrado sin pago mientras tanto (por ejemplo, lo has cancelado), no se cobra y el cliente ve Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. Si el pedido ya está realizado y el carrito ha cambiado desde entonces, el mensaje es Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. Un cambio en el carrito, incluida una nueva cantidad, cuenta como un carrito nuevo que necesita su propio pago.
La URL de notificación también funciona mientras la tienda está en modo de mantenimiento: OpenCart 3 deja pasar las solicitudes de las extensiones de pago, y en OpenCart 4 la extensión añade una acción de inicio para ella.
La extensión solo acepta tarjetas de crédito y débito. No tiene redirección a Checkout Pro, ni billetera ni saldo de la cuenta de MercadoPago, ni pagos en efectivo (Rapipago, OXXO, boleto y otros), ni Pix, PSE o Yape, ni tarjetas guardadas o suscripciones, ni autorización y captura por separado, ni desafío 3-D Secure, ni conversión de moneda.
Pedidos y reembolsos
Estados de pedido
No status (missing order): la tarjeta fue rechazada, o MercadoPago todavía no ha respondido. En Sales > Orders estos pedidos solo se muestran con el filtro Order Status configurado en Missing Orders.
Order Status After Payment (default Procesando): MercadoPago aprobó el pago y el importe y la moneda coinciden con el pedido. Una nota muestra el ID del pago, el entorno y el número de cuotas.
Awaiting MercadoPago Status (default Pendiente): el pago está en revisión (en proceso o pendiente) y espera la notificación de MercadoPago. El pedido pasa a Order Status After Payment cuando MercadoPago lo aprueba.
On Hold (Review) Status (default Pendiente): el importe o la moneda aprobados difieren del pedido, o MercadoPago devolvió un estado inesperado. La nota lo explica. Revisa el pedido y complétalo o reembolsa el pago.
Payment Failed Status (default Fallido): un pago en revisión fue rechazado o cancelado. La nota muestra el estado y su detalle.
Refunded Status (default Reembolsado): el pago se reembolsó en su totalidad mediante la extensión.
Si MercadoPago aprueba un pago de un pedido que ya está cancelado o reembolsado, el estado no cambia y una nota te pide que completes el pedido o reembolses el pago. Si llega otro pago para un pedido o un carrito que ya está pagado, una nota te pide que reembolses el pago extra en el panel de MercadoPago.
Las notas son entradas del History del pedido que el cliente no ve.
Pestaña VibeFox MercadoPago Gateway
En Sales > Orders abre un pedido pagado con MercadoPago. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox MercadoPago Gateway muestra el Payment ID, el Status del pago, el Environment (una etiqueta Test para los pagos de prueba), las Installments, los importes Charged / order, el importe Refunded, el formulario de reembolso, el historial de reembolsos y las MercadoPago notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.
Reembolsos
En la pestaña VibeFox MercadoPago Gateway introduce el Amount (se rellena el importe aún no reembolsado), opcionalmente un Reason (optional), y haz clic en Refund via MercadoPago. Confirma la pregunta Refund this amount through MercadoPago? This cannot be undone. Se admiten reembolsos totales y parciales. Necesitas el permiso para modificar la extensión (se configura en System > Users > User Groups). Los reembolsos se limitan al importe que MercadoPago cobró, así que tras una diferencia de importe puedes reembolsar hasta lo que el cliente realmente pagó, no el total del pedido. El reembolso se envía con las credenciales del entorno en el que se hizo el pago (prueba o producción), por lo que el access token de ese entorno debe estar configurado. Si MercadoPago rechaza el reembolso, la pestaña muestra MercadoPago refused the refund con el motivo y no se registra ningún reembolso. Un reembolso aprobado o en proceso se añade al historial de reembolsos y a las notas, con el ID del reembolso. Un reembolso total pone el pedido en Refunded Status sin notificar al cliente y sin devolver productos al stock, igual que un cambio manual de estado. Un reembolso parcial no cambia el estado.
Las devoluciones de productos en Sales > Returns no devuelven dinero a través de MercadoPago.
Los reembolsos, contracargos y mediaciones realizados en el panel de MercadoPago llegan mediante la notificación y se añaden a las notas. El estado del pedido no cambia automáticamente. Actualízalo manualmente si es necesario.
Clave de licencia
La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox MercadoPago Gateway es el primer bloque de Extensions > Extensions > Payments > VibeFox MercadoPago 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-mercadopago 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 el inglés y el 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 seguido de una fecha. Tras cambiar la dirección de la tienda, o tras 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 dominio: la dirección de la tienda de la configuración de OpenCart. Quitar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, MercadoPago 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. 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 el inicio de sesión del administrador, así que, sin una clave activa, el método de pago se oculta para 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: los pagos ya iniciados se siguen confirmando y los reembolsos funcionan.
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 al abrir el Dashboard o la página Edit del panel de administración: 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 ninguna tarea cron. Desinstalar la extensión siempre elimina la clave de licencia y el estado de la licencia.
Solución de problemas
MercadoPago no aparece en la finalización de compra: comprueba que la licencia esté activa, que Enable / Disable esté activado y que el modo actual tenga ambas credenciales con el prefijo correcto: las claves TEST- en modo de prueba, las claves APP_USR- en producción. Comprueba que el cliente paga en la moneda de tu cuenta de MercadoPago (la moneda debe estar activada en la tienda), que la dirección de pago esté en la Geo Zone seleccionada y que el pedido alcance el Total configurado. La página de ajustes indica cuál falta.
El pago se realizó, pero el pedido sigue en Awaiting MercadoPago Status: la notificación no llegó. La extensión envía la URL de notificación solo cuando tu tienda tiene una dirección pública (no localhost ni un dominio .local o .test). Añade la URL de Notification URL en your application > Webhooks con el evento Payments. Si Webhook secret signature está configurado, comprueba que sea la firma secreta de la misma aplicación. El panel de MercadoPago muestra la respuesta de tu tienda para cada notificación.
La notificación devuelve invalid signature: la firma secreta pertenece a otra aplicación, o la notificación no tiene una x-signature válida. Copia la firma secreta de nuevo o deja el campo vacío.
La notificación devuelve no credentials for test o no credentials for live: el access token del entorno en el que se hizo el pago no está configurado. Introdúcelo; MercadoPago reintenta la notificación.
La notificación devuelve not for this store: el pago no pertenece a un intento de pago de esta tienda. No se modifica ningún pedido.
La notificación devuelve order busy or payment could not be read: el pedido estaba siendo actualizado por otra solicitud en ese mismo momento, o no se pudo contactar con MercadoPago. MercadoPago reintenta la notificación automáticamente.
Una credencial no se guarda: el error must start with indica que el valor tiene un prefijo incorrecto para ese campo. Los campos de prueba aceptan credenciales TEST-; los campos de producción, credenciales APP_USR-.
El cliente ve «This payment method is not configured correctly. Please choose another payment method or contact the store.»: faltan las credenciales del modo actual, tienen el prefijo incorrecto o MercadoPago las rechazó. Revísalas en la página de ajustes.
El cliente ve «MercadoPago cannot process payments in»: la moneda del pedido no es la moneda de tu cuenta de MercadoPago. MercadoPago no convierte monedas.
El formulario seguro de tarjeta no se carga: el cliente ve The secure card form could not be loaded. Please reload the page or choose another payment method. Revisa la Public Key del modo actual.
El cliente ve «Your session has expired. Please reload the page and try again.»: el formulario de tarjeta ya no pertenece a la sesión de finalización de compra del cliente. El cliente recarga la página de finalización de compra.
El cliente ve «Your payment was received, but the order could not be completed automatically»: MercadoPago cobró el pago, pero OpenCart no pudo establecer el estado del pedido. Revisa el campo Log de la página de la extensión: los errores siempre se registran. Se pide al cliente que no pague de nuevo; el siguiente intento de pago o la siguiente notificación del carrito establece el estado sin un nuevo cobro.
El pedido está en estado de revisión tras el pago: lee las MercadoPago notes en la pestaña del pedido (ver Estados de pedido) y después completa el pedido o reembolsa el pago.
El reembolso falla con un mensaje sobre el modo: el pago se hizo en modo de prueba o de producción, y el access token de ese modo no está configurado. Introdúcelo y vuelve a intentarlo.
El reembolso falla con MercadoPago did not answer the refund request: revisa el pago en el panel de MercadoPago antes de volver a intentarlo.
Desinstalación
Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox MercadoPago 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 en una reinstalación. También se elimina el evento de OpenCart de la extensión (en OpenCart 4, también su acción de inicio, que deja pasar las notificaciones en modo de mantenimiento). 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, credenciales, cuotas, firma secreta del webhook y registro), la comprobación de cuenta guardada y el registro. Si está desactivado, se conservan para una reinstalación posterior. Los registros de pagos de MercadoPago y los reembolsos siempre se conservan, así que los pedidos pagados antes se pueden reembolsar tras 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 y haz clic en Uninstall (el botón naranja −) junto a VibeFox MercadoPago Gateway en la lista de extensiones instaladas; después, haz clic en Delete (el botón rojo de papelera) para eliminar el paquete subido.
MercadoPago es una marca comercial de su respectivo titular. Esta extensión no está afiliada ni respaldada por MercadoPago.