VibeFox Iugu 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: real brasileño (BRL). Iugu cobra únicamente en BRL, por lo que la tienda necesita la moneda BRL en System > Localisation > Currencies. El método de pago se oculta cuando la moneda de la compra del cliente es otra, y también para importes totales inferiores a R$ 1,00 (el mínimo de Iugu).

Cuenta de Iugu: necesitas dos tokens de API del panel de Iugu, uno de tipo "Test" y otro de tipo "Live" (ver Configuration). Iugu usa una única dirección de API para ambos: el token decide si las facturas son de prueba o reales. No es necesario configurar ningún webhook en Iugu.

CPF/CNPJ (opcional): OpenCart no tiene un campo CPF propio. Si añades un campo personalizado de cliente o de dirección cuyo nombre contenga CPF o CNPJ (Customers > Custom Fields), su valor se envía a Iugu.

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_iugu_gateway-oc3-(version).ocmod.zip y el paquete de OpenCart 4 wcp_iugu_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_iugu_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 Iugu Gateway y haz clic en Install (el botón verde +). Tu usuario de administración 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 License key).

4. Introduce los tokens de API de prueba y de producción (ver Configuration), deja activado Test mode, activa Enable / Disable y haz clic en Save.

5. Realiza un pedido de prueba en BRL y paga en la página de Iugu con un pago de prueba de Iugu. Cuando todo esté listo, 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_iugu_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 Iugu 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 y los tokens de API 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).

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 Iugu 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 (las facturas se crean con el token de API de prueba, sin cobros reales) o LIVE. Avisa cuando falta el token del modo activo (en ese caso el método de pago se oculta en la compra) y cuando la moneda predeterminada de la tienda no es BRL (Iugu entonces no se ofrece para otras monedas). Sin permiso para modificar la extensión, la página muestra los ajustes pero no permite guardarlos.

Al guardar, Title no puede estar vacío ni tener más de 128 caracteres, Sort Order debe ser un número entero, Total debe ser un número igual o mayor que 0, y la zona geográfica y los estados de pedido seleccionados deben existir. Si no, no se guarda nada y el error indica el campo.

Iugu

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

Title: el nombre del método de pago que ve el cliente en la compra. También es el nombre del método de pago que se guarda en el pedido. Predeterminado: Iugu. Obligatorio, hasta 128 caracteres.

Description: el texto que se muestra al cliente en el paso Confirm Order, encima del botón de confirmar. Predeterminado: Paga de forma segura con Iugu. Serás redirigido para completar tu pago.

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

Geo Zone: ofrece Iugu 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 Iugu. Déjalo vacío para ofrecer Iugu con cualquier total. Iugu en sí requiere al menos R$ 1,00.

Credenciales de API

Crea los tokens de API en Iugu Alia (la sección enlaza allí): Settings > API integration > New. Crea un token de tipo "Test" y otro de tipo "Live".

Test mode: usa el token de API de prueba, así que no se realiza ningún cobro real. Predeterminado: activado. Mientras el modo de prueba está activo, los clientes ven SANDBOX — Test mode enabled. No real charges. en el paso Confirm Order, encima de la descripción. Las consultas de estado y los reembolsos de un pedido usan siempre el token del modo en el que se creó su factura, por lo que cambiar de modo no afecta a los pedidos anteriores.

Test API token: el token de API de Iugu de tipo "Test". Se usa mientras el modo de prueba está activo.

Live API token: el token de API de Iugu de tipo "Live" (producción). Se usa cuando el modo de prueba está desactivado. Mantenlo en secreto.

Los tokens guardados 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 token guardado, marca Clear the saved token on save debajo del campo y haz clic en Save.

Notificaciones de pago

Notification URL: cada factura indica a Iugu que informe de los cambios de estado a esta URL de tu tienda. En OpenCart 3 tiene el formato https://your-store/index.php?route=extension/payment/wcp_iugu_gateway/webhook, y en OpenCart 4, https://your-store/index.php?route=extension/wcp_iugu_gateway/payment/wcp_iugu_gateway.webhook; debe ser accesible desde internet. No hay que configurar nada en Iugu. Un disparador adicional a nivel de cuenta que apunte a la misma URL no causa problemas. Las notificaciones no contienen datos de pago en los que la tienda confíe: la factura siempre se vuelve a leer desde la API de Iugu (estado, importe, moneda) antes de que el pedido cambie.

La extensión reacciona a los eventos de Iugu listados en esta sección: invoice.status_changed, invoice.refund, invoice.released, invoice.dunning_action e invoices. Para cada uno, lee la factura y aplica su estado:

Una factura caducada o cancelada de un pedido que todavía no tiene estado deja el pedido sin estado, para que el cliente pueda volver a pagar. Otros eventos y facturas que no han sido creados por tu tienda reciben respuesta HTTP 200 y se ignoran, sin hacer ninguna petición a Iugu. Sin notificaciones, una factura solo se comprueba cuando el cliente regresa a la tienda desde la página de Iugu.

Pedidos

OpenCart crea el pedido en el paso Confirm Order sin estado (un pedido incompleto). Recibe un estado solo después de que Iugu haya informado de la factura, mediante notificación o al volver el cliente; la factura siempre se vuelve a leer desde Iugu. Cada campo siguiente muestra tus estados de pedido de OpenCart.

Order Status After Payment: se asigna tras un pago de Iugu verificado. Predeterminado: Procesando.

Awaiting Iugu Payment Status: el cliente volvió de la página de Iugu con un boleto o PIX emitido; Iugu confirmará el dinero más tarde. Predeterminado: Pendiente de pago.

Iugu Payment On Hold Status: pago con tarjeta autorizado pero no capturado, pago en análisis, pago parcial, contracargo, importe o moneda distintos del pedido, o pago recibido después de cancelar el pedido. Una nota explica el motivo; revísalo manualmente. Predeterminado: Pendiente de pago, porque OpenCart no tiene un estado "En espera". Puedes crear tu propio estado en System > Localisation > Order Statuses y seleccionarlo aquí.

Invoice Expired Status: la factura de un pedido en espera caducó sin pago. Si Iugu la informa como pagada más tarde, el pedido recibe el estado posterior al pago. Predeterminado: Fallido.

Invoice Canceled Status: la factura de un pedido en espera se canceló en Iugu. Predeterminado: Cancelado.

Refunded Status: se asigna después de reembolsar el pago por completo desde la página del pedido o desde el panel de Iugu. Predeterminado: Reembolsado.

Avanzado

Debug log: escribe las peticiones a la API y las notificaciones en wc_igu_debug.log.php, en la carpeta de registros de OpenCart (storage/logs). El archivo no se puede abrir desde la web. Los tokens y los datos de los clientes (correo electrónico, teléfono, CPF) nunca se registran. Los errores y las advertencias siempre se escriben, incluso con el interruptor desactivado. 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, las referencias de facturas de Iugu y los reembolsos siempre se conservan, así los pedidos antiguos siguen funcionando tras reinstalar. Predeterminado: desactivado.

Importar / Exportar

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

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

Compra

En el paso Payment Method el cliente elige el método de pago (por defecto Iugu). En el paso Confirm Order el cliente ve tu descripción y la nota You will be redirected to the Iugu invoice page to pay by credit card, boleto or PIX. OpenCart crea el pedido en este paso, todavía sin estado. Cuando el cliente hace clic en Confirm Order, la extensión crea una factura de Iugu por el total del pedido en BRL, con vencimiento a 3 días, y envía al cliente a la página de factura de Iugu. Se requiere un correo electrónico válido. La factura muestra Order # y el número del pedido. Allí el cliente paga con tarjeta de crédito, boleto o PIX, con los métodos habilitados en tu cuenta de Iugu. El nombre y el correo electrónico del cliente se envían a Iugu, junto con el CPF/CNPJ de un campo personalizado llamado CPF o CNPJ cuando tiene 11 o 14 dígitos. El teléfono y la dirección solo se envían en el formato que acepta Iugu (números de teléfono brasileños, direcciones brasileñas con un CEP de 8 dígitos; el número de la casa se envía como s/n).

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. De forma predeterminada, OpenCart 4 no pide una dirección de pago; en ese caso, la extensión toma la dirección y el campo personalizado CPF/CNPJ de la dirección de envío.

Tras pagar, el cliente vuelve a tu tienda. El pedido se marca como pagado solo cuando Iugu lo confirma: la factura se lee desde la API de Iugu cuando el cliente regresa y cuando Iugu envía una notificación. Después, el pedido recibe su estado de la forma estándar de OpenCart, con los correos habituales del pedido y la actualización del stock, y el cliente ve la página de éxito de pedido de OpenCart.

Si el cliente generó un código de boleto o PIX y volvió antes de pagar, el pedido recibe el Awaiting Iugu Payment Status y la página de éxito muestra Your Iugu invoice is awaiting payment (boleto / PIX). The order will be confirmed as soon as Iugu reports the payment. El pedido pasa al estado de pagado cuando Iugu informa del dinero, mediante notificación o cuando el cliente vuelve a abrir el enlace de retorno. Para un pedido en espera de revisión, la página de éxito muestra We are confirming your payment with Iugu. The order will be updated automatically — please do not pay again. Si no se pudo contactar con Iugu o aún no ha informado del pago cuando el cliente regresa, aparece una página de Payment confirmation con el mismo texto y los botones Check again y Back to checkout.

Si la factura fue cancelada o ha caducado, el cliente vuelve a la compra con el mensaje The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. Si el pedido se canceló porque su factura fue cancelada en Iugu, el mensaje es Your order was cancelled because its Iugu invoice was canceled. Si el carrito ya está vacío (un pedido con boleto o PIX había llegado a la página de éxito antes de que caducara su factura), el cliente ve en su lugar una página de Payment confirmation con The Iugu invoice of order #... was not paid (it was canceled or has expired), so the order will not be shipped. To buy these items, please place a new order. (o el mensaje de cancelación) y un botón Continue. En OpenCart 4 los mensajes del proceso de compra se muestran encima de la página de finalización de compra. OpenCart 3 crea un pedido nuevo cada vez que se muestra el paso Confirm Order; OpenCart 4 actualiza el pedido de la compra, así que, tras una factura caducada o cancelada, el cliente paga el mismo pedido con una factura nueva. Un carrito solo se paga una vez. Antes de crear una factura nueva, la extensión comprueba las facturas anteriores del carrito: si una está pagada, se aplica ese pago y el cliente va a la página de éxito; si el mismo pedido aún tiene una factura abierta con el mismo importe y modo, el cliente vuelve a ella; las demás facturas abiertas se cancelan en Iugu. Si una factura anterior se paga de todos modos, el pago se asocia igualmente, y un pago duplicado de un carrito ya pagado se marca con una nota. Un cambio en el carrito, incluida una nueva cantidad, cuenta como un carrito nuevo que necesita su propio pago.

OpenCart 4 mantiene el pedido en la compra hasta que se muestra la página de éxito. Si ese pedido se ha cerrado mientras tanto (por ejemplo, caducó su boleto o lo cancelaste), el cliente vuelve a la compra con The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay., o, si se había pagado antes de cerrarse, con This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. Si el pedido ya está realizado y el carrito contiene ahora una nueva compra, Confirm Order vuelve a cargar la página de compra. En cualquier caso, el siguiente Confirm Order paga un pedido nuevo del carrito.

Si Iugu no puede crear la factura, el cliente se queda en el paso Confirm Order con un mensaje breve, por ejemplo Iugu could not create the invoice: con el motivo y una petición de revisar los datos de facturación, o Could not connect to Iugu. Please try again in a moment. El motivo técnico se escribe en el registro.

La URL de notificación también funciona mientras la tienda está en modo de mantenimiento: OpenCart 3 deja pasar las peticiones de las extensiones de pago, y en OpenCart 4 la extensión añade una acción de inicio que deja pasar la notificación y el regreso del cliente.

La extensión solo admite pagos únicos. No tiene formulario de tarjeta en la tienda, tarjetas guardadas, suscripciones ni facturación recurrente, carnês, pagos divididos ni ajustes de cuotas: para las cuotas usa los ajustes de la página de Iugu. Los métodos de pago que se ofrecen en la página de Iugu no se pueden elegir en los ajustes de la extensión: se ofrecen todos los métodos habilitados en tu cuenta de Iugu.

Pedidos y reembolsos

Estados de pedido

Sin estado (pedido incompleto): el cliente fue enviado a Iugu y no ha pagado, la factura caducó o se canceló, o Iugu aún no ha confirmado el pago. En Sales > Orders estos pedidos solo se muestran con el filtro Order Status en Missing Orders.

Order Status After Payment (predeterminado Procesando): Iugu confirmó el pago. Una nota muestra el ID de la factura y el método de pago (tarjeta de crédito, boleto o PIX).

Awaiting Iugu Payment Status (predeterminado Pendiente de pago): el cliente volvió con un boleto o PIX emitido. El pedido pasa al estado de pagado cuando Iugu informa del pago.

Iugu Payment On Hold Status (predeterminado Pendiente de pago): el pago con tarjeta está autorizado pero no capturado (captúralo en Iugu, y el pedido se completa cuando Iugu informa que la factura está pagada), el pago está en análisis, la factura se pagó solo parcialmente, se abrió un contracargo, Iugu informó de un importe o una moneda distintos a los del pedido, o el pago llegó después de que el pedido se cancelara. Las notas lo explican. Revisa el pedido y complétalo o reembolsa el pago.

Invoice Expired Status (predeterminado Fallido): la factura de un pedido en espera caducó sin pago. Si Iugu informa más tarde de que la factura está pagada, el pedido pasa al estado de pagado.

Invoice Canceled Status (predeterminado Cancelado): la factura de un pedido en espera se canceló en Iugu.

Refunded Status (predeterminado Reembolsado): el pago se reembolsó por completo desde la extensión o desde el panel de Iugu.

Si otra factura del mismo pedido o carrito también está pagada, el pedido no cambia. Una nota te pide que reembolses el pago duplicado en Iugu. Las notas son entradas del History del pedido que el cliente no ve. Cuando un pedido en espera se paga, caduca o se cancela más tarde, OpenCart notifica al cliente el nuevo estado.

Pestaña VibeFox Iugu Gateway

En Sales > Orders abre un pedido pagado con Iugu. En la parte inferior de la página del pedido, junto a History y Additional, la pestaña VibeFox Iugu Gateway muestra el ID de la Iugu invoice (enlazado a la factura en Iugu) con una etiqueta Test mode para las facturas de prueba, el Payment method, el Status, los importes Paid / refunded, el formulario de reembolso, el historial de reembolsos y las Iugu notes del pedido. La pestaña se muestra a los usuarios que tienen acceso a la extensión.

Reembolsos

En la pestaña VibeFox Iugu Gateway introduce el Amount (se rellena el importe aún no reembolsado), opcionalmente un Reason (optional), y haz clic en Refund via Iugu. Confirma la pregunta Refund this amount through Iugu? This cannot be undone. Necesitas el permiso para modificar la extensión (se configura en System > Users > User Groups). El reembolso se envía con el token del modo en el que se creó la factura, por lo que ese token debe estar configurado.

Los reembolsos se calculan a partir del importe que Iugu cobró realmente por la factura, así que tras una discrepancia de importes puedes reembolsar hasta lo que pagó el cliente, no el total del pedido. Solo se pueden reembolsar facturas pagadas, y no más que el importe aún reembolsable en Iugu. Un reembolso solo se considera realizado cuando Iugu lo confirma. Si Iugu lo rechaza o no lo confirma, la pestaña muestra el error y no se registra ningún reembolso. Un reembolso correcto se añade al historial de reembolsos y a las notas, con el ID de la factura y el motivo. Un reembolso total cambia el pedido a 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 Iugu ha informado de que la factura está pagada.

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

Un reembolso total realizado desde el panel de Iugu cambia el pedido a Refunded Status con una nota. Los reembolsos parciales hechos desde el panel no se importan.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Iugu Gateway es el primer bloque de Extensions > Extensions > Payments > VibeFox Iugu 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 comprobar el estado de nuevo, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: opencart-payment-iugu 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. Tras 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 responde, 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, Iugu no se muestra a los clientes en la compra. Si aun así se inicia un pago, el cliente ve This payment method is not available. Please choose another one. Un usuario administrador que tenga la sesión iniciada en el panel 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. 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: una vez al día durante los primeros 14 días tras introducir la clave, y después una vez por semana. No hace falta ningún cron job. Desinstalar la extensión siempre elimina la clave de licencia y el estado de la licencia.

Solución de problemas

Iugu no aparece en la compra: comprueba que la licencia esté activa, que Enable / Disable esté activado y que el token del modo activo esté configurado: Test API token en modo de prueba, Live API token en modo real. La moneda de compra del cliente debe ser BRL y el total, al menos R$ 1,00. Comprueba también 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 muestra un aviso si el token o la moneda son incorrectos.

El pago se realizó, pero el pedido se queda sin estado: la notificación de Iugu no llegó a tu tienda o no se pudo comprobar. Activa el Debug log y revisa el campo Log de la página de la extensión. Comprueba que tu tienda sea accesible desde internet en la Notification URL y que el token del modo en el que se creó la factura siga introducido. La factura también se comprueba cuando el cliente vuelve a la tienda después de pagar.

La respuesta a la notificación es verification failed: la factura no se pudo leer desde la API de Iugu en ese momento, por ejemplo por un error de red, un token incorrecto o la falta del token del modo de la factura. Iugu reintenta la notificación.

La respuesta a la notificación es busy: el carrito estaba siendo procesado por otra petición en el mismo momento, o no se pudo asignar el estado del pedido. Iugu reintenta la notificación. El registro muestra el motivo.

La respuesta a la notificación es invalid invoice id: la notificación no tenía un ID de factura válido. No se cambia nada.

El pedido está en el Iugu Payment On Hold Status: lee las Iugu notes en la pestaña del pedido. Un pago con tarjeta espera captura, el pago está en análisis, parcialmente pagado o en disputa, el importe pagado no coincide con el pedido, o el pago llegó después de cancelar el pedido.

El cliente ve "Iugu payments are not available right now": falta el token de API o es incorrecto. Comprueba el token del modo activo.

El cliente ve "A valid billing email is required for Iugu": el pedido no tiene una dirección de correo electrónico válida.

El cliente ve "This order already has an Iugu payment that the store has to review": una factura anterior del pedido está autorizada, en análisis o parcialmente pagada. Revisa la factura en Iugu y el registro.

El cliente ve This payment method is not available.: la sesión de compra ya no coincide con el pedido, o el método de pago se desactivó mientras tanto. El cliente recarga la compra.

El reembolso falla: lee el mensaje de la pestaña. Los pagos con boleto no se pueden reembolsar a través de Iugu, los pagos con PIX solo se pueden reembolsar por completo, y solo se pueden reembolsar facturas pagadas. Si el mensaje indica que el pago se hizo en modo de prueba o real y no hay ningún token configurado, introduce el token de ese modo. Si Iugu no confirmó el reembolso, revisa la factura en Iugu antes de volver a intentarlo.

Para desarrolladores: antes de crear la factura, la extensión dispara el evento de OpenCart wc_igu_invoice_data con la petición de factura y el pedido, por ejemplo para limitar los métodos de pago con payable_with.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Payments y haz clic en Uninstall (el botón rojo −) junto a VibeFox Iugu Gateway. La clave de licencia y el estado de la licencia de esta extensión siempre se eliminan. OpenCart siempre elimina sus propios ajustes 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. El evento de OpenCart de la extensión también se elimina (en OpenCart 4, también sus eventos y su acción de inicio, que deja pasar la notificación 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, tokens de API, interruptor del registro de depuración) y el registro. Si está desactivado, se conservan para una reinstalación posterior. Las referencias de facturas de Iugu y los reembolsos siempre se conservan, así que los pedidos pagados antes se pueden reembolsar y las notificaciones tardías siguen asociándose tras reinstalar. 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 Iugu Gateway en la lista de extensiones instaladas; después, haz clic en Delete (el botón rojo de papelera) para eliminar el paquete subido.

Iugu es una marca comercial de su respectivo titular. Esta extensión no está afiliada a Iugu ni cuenta con su aprobación.