VibeFox Pagar.me for OpenCart — Ayuda
Requisitos
OpenCart: 3.0.x (probado con la versión 3.0.5.0) u OpenCart 4.0.2 o posterior (probado con la versión 4.1.0.3).
PHP: 8.0 o posterior.
Currency: real brasileño (BRL). La tienda debe tener la moneda BRL (System > Localisation > Currencies), y el método de pago solo se muestra cuando el cliente finaliza la compra en BRL y el total del pedido es mayor que cero.
Pagar.me account: necesitas las claves secretas de tu cuenta de Pagar.me: la clave de prueba (sk_test_...) y, para pasar a producción, la clave de producción (sk_...). Están en el panel de Pagar.me, en Development > Keys. Solo se usan las claves secretas; la clave pública (pk_...) no es necesaria. Solo se pueden ofrecer los métodos de pago habilitados en tu cuenta de Pagar.me.
VibeFox license key: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
La descarga es un único archivo zip con los paquetes de ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 wcp_pagarme_gateway-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_pagarme_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_pagarme_gateway-oc3-(version).ocmod.zip. La extensión no tiene modificaciones OCMOD, así que Extensions > Modifications no necesita actualizarse. En lugar del instalador, 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 Pagar.me 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 con forma de lápiz) para abrir la página de ajustes. 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 la sección Clave de licencia).
4. Introduce la clave secreta de prueba y, cuando pases a producción, la clave secreta de producción.
5. Crea el webhook en el panel de Pagar.me con la URL que se muestra en los ajustes (consulta Configuración).
6. Activa Enable / Disable y haz clic en Save. Haz pagos de prueba con Test mode activado y, después, desactívalo para aceptar pagos reales.
OpenCart 4
1. En el panel de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo wcp_pagarme_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 Pagar.me Gateway, haz clic en Install (el botón verde +) y después en Edit (el botón con forma de lápiz).
4. Introduce la clave de licencia, las claves secretas y el webhook como en los pasos 3 a 6 para OpenCart 3. La página de ajustes y sus campos son iguales en ambas versiones. Solo la URL del webhook es distinta (consulta Notificaciones de pago (webhook)).
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 Pagar.me 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 el modo actual: TEST MODE (los pagos se crean con la clave secreta de prueba, sin cargos reales) o LIVE. Avisa cuando falta la clave secreta del modo actual (en ese caso el método de pago no aparece en la finalización de compra), cuando la clave de prueba no empieza por sk_test_, cuando la clave de producción no empieza por sk_ o es una clave de prueba, y cuando la moneda predeterminada de la tienda no es BRL. Sin el permiso para modificar la extensión, la página muestra los ajustes pero no permite guardarlos.
Al guardar, Title no puede estar vacío (hasta 128 caracteres), Boleto due in (days) debe ser un número entero de 1 a 30, Sort Order debe ser un número entero (se permiten los números negativos), Total debe ser un número igual o mayor que 0, y la zona geográfica y los estados de pedido deben existir. Si un valor es incorrecto, un mensaje lo indica y no se guarda nada.
Pagar.me
Enable / Disable: Enable Pagar.me payments activa o desactiva el método de pago. Predeterminado: desactivado.
Title: el nombre del método de pago que ven los clientes en la finalización de compra. También es el nombre del método de pago que se guarda en el pedido. Predeterminado: Pagar.me. Obligatorio, hasta 128 caracteres.
Description: el texto que el cliente ve en el paso Confirm Order, encima del botón de confirmación. Predeterminado: Paga de forma segura con Pagar.me (tarjeta de crédito, PIX o boleto). Serás redirigido para completar tu pago.
Sort Order: la posición de Pagar.me 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 Pagar.me 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. En OpenCart 4, cuando la tienda no pide ninguna dirección de pago, se usa la dirección de envío.
Total: el total de la compra, en la moneda predeterminada de la tienda, que debe alcanzar un pedido para que se ofrezca Pagar.me. Déjalo vacío para ofrecer Pagar.me con cualquier total.
API keys
Copia las claves secretas desde el panel de Pagar.me (la sección incluye un enlace): Development > Keys. Pagar.me usa una sola dirección de API para los pagos de prueba y los reales; la clave determina si un pago es de prueba o real.
Test mode: usa la clave secreta de prueba, sin cargos reales. Mientras está activado, los clientes ven TEST MODE — Use test credentials. No real charges. en el paso Confirm Order. Las consultas de estado y los reembolsos de un pedido siempre usan la clave del modo con el que se creó su pago. Predeterminado: activado.
Test secret key: la clave secreta de prueba de Pagar.me (sk_test_...). Se usa mientras el modo de prueba está activado.
Live secret key: la clave secreta de producción de Pagar.me (sk_...). Se usa cuando el modo de prueba está desactivado. Manténla en secreto.
Las claves guardadas no se vuelven a mostrar nunca. El campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Para eliminar una clave guardada, marca Clear the saved key on save debajo del campo y haz clic en Save.
Página de pago
Los métodos que se ofrecen en la página de pago de Pagar.me, cada uno con su propio interruptor. Elige solo métodos habilitados en tu cuenta de Pagar.me. Si no se selecciona ninguno, se ofrecen tarjeta de crédito, PIX y boleto. Predeterminado: tarjeta de crédito, PIX y boleto.
Boleto due in (days): número de días hasta el vencimiento del boleto, de 1 a 30. Predeterminado: 3. Otro valor se rechaza al guardar con Boleto due in (days): enter a number from 1 to 30.
Notificaciones de pago (webhook)
En el panel de Pagar.me abre Settings > Webhooks y crea un webhook con la URL que aparece en Webhook URL en esta sección. En OpenCart 3 tiene este aspecto: https://your-store/index.php?route=extension/payment/wcp_pagarme_gateway/webhook; en OpenCart 4, este: https://your-store/index.php?route=extension/wcp_pagarme_gateway/payment/wcp_pagarme_gateway.webhook. Se construye a partir de la dirección de la tienda de tu instalación de OpenCart. Cópiala exactamente como aparece en los ajustes. La URL debe ser accesible desde Internet.
Selecciona estos eventos (también aparecen en esta sección):
El webhook no requiere contraseña ni firma. Su contenido nunca se considera fiable: la tienda solo toma de él el ID del pedido de Pagar.me y lee ese pedido desde la API de Pagar.me con la clave del modo en que se creó. Las notificaciones de pedidos de Pagar.me que no fueron creados por esta tienda se ignoran. Sin el webhook, los pagos por PIX y boleto realizados más tarde solo se confirman cuando el cliente vuelve a la tienda.
Pedidos
OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido incompleto, missing order). El pedido recibe un estado solo después de que Pagar.me haya informado del pago mediante el webhook o cuando el cliente vuelve a la tienda; el pedido de Pagar.me siempre se vuelve a leer desde la API. Cada campo siguiente muestra los estados de pedido de tu OpenCart.
Order Status After Payment: el estado que se asigna tras un pago verificado de Pagar.me. Predeterminado: Procesando.
Awaiting Pagar.me Payment Status: se emitió un código PIX o un boleto, o un pago con tarjeta está en análisis; Pagar.me confirma el dinero más tarde. Predeterminado: Pendiente.
Pagar.me Payment On Hold Status: el pago necesita tu revisión (consulta Estados de pedido). Predeterminado: Pendiente, porque OpenCart no tiene un estado En espera. Puedes crear tu propio estado en System > Localisation > Order Statuses y seleccionarlo aquí.
Payment Failed Status: el pago de un pedido en espera falló, se canceló o caducó. Si Pagar.me lo informa como pagado más tarde, el pedido recibe el estado posterior al pago. Predeterminado: Fallido.
Cancelled Order Status: el estado que tu tienda usa para los pedidos cancelados. La extensión no lo asigna: un pago de Pagar.me que llegue después de él pone el pedido en el estado de revisión. Predeterminado: Cancelado.
Refunded Status: se asigna cuando el pago se reembolsa por completo desde la página del pedido o en el panel de Pagar.me. Predeterminado: Reembolsado.
Avanzado
Debug log: escribe las solicitudes a la API y las notificaciones en wc_pgm_debug.log.php, en la carpeta de registros de OpenCart (storage/logs). El archivo no se puede abrir desde la web. Los errores y las advertencias siempre se registran. Las claves y los datos del cliente (correo electrónico, teléfono, CPF) no se registran. 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 pedidos y sus datos de pago de Pagar.me (necesarios para los reembolsos) siempre se conservan. Predeterminado: desactivado.
Importar / Exportar
Export: Download JSON guarda los ajustes como un archivo JSON. Las claves secretas 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, Pagar.me). En el paso Confirm Order el cliente ve tu descripción y la nota You will be redirected to the Pagar.me payment page to pay by credit card, PIX, boleto or debit card. OpenCart crea el pedido en este paso, todavía sin estado. 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, y hace clic en Confirm Order al final de la página de finalización de compra. Cuando el cliente hace clic en Confirm Order, la extensión crea un pedido de Pagar.me por el total del pedido en BRL y envía al cliente a la página de pago de Pagar.me. Las líneas del pedido con impuestos, envío y otros recargos se envían como artículos; cuando el pedido tiene un descuento (cupón, vale o puntos de recompensa) o las líneas no suman el total, se envía una sola línea Order # con el número de pedido por el total. Se requiere un correo electrónico válido.
El nombre y el correo electrónico del cliente se pasan a Pagar.me. El CPF o el CNPJ (11 o 14 dígitos) se toma de un campo personalizado del cliente o de la dirección de pago cuyo nombre contiene CPF o CNPJ; OpenCart no tiene ese campo por defecto, así que añádelo en Customers > Custom Fields si quieres enviarlo. En OpenCart 4, cuando la tienda no pide dirección de pago, se usan la dirección de envío y sus campos personalizados. También se pasa un número de móvil brasileño. La dirección de facturación solo se envía para una dirección brasileña con un CEP de 8 dígitos y un estado. Si no hay CPF ni CNPJ, el cliente lo introduce en la página de Pagar.me.
Tras pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando Pagar.me lo confirma: la tienda lee el pedido de Pagar.me desde la API, y el importe pagado y la moneda deben coincidir con el pedido. Después, el pedido recibe su estado de la forma habitual en OpenCart, con los correos electrónicos de pedido habituales y la actualización del stock, y el cliente ve la página de éxito del pedido de OpenCart. Un PIX o un boleto emitido que aún no se ha pagado pone el pedido en el estado de espera, y la página también muestra Your Pagar.me payment is awaiting confirmation (PIX / boleto). The order will be confirmed as soon as Pagar.me reports the payment. Para un pedido en estado de revisión muestra We are confirming your payment with Pagar.me. The order will be updated automatically — please do not pay again. Cada vez que el cliente vuelve, se vuelve a leer el pedido de Pagar.me, de modo que un PIX o boleto pagado mientras tanto se aplica aunque el webhook no haya llegado.
Si el cliente vuelve sin pagar, regresa a la finalización de compra con The Pagar.me payment was not completed. You can try again or choose another payment method. Si el pago fue rechazado o cancelado, el mensaje es The Pagar.me payment was declined or canceled. You can try again or choose another payment method. El carrito se conserva. En OpenCart 4, estos mensajes se muestran encima de la página de finalización de compra. Si el pedido ya tiene un estado y su pago falló o caducó, el mensaje es The Pagar.me payment of your order was declined, canceled or has expired. Please place a new order or contact us. Si el carrito ya está vacío (por ejemplo, el pedido había llegado a la página de éxito antes de que caducara su PIX o boleto), no hay nada que pagar en la finalización de compra: una página Payment confirmation dice The Pagar.me payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order. con un botón Continue. Si no se pudo contactar con Pagar.me, una página Payment confirmation pide al cliente que no vuelva a pagar y ofrece Check again y Back to checkout.
En OpenCart 3 se crea un pedido nuevo cada vez que se muestra el paso Confirm Order. En OpenCart 4 se mantiene un único pedido para la finalización de compra y se actualiza, de modo que, tras un pago no terminado o rechazado, el cliente paga de nuevo el mismo pedido. Antes de un nuevo pago, la extensión revisa los intentos anteriores del mismo carrito: si uno está pagado, o si su PIX o boleto está pendiente, el cliente va a la página de éxito sin un nuevo pago. Una página de pago abierta de Pagar.me del mismo pedido se reutiliza si el importe y el modo son los mismos; las demás páginas abiertas se cierran primero en Pagar.me. Si un segundo pedido de Pagar.me del carrito se paga de todos modos, no se aplica, y una nota en el pedido pagado te pide reembolsar el duplicado.
En OpenCart 4, el pedido de la finalización de compra se mantiene hasta que se muestra la página de éxito. Si ese pedido se cerró entretanto (por ejemplo, su PIX o boleto caducó, su pago falló o lo cancelaste o reembolsaste), Confirm Order devuelve al cliente a la finalización de compra con Your previous order was cancelled or its payment failed. Please confirm the order again., o, si el pedido se había pagado antes de que lo cerraras, con This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. El siguiente Confirm Order paga un pedido nuevo. Cuando el cliente vuelve de Pagar.me a un pedido que se pagó y que después cerraste tú, ve el mismo mensaje en la finalización de compra o, si el carrito ya está vacío, una página con Order #(número) was closed by the store, so it will not be shipped. To buy these items, please place a new order. Si el pedido de la finalización de compra ya tiene un estado y el carrito tiene ahora otros productos o cantidades, el cliente vuelve a la finalización de compra y el carrito nuevo recibe un pedido nuevo.
Si Pagar.me no puede iniciar el pago, el cliente se queda en el paso Confirm Order con un mensaje breve, por ejemplo Could not connect to Pagar.me. Please try again in a moment., o con el mensaje de Pagar.me sobre datos de facturación no válidos. El motivo técnico se escribe en el registro.
El webhook 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 (startup) que deja pasar el webhook y el regreso del cliente desde Pagar.me.
La extensión no tiene formulario de tarjeta dentro de tu finalización de compra, ni tarjetas guardadas, suscripciones o pagos recurrentes, ni reglas de cuotas, ni pagos divididos (marketplace), ni pagos con tarjeta solo de autorización.
Pedidos y reembolsos
Estados de pedido
No status (missing order): el cliente fue enviado a Pagar.me y todavía no ha pagado ni emitido un PIX o boleto, o el pago fue rechazado. En Sales > Orders estos pedidos solo se muestran con el filtro Order Status en Missing Orders.
En OpenCart 4, un pedido no pagado de la finalización de compra puede recibir el estado Voided, que OpenCart 4 asigna cuando el cliente vuelve al paso Confirm Order. La extensión trata ese pedido como un pedido sin estado, y un pago posterior lo confirma igualmente.
Order Status After Payment (default Processing): se confirmó el pago. Una nota muestra el ID del pedido de Pagar.me (or_...) y el método de pago.
Awaiting Pagar.me Payment Status (default Pending): se emitió un PIX o un boleto (o un pago con tarjeta está en análisis) y espera el pago. El pedido pasa a Order Status After Payment cuando Pagar.me confirma el pago.
Pagar.me Payment On Hold Status (default Pending): el boleto se pagó solo parcialmente; o el importe o la moneda pagados no coinciden con el pedido; o el pago llegó después de que el pedido se hubiera cancelado o reembolsado; o se abrió una contestación (chargeback) sobre un pedido pagado. La nota lo explica. Revisa el pedido y complétalo o reembolsa el pago.
Payment Failed Status (default Failed): el pago de un pedido en espera o retenido falló, o su pedido de Pagar.me se canceló o caducó (por ejemplo, un boleto sin pagar). Si Pagar.me informa de un pago más tarde, el pedido pasa igualmente a Order Status After Payment.
Refunded Status (default Refunded): el pago se reembolsó por completo mediante la extensión, o se reembolsó o canceló en Pagar.me.
Cada estado de Pagar.me se aplica una sola vez, por lo que los webhooks repetidos o las vueltas del cliente no añaden notas ni pagos. Las notas son entradas del History del pedido que el cliente no ve.
Pestaña VibeFox Pagar.me Gateway
En Sales > Orders abre un pedido pagado con Pagar.me. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Pagar.me Gateway muestra el ID del Pagar.me order con una etiqueta Test mode para los pagos de prueba, el Payment method, el Status, los importes Paid / refunded, el formulario de reembolso, el historial de reembolsos y las Pagar.me notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.
Reembolsos
En la pestaña VibeFox Pagar.me Gateway introduce el Amount (el importe aún no reembolsado se rellena automáticamente), opcionalmente un Reason (optional), y haz clic en Refund via Pagar.me. Confirma la pregunta Refund this amount through Pagar.me? This cannot be undone. Se admiten reembolsos totales y parciales de pagos con tarjeta y PIX. Necesitas el permiso para modificar la extensión (se define en System > Users > User Groups). Puedes reembolsar hasta el importe que Pagar.me cobró realmente, de modo que, tras una diferencia de importe, el límite es lo que pagó el cliente, no el total del pedido. El reembolso se envía con la clave del modo en que se hizo el pago, así que esa clave secreta debe estar configurada. Un reembolso solo se registra cuando Pagar.me lo confirma; en caso contrario, la pestaña muestra el error, por ejemplo Pagar.me refused the refund: ... o Pagar.me did not confirm the refund, y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas con el ID del cargo. 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. Los reembolsos están disponibles cuando Pagar.me ha informado del pago.
Los pagos con boleto solo se pueden reembolsar a la cuenta bancaria del cliente. Reembólsalos en el panel de Pagar.me y después registra el reembolso en OpenCart manualmente. Las devoluciones de productos en Sales > Returns no devuelven dinero a través de Pagar.me.
Un reembolso total o una cancelación hecha en el panel de Pagar.me llega por webhook, pone el pedido en Refunded Status y añade una nota. Un contracargo añade una nota y pone un pedido pagado en el estado de revisión.
Clave de licencia
La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Pagar.me Gateway es el primer bloque de Extensions > Extensions > Payments > VibeFox Pagar.me 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-pagarme y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso de modificación de 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 tras liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no responde, 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, Pagar.me 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 la sesión del administrador, así que sin una clave activa el método de pago queda oculto para todos. Tras 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 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
Pagar.me does not appear at checkout: comprueba que la licencia esté activa, que Enable / Disable esté activado, que la clave secreta del modo actual esté configurada (Test secret key en modo de prueba, Live secret key en modo real) y que el cliente finalice la compra en BRL. La página de ajustes muestra un aviso cuando falta la clave. Comprueba también que la dirección de pago esté en la Geo Zone seleccionada y que el pedido alcance el Total definido en los ajustes.
The payment went through, but the order stays without a status or in the awaiting status: el webhook no funciona. En el panel de Pagar.me comprueba que el webhook exista para la cuenta y el modo que usas, que su URL sea exactamente la que se muestra en Webhook URL y que estén seleccionados los eventos indicados arriba. El pedido también se comprueba cada vez que el cliente vuelve a la tienda.
The webhook answers verification failed, retry later: la tienda no pudo leer el pedido de Pagar.me desde la API, por ejemplo porque falta la clave de ese modo o la API no respondió. Pagar.me reintenta el webhook.
The webhook answers busy: otra solicitud estaba procesando el carrito en ese mismo momento, o no se pudo asignar el estado del pedido. Pagar.me reintenta el webhook. Activa Debug log para ver el motivo.
The webhook answers unknown order: el pedido de Pagar.me no fue creado por esta tienda, por ejemplo un pedido de otra tienda de la misma cuenta. No se cambia nada.
The webhook answers invalid payload or invalid order id: la solicitud no es una notificación de Pagar.me. No se cambia nada.
The customer sees Pagar.me payments are not available right now: la clave secreta es incorrecta o falta. Comprueba la clave del modo actual.
The customer sees Pagar.me could not start the payment: Pagar.me rechazó los datos de facturación, por ejemplo el CPF del campo personalizado. El mensaje indica el problema; el motivo completo está en el registro.
The customer sees A valid billing email is required for Pagar.me.: el correo electrónico del pedido no es válido.
The customer sees Pagar.me only supports payments in Brazilian Real (BRL).: la finalización de compra está en otra moneda.
The customer sees This order already has a Pagar.me payment that the store has to review: un pago anterior del carrito necesita tu revisión. Comprueba el panel de Pagar.me y el registro.
Order is in the review status after payment: lee las notas de la pestaña VibeFox Pagar.me Gateway (consulta Estados de pedido) y después completa el pedido o reembolsa el pago.
No refund form in the tab: la pestaña indica el motivo: el pago aún no está informado, está reembolsado por completo, tu grupo de usuarios no tiene permiso para modificar la extensión o la clave secreta del modo del pago no está configurada.
Refund fails for a boleto: los pagos con boleto no se pueden reembolsar a través de la API. Reembólsalo en el panel de Pagar.me y registra el reembolso manualmente.
Para desarrolladores: antes de enviar el pedido de Pagar.me, la extensión dispara el evento de OpenCart wc_pgm_order_data con el cuerpo de la solicitud y el pedido. El importe del pago debe seguir siendo igual al total del pedido.
Desinstalar
Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Pagar.me Gateway. La clave de licencia y el estado de 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. El evento de OpenCart de la extensión también se elimina (en OpenCart 4, sus eventos y su acción de inicio, que deja pasar el webhook y el regreso del cliente en modo de mantenimiento). Si Delete data on uninstall está activado, se eliminan los demás ajustes de la pasarela (título, descripción, modo de prueba, claves secretas, métodos de pago, días del boleto, registro) y el registro. Si está desactivado, se conservan para una reinstalación posterior. Los registros de pagos y reembolsos de Pagar.me siempre se conservan, de modo 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, haz clic en Uninstall (el botón naranja −) junto a VibeFox Pagar.me Gateway en la lista de extensiones instaladas y después en Delete (el botón rojo de papelera) para eliminar el paquete subido.
Pagar.me es una marca comercial de su respectivo propietario. Esta extensión no está afiliada a Pagar.me ni cuenta con su aprobación.