VibeFox Iugu for OpenCart — Ajuda
Requisitos
OpenCart: 3.0.x (testado na versão 3.0.5.0) ou 4.0.2 e superior (testado na versão 4.1.0.3).
PHP: 8.0 ou superior.
Moeda: real brasileiro (BRL). A Iugu cobra somente em BRL, por isso a loja precisa ter a moeda BRL em System > Localisation > Currencies. O método de pagamento fica oculto quando a moeda do checkout do cliente é outra, e para totais abaixo de R$ 1,00 (o mínimo da Iugu).
Conta na Iugu: você precisa de dois tokens de API do painel da Iugu, um do tipo "Test" e outro do tipo "Live" (veja Configuration). A Iugu usa um único endereço de API para os dois: o token define se as faturas são de teste ou reais. Não é necessário configurar nenhum webhook na Iugu.
CPF/CNPJ (opcional): o OpenCart não tem um campo de CPF próprio. Se você adicionar um campo personalizado de cliente ou de endereço cujo nome contenha CPF ou CNPJ (Customers > Custom Fields), o valor dele é enviado à Iugu.
Chave de licença VibeFox: adquirida em vibefox.net. Uma chave funciona em um único domínio.
Instalação
O download é um único arquivo zip com os pacotes para as duas versões do OpenCart. Descompacte-o no seu computador. Ele contém o README.txt, o pacote para OpenCart 3 wcp_iugu_gateway-oc3-(version).ocmod.zip e o pacote para OpenCart 4 wcp_iugu_gateway.ocmod.zip. Instale apenas o pacote da sua versão do OpenCart. A chave de licença é a mesma para as duas versões.
OpenCart 3
1. No painel administrativo, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_iugu_gateway-oc3-(version).ocmod.zip. A extensão não possui modificações OCMOD, portanto Extensions > Modifications não precisa ser atualizado. Em vez do instalador, você também pode copiar o conteúdo da pasta upload deste pacote para a pasta raiz da sua loja.
2. Vá em Extensions > Extensions e escolha o tipo Payments. Localize VibeFox Iugu Gateway e clique em Install (o botão verde +). Seu usuário administrador precisa ter permissão para modificar a lista de extensões de pagamento.
3. Clique em Edit (o botão com o lápis) para abrir a página de configurações. Cole sua chave de licença VibeFox em License key, no bloco de licença no topo da página, e clique em Activate (veja License key).
4. Informe os tokens de API de teste e de produção (veja Configuration), mantenha Test mode ativado, ative Enable / Disable e clique em Save.
5. Faça um pedido de teste em BRL e pague-o na página da Iugu com um pagamento de teste da Iugu. Quando estiver tudo pronto, desative Test mode.
OpenCart 4
1. No painel administrativo, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_iugu_gateway.ocmod.zip. Não renomeie o arquivo: o OpenCart 4 obtém o código da extensão a partir do nome do arquivo, e um pacote renomeado não funciona.
2. O pacote aparece na lista de extensões instaladas, na mesma página. Clique em Install (o botão verde +) ao lado dele.
3. Vá em Extensions > Extensions e escolha o tipo Payments. Encontre VibeFox Iugu Gateway, clique em Install (o botão verde +) e depois em Edit (o botão de lápis).
4. Informe a chave de licença e os tokens de API como nos passos 3 a 5 para o OpenCart 3. A página de configurações e os seus campos são iguais nas duas versões. Apenas a URL de notificação é diferente (veja Notificações de pagamento).
Uma instalação nova começa com o método de pagamento desativado e o modo de teste ativado.
Configuração
Todas as configurações estão na página da extensão: Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit. As seções ficam listadas à esquerda; o botão Save abaixo da lista salva a página inteira. Acima das configurações, a página mostra TEST MODE (as faturas são criadas com o token de API de teste, sem cobranças reais) ou LIVE. Ela avisa quando falta o token do modo ativo (nesse caso o método de pagamento fica oculto no checkout) e quando a moeda padrão da loja não é BRL (a Iugu então não é oferecida para outras moedas). Sem a permissão para modificar a extensão, a página mostra as configurações, mas não consegue salvá-las.
Ao salvar, Title não pode estar vazio nem ter mais de 128 caracteres, Sort Order precisa ser um número inteiro, Total precisa ser um número igual ou maior que 0, e a zona geográfica e os status de pedido selecionados precisam existir. Caso contrário, nada é salvo e o erro indica o campo.
Iugu
Enable / Disable: Enable Iugu payments ativa ou desativa o método de pagamento. Padrão: desativado.
Title: o nome do método de pagamento que o cliente vê no checkout. Ele também é o nome do método de pagamento gravado no pedido. Padrão: Iugu. Obrigatório, até 128 caracteres.
Description: o texto exibido ao cliente na etapa Confirm Order, acima do botão de confirmação. Padrão: Pague com segurança via Iugu. Você será redirecionado para concluir seu pagamento.
Sort Order: a posição da Iugu entre os métodos de pagamento no checkout. Deixe em branco ou informe um número inteiro.
Geo Zone: ofereça a Iugu somente para endereços de pagamento da zona geográfica selecionada. Padrão: All zones. As zonas geográficas são configuradas em System > Localisation > Geo Zones.
Total: o total do checkout, na moeda padrão da loja, que um pedido deve atingir antes que a Iugu seja oferecida. Deixe em branco para oferecer a Iugu para qualquer total. A própria Iugu exige no mínimo R$ 1,00.
Credenciais de API
Crie os tokens de API no Iugu Alia (a seção tem um link para lá): Settings > API integration > New. Crie um token do tipo "Test" e um do tipo "Live".
Test mode: usa o token de API de teste, portanto nenhuma cobrança real é feita. Padrão: ativado. Enquanto o modo de teste estiver ativo, os clientes veem SANDBOX — Test mode enabled. No real charges. na etapa Confirm Order, acima da descrição. As consultas de status e os reembolsos de um pedido sempre usam o token do modo em que sua fatura foi criada, então trocar de modo não quebra pedidos antigos.
Test API token: o token de API da Iugu do tipo "Test". É usado enquanto o modo de teste estiver ativado.
Live API token: o token de API da Iugu do tipo "Live" (produção). É usado quando o modo de teste está desativado. Mantenha-o em sigilo.
Os tokens salvos nunca são exibidos novamente. O campo fica vazio e mostra Saved — leave empty to keep it. Digite um novo valor somente se quiser alterá-lo. Para remover um token salvo, marque Clear the saved token on save abaixo do campo e clique em Save.
Notificações de pagamento
Notification URL: cada fatura informa à Iugu que deve enviar as mudanças de status para esta URL da sua loja. No OpenCart 3 ela tem o formato https://your-store/index.php?route=extension/payment/wcp_iugu_gateway/webhook; no OpenCart 4, o formato é https://your-store/index.php?route=extension/wcp_iugu_gateway/payment/wcp_iugu_gateway.webhook. Ela precisa estar acessível pela internet. Não há nada para configurar na Iugu. Um gatilho adicional no nível da conta apontando para a mesma URL é inofensivo. As notificações não trazem dados de pagamento em que a loja confie: a fatura é sempre consultada novamente na API da Iugu (status, valor, moeda) antes que o pedido seja alterado.
A extensão reage aos eventos da Iugu listados nesta seção: invoice.status_changed, invoice.refund, invoice.released, invoice.dunning_action e invoices. Para cada um deles, ela consulta a fatura e aplica o status dela:
Uma fatura vencida ou cancelada de um pedido que ainda não tem status deixa o pedido sem status, para que o cliente possa pagar novamente. Outros eventos e faturas que não foram criadas pela sua loja recebem resposta HTTP 200 e são ignorados, sem nenhuma requisição à Iugu. Sem notificações, uma fatura só é verificada quando o cliente volta à loja a partir da página da Iugu.
Pedidos
O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente). Ele só recebe um status depois que a Iugu informa a fatura, por notificação ou no retorno do cliente; a fatura é sempre consultada na Iugu. Cada campo abaixo lista os seus status de pedido do OpenCart.
Order Status After Payment: definido após um pagamento verificado da Iugu. Padrão: Processando.
Awaiting Iugu Payment Status: o cliente voltou da página da Iugu com um boleto ou PIX gerado; a Iugu confirmará o dinheiro depois. Padrão: Pendente.
Iugu Payment On Hold Status: pagamento com cartão autorizado mas não capturado, pagamento em análise, pagamento parcial, chargeback, valor ou moeda diferentes do pedido, ou pagamento recebido depois que o pedido foi cancelado. Uma nota explica o motivo; verifique manualmente. Padrão: Pendente, porque o OpenCart não tem um status "On hold". Você pode criar o seu próprio status em System > Localisation > Order Statuses e selecioná-lo aqui.
Invoice Expired Status: a fatura de um pedido em espera venceu sem pagamento. Se a Iugu informar depois que ela foi paga, o pedido recebe o status após o pagamento. Padrão: Falhou.
Invoice Canceled Status: a fatura de um pedido em espera foi cancelada na Iugu. Padrão: Cancelado.
Refunded Status: definido depois que o pagamento é reembolsado integralmente pela página do pedido ou pelo painel da Iugu. Padrão: Reembolsado.
Avançado
Debug log: grava as requisições de API e as notificações em wc_igu_debug.log.php, na pasta de logs do OpenCart (storage/logs). O arquivo não pode ser aberto pela web. Tokens e dados do cliente (e-mail, telefone, CPF) nunca são registrados. Erros e avisos são sempre gravados, mesmo com a chave desativada. Padrão: desativado.
Log: mostra o tamanho e as entradas mais recentes do log. Clique em Clear log para esvaziá-lo.
Delete data on uninstall: quando ativado, ao desinstalar a extensão são removidas as configurações do gateway e o log. Pedidos, referências de faturas da Iugu e reembolsos são sempre mantidos, para que os pedidos antigos continuem funcionando após uma reinstalação. Padrão: desativado.
Importação / Exportação
Export: Download JSON salva as configurações em um arquivo JSON. Os tokens de API não são exportados.
Import: cole um JSON exportado anteriormente e clique em Import para restaurar as configurações. Os tokens de API salvos são mantidos.
Checkout
Na etapa Payment Method o cliente escolhe o método de pagamento (por padrão, Iugu). Na etapa Confirm Order o cliente vê a sua descrição e a observação You will be redirected to the Iugu invoice page to pay by credit card, boleto or PIX. O OpenCart cria o pedido nessa etapa, ainda sem status. Quando o cliente clica em Confirm Order, a extensão cria uma fatura da Iugu pelo total do pedido em BRL, com vencimento em 3 dias, e envia o cliente para a página da fatura da Iugu. É obrigatório um e-mail válido. A fatura mostra Order # e o número do pedido. Lá o cliente paga com cartão de crédito, boleto ou PIX, com os métodos habilitados na sua conta da Iugu. O nome e o e-mail do cliente são enviados à Iugu, além do CPF/CNPJ de um campo personalizado chamado CPF ou CNPJ quando ele tem 11 ou 14 dígitos. Telefone e endereço são enviados somente no formato aceito pela Iugu (telefones brasileiros, endereços brasileiros com CEP de 8 dígitos; o número do imóvel é enviado como s/n).
No OpenCart 4, o cliente escolhe o método de pagamento com o botão Choose no bloco do método de pagamento, na janela Payment method options, e clica em Confirm Order na parte de baixo da página de finalização de compra. Por padrão, o OpenCart 4 não pede um endereço de pagamento; nesse caso a extensão usa o endereço e o campo personalizado CPF/CNPJ do endereço de entrega.
Depois de pagar, o cliente volta à sua loja. O pedido só é marcado como pago depois que a Iugu confirma: a fatura é consultada na API da Iugu quando o cliente retorna e quando a Iugu envia uma notificação. Em seguida o pedido recebe o seu status da forma padrão do OpenCart, com os e-mails habituais do pedido e a atualização de estoque, e o cliente vê a página de sucesso do pedido do OpenCart.
Se o cliente gerou um código de boleto ou PIX e voltou antes de pagar, o pedido recebe o Awaiting Iugu Payment Status e a página de sucesso mostra Your Iugu invoice is awaiting payment (boleto / PIX). The order will be confirmed as soon as Iugu reports the payment. O pedido passa ao status de pago quando a Iugu informa o recebimento, por notificação ou quando o cliente abre novamente o link de retorno. Para um pedido retido, a página de sucesso mostra We are confirming your payment with Iugu. The order will be updated automatically — please do not pay again. Se a Iugu não pôde ser contactada ou ainda não informou o pagamento quando o cliente voltou, uma página de Payment confirmation mostra o mesmo texto com os botões Check again e Back to checkout.
Se a fatura foi cancelada ou venceu, o cliente volta ao checkout com a mensagem The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay. Se o pedido tinha sido cancelado porque a fatura da Iugu foi cancelada, a mensagem é Your order was cancelled because its Iugu invoice was canceled. Se o carrinho já estiver vazio (um pedido de boleto ou PIX tinha chegado à página de sucesso antes de a fatura vencer), o cliente vê em vez disso uma página de Payment confirmation com 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. (ou a mensagem de cancelamento) e um botão Continue. No OpenCart 4, as mensagens do checkout são exibidas acima da página de finalização de compra. O OpenCart 3 cria um novo pedido sempre que a etapa Confirm Order é exibida; o OpenCart 4 atualiza o pedido da finalização de compra, então, após uma fatura vencida ou cancelada, o cliente paga o mesmo pedido com uma nova fatura. Um carrinho é pago apenas uma vez. Antes de uma nova fatura, a extensão verifica as faturas anteriores do carrinho: se uma delas estiver paga, esse pagamento é aplicado e o cliente vai para a página de sucesso; se o mesmo pedido ainda tiver uma fatura aberta com o mesmo valor e modo, o cliente é enviado de volta a ela; as demais faturas abertas são canceladas na Iugu. Se uma fatura antiga for paga mesmo assim, o pagamento continua sendo associado, e um pagamento em duplicidade de um carrinho já pago é sinalizado com uma nota. Uma alteração do carrinho, incluindo uma nova quantidade, conta como um novo carrinho que precisa de um pagamento próprio.
No OpenCart 4, o pedido permanece na finalização de compra até que a página de sucesso seja exibida. Se, nesse meio-tempo, o pedido foi fechado (por exemplo, o boleto venceu ou você o cancelou), o cliente volta à finalização de compra com a mensagem The Iugu invoice was not paid (it was canceled or has expired). Your cart is kept: confirm the order again to pay., ou, se ele já tinha sido pago antes de ser fechado, com This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. Se o pedido já foi registrado e o carrinho agora tem uma nova compra, o Confirm Order recarrega a página de finalização de compra. Em cada caso, o próximo clique em Confirm Order paga um novo pedido do carrinho.
Se a Iugu não conseguir criar a fatura, o cliente permanece na etapa Confirm Order com uma mensagem curta, por exemplo Iugu could not create the invoice: com o motivo e um pedido para verificar os dados de cobrança, ou Could not connect to Iugu. Please try again in a moment. O motivo técnico é gravado no log.
A URL de notificação também funciona enquanto a loja está em modo de manutenção: o OpenCart 3 deixa passar as requisições das extensões de pagamento, e no OpenCart 4 a extensão adiciona uma ação de inicialização (startup action) que deixa passar a notificação e o retorno do cliente.
A extensão aceita apenas pagamentos únicos. Não possui formulário de cartão no site, cartões salvos, assinaturas ou cobrança recorrente, carnês, pagamentos divididos ou configurações de parcelamento — para parcelar, use as configurações da página da Iugu. Os métodos de pagamento oferecidos na página da Iugu não podem ser escolhidos nas configurações da extensão: são oferecidos todos os métodos habilitados na sua conta da Iugu.
Pedidos e reembolsos
Status do pedido
Sem status (pedido ausente): o cliente foi enviado à Iugu e não pagou, a fatura venceu ou foi cancelada, ou a Iugu ainda não confirmou o pagamento. Em Sales > Orders esses pedidos aparecem somente com o filtro Order Status definido como Missing Orders.
Order Status After Payment (padrão Processando): a Iugu confirmou o pagamento. Uma nota mostra o ID da fatura e o método de pagamento (cartão de crédito, boleto ou PIX).
Awaiting Iugu Payment Status (padrão Pendente): o cliente voltou com um boleto ou PIX gerado. O pedido passa ao status de pago quando a Iugu informa o pagamento.
Iugu Payment On Hold Status (padrão Pendente): o pagamento com cartão está autorizado mas ainda não capturado (capture-o na Iugu, e o pedido será concluído quando a Iugu informar a fatura como paga), o pagamento está em análise, a fatura foi paga apenas parcialmente, foi aberto um chargeback, a Iugu informou um valor ou moeda diferentes do pedido, ou o pagamento chegou depois que o pedido foi cancelado. As notas explicam. Verifique o pedido e conclua-o ou reembolse o pagamento.
Invoice Expired Status (padrão Falhou): a fatura de um pedido em espera venceu sem pagamento. Se a Iugu informar depois que a fatura foi paga, o pedido passa ao status de pago.
Invoice Canceled Status (padrão Cancelado): a fatura de um pedido em espera foi cancelada na Iugu.
Refunded Status (padrão Reembolsado): o pagamento foi reembolsado integralmente pela extensão ou pelo painel da Iugu.
Se outra fatura do mesmo pedido ou carrinho também estiver paga, o pedido não é alterado. Uma nota pede que você reembolse o pagamento em duplicidade na Iugu. As notas são entradas do History do pedido que o cliente não vê. Quando um pedido em espera é pago, vence ou é cancelado depois, o OpenCart notifica o cliente sobre o novo status.
Aba VibeFox Iugu Gateway
Em Sales > Orders abra um pedido pago com a Iugu. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Iugu Gateway mostra o ID da Iugu invoice (com link para a fatura na Iugu), com a etiqueta Test mode para faturas de teste, o Payment method, o Status, os valores Paid / refunded, o formulário de reembolso, o histórico de reembolsos e as Iugu notes do pedido. A aba é exibida para os usuários que têm acesso à extensão.
Reembolsos
Na aba VibeFox Iugu Gateway, informe o Amount (o valor ainda não reembolsado é preenchido), opcionalmente um Reason (optional), e clique em Refund via Iugu. Confirme a pergunta Refund this amount through Iugu? This cannot be undone. Você precisa da permissão para modificar a extensão (definida em System > Users > User Groups). O reembolso é enviado com o token do modo em que a fatura foi criada, por isso esse token precisa estar configurado.
Os reembolsos são calculados a partir do valor que a Iugu realmente recebeu pela fatura; por isso, após uma divergência de valor, você pode reembolsar até o que o cliente pagou, e não o total do pedido. Somente faturas pagas podem ser reembolsadas, e nunca mais do que o valor ainda reembolsável na Iugu. Um reembolso só é considerado concluído quando a Iugu o confirma. Se a Iugu recusar o reembolso ou não o confirmar, a aba mostra o erro e nenhum reembolso é registrado. Um reembolso bem-sucedido é adicionado ao histórico de reembolsos e às notas, com o ID da fatura e o motivo. Um reembolso total define o pedido como Refunded Status sem notificar o cliente e sem devolver os produtos ao estoque, como uma alteração manual de status. Um reembolso parcial não altera o status. Os reembolsos ficam disponíveis assim que a Iugu informa que a fatura foi paga.
As devoluções de produtos em Sales > Returns não devolvem dinheiro pela Iugu.
Um reembolso total feito no painel da Iugu define o pedido como Refunded Status com uma nota. Reembolsos parciais feitos no painel não são importados.
Chave de licença
A extensão funciona com uma chave de licença VibeFox obtida em vibefox.net. O bloco de licença License — VibeFox Iugu Gateway é o primeiro bloco em Extensions > Extensions > Payments > VibeFox Iugu Gateway > Edit, acima das configurações. Cole a chave em License key e clique em Activate. Depois disso, o bloco mostra a chave mascarada, o status (por exemplo, a data até a qual a licença está ativa e o seu domínio) e os botões Check now para verificar o status novamente, Change key para informar outra chave e Remove key para remover a chave desta loja. Abaixo deles aparecem a linha Product: opencart-payment-iugu e o link Manage licenses and domains in your account, que abre a sua conta em vibefox.net. Somente administradores com a permissão Modify para a extensão podem alterar a chave. Os textos do bloco seguem o idioma do painel administrativo (estão incluídos inglês e russo).
Se a chave não for aceita, o bloco informa o motivo, por exemplo Key not found, This key belongs to another product, Domain limit reached ou License expired on seguido de uma data. Depois que o endereço da loja muda, ou depois que você libera uma vaga de domínio na sua conta, clique em Check now. Se o servidor de licenças não puder ser acessado, a extensão continua funcionando com o último status conhecido.
Uma chave funciona em um único domínio: o endereço da loja nas configurações do OpenCart. Remover a chave da loja não libera a vaga de domínio. Libere a vaga na sua conta em vibefox.net.
Sem uma chave ativa, a Iugu não é exibida aos clientes no checkout. Se um pagamento for iniciado mesmo assim, o cliente vê This payment method is not available. Please choose another one. Um usuário administrador conectado ao painel no mesmo navegador ainda vê o método de pagamento na loja, marcado como (unlicensed — visible to admins only), para que você possa configurar e testar a extensão antes de comprar uma chave. No OpenCart 4 esta prévia não está disponível: a loja não enxerga o login do administrador, então sem uma chave ativa o método de pagamento fica oculto para todos. Depois que você abrir a página Edit uma vez, aparece um lembrete no Dashboard do painel. Feche-o com × para ocultá-lo por 7 dias. Os pedidos existentes não são afetados: pagamentos já iniciados continuam sendo confirmados, e os reembolsos funcionam.
Quando uma licença expira, a extensão continua funcionando, mas atualizações e suporte exigem renovação. O status é verificado novamente de forma automática quando você abre o Dashboard ou a página Edit do painel: uma vez por dia nos primeiros 14 dias após a chave ser informada, depois uma vez por semana. Não é necessário nenhum cron job. Desinstalar a extensão sempre remove a chave de licença e o status da licença.
Solução de problemas
A Iugu não aparece no checkout: verifique se a licença está ativa, se Enable / Disable está ativado e se o token do modo ativo está preenchido: Test API token no modo de teste, Live API token no modo real. A moeda do checkout do cliente deve ser BRL e o total, de pelo menos R$ 1,00. Confira também se o endereço de pagamento está na Geo Zone selecionada e se o pedido atinge o Total definido nas configurações. A página de configurações mostra um aviso quando o token ou a moeda estão incorretos.
O pagamento foi feito, mas o pedido continua sem status: a notificação da Iugu não chegou à sua loja ou não pôde ser verificada. Ative o Debug log e consulte o campo Log na página da extensão. Verifique se a sua loja está acessível pela internet no endereço da Notification URL e se o token do modo em que a fatura foi criada ainda está informado. A fatura também é verificada quando o cliente volta à loja depois de pagar.
A notificação responde verification failed: a fatura não pôde ser lida na API da Iugu naquele momento, por exemplo por causa de um erro de rede, de um token incorreto ou da falta do token do modo da fatura. A Iugu repete a notificação.
A notificação responde busy: o carrinho estava sendo processado por outra requisição no mesmo momento, ou o status do pedido não pôde ser definido. A Iugu repete a notificação. O log mostra o motivo.
A notificação responde invalid invoice id: a notificação não tinha um ID de fatura válido. Nada é alterado.
O pedido está no Iugu Payment On Hold Status: leia as Iugu notes na aba do pedido. Um pagamento com cartão aguarda captura, o pagamento está em análise, parcialmente pago ou contestado, o valor pago não correspondeu ao pedido, ou o pagamento chegou depois do cancelamento do pedido.
O cliente vê "Iugu payments are not available right now": o token de API está ausente ou incorreto. Verifique o token do modo ativo.
O cliente vê "A valid billing email is required for Iugu": o pedido não tem um endereço de e-mail válido.
O cliente vê "This order already has an Iugu payment that the store has to review": uma fatura anterior do pedido está autorizada, em análise ou parcialmente paga. Verifique a fatura na Iugu e o log.
O cliente vê This payment method is not available.: a sessão de checkout não corresponde mais ao pedido, ou o método de pagamento foi desativado nesse meio tempo. O cliente recarrega o checkout.
O reembolso falha: leia a mensagem na aba. Pagamentos de boleto não podem ser reembolsados pela Iugu, pagamentos via PIX podem ser reembolsados somente integralmente, e apenas faturas pagas podem ser reembolsadas. Se a mensagem disser que o pagamento foi feito em modo de teste ou real e nenhum token estiver configurado, informe o token desse modo. Se a Iugu não confirmou o reembolso, verifique a fatura na Iugu antes de tentar novamente.
Para desenvolvedores: antes de a fatura ser criada, a extensão dispara o evento do OpenCart wc_igu_invoice_data com a requisição da fatura e o pedido, por exemplo para limitar os métodos de pagamento com payable_with.
Desinstalação
Vá em Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Iugu Gateway. A chave de licença e o status da licença desta extensão são sempre removidos. O OpenCart sempre remove as próprias configurações da extensão: Enable / Disable, Sort Order, Geo Zone, Total e os status de pedido da seção Orders, que voltam aos padrões em uma reinstalação. O evento do OpenCart da extensão também é removido (no OpenCart 4, também os seus eventos e a sua ação de inicialização (startup action), que deixa passar as notificações e o retorno do cliente no modo de manutenção). Se Delete data on uninstall estiver ativado, as demais configurações do gateway (título, descrição, modo de teste, tokens de API, chave do debug log) e o log são removidos. Se estiver desativado, elas são mantidas para uma futura reinstalação. As referências às faturas da Iugu e os reembolsos são sempre mantidos, para que pedidos pagos antes possam ser reembolsados e notificações tardias continuem sendo associadas após uma reinstalação. Os pedidos existentes mantêm suas notas de pagamento.
No OpenCart 4, para remover também os arquivos da extensão, depois da desinstalação acesse Extensions > Installer e clique em Uninstall (o botão laranja −) ao lado de VibeFox Iugu Gateway na lista de extensões instaladas, depois em Delete (o botão vermelho com a lixeira) para remover o pacote enviado.
Iugu é uma marca de seu respectivo proprietário. Esta extensão não é afiliada nem endossada pela Iugu.