VibeFox Vindi for OpenCart — Ajuda
Requisitos
OpenCart: 3.0.x (testado na 3.0.5.0) ou 4.0.2 e superior (testado na 4.1.0.3).
PHP: 8.0 ou superior.
Moeda: o Real brasileiro (BRL) precisa estar configurado em System > Localisation > Currencies. A Vindi cobra somente em BRL, por isso a forma de pagamento só é exibida quando o cliente paga em BRL.
Conta na Vindi: você precisa da chave de API da sua conta na Vindi. O sandbox da Vindi é uma conta de testes separada, com chave própria. Boleto, PIX e BolePix também precisam estar ativados na sua conta da Vindi, caso você queira oferecê-los.
Chave de licença VibeFox: comprada em vibefox.net. Uma chave funciona em um 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 o OpenCart 3 wcp_vindi_gateway-oc3-(version).ocmod.zip e o pacote para o OpenCart 4 wcp_vindi_gateway.ocmod.zip. Instale somente 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_vindi_gateway-oc3-(version).ocmod.zip. A extensão não tem 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 Vindi Gateway e clique em Install (o botão verde +). O seu usuário administrador precisa do direito de modificar a lista de extensões de pagamento.
3. Clique em Edit (o botão de lápis) para abrir a página de configurações. Informe a sua chave de licença VibeFox em License key, no bloco de licença no topo da página, e clique em Activate (veja Chave de licença).
4. Cole a Sandbox API key e, quando estiver pronto, a Live API key. Escolha os Offered methods.
5. Copie a URL do webhook das configurações para a Vindi (veja Configuração).
6. Ative Enable / Disable e clique em Save. Teste um pagamento no modo sandbox e depois desative Sandbox mode para receber pagamentos reais.
OpenCart 4
1. No painel administrativo, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_vindi_gateway.ocmod.zip. Não renomeie o arquivo: o OpenCart 4 obtém o código da extensão 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. Localize VibeFox Vindi 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, as chaves de API, as formas de pagamento e o webhook como nos passos 3 a 6 para o OpenCart 3. A página de configurações e os seus campos são iguais nas duas versões. Só a URL do webhook é diferente (veja Webhook).
Uma instalação nova começa com a forma de pagamento desativada e o modo sandbox ativado.
Configuração
Todas as configurações ficam na página da extensão: Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit. As seções são listadas à esquerda; o botão Save abaixo da lista salva a página inteira. Acima das configurações, a página mostra o modo, TEST MODE ou LIVE, e avisa quando a chave de API do modo atual está vazia (a forma de pagamento então não aparece na finalização da compra) ou quando a moeda padrão da loja não é BRL (a forma de pagamento então só aparece quando o cliente paga em BRL). Sem o direito de modificar a extensão, a página mostra as configurações, mas não consegue salvá-las.
Ao salvar, as chaves são gravadas como digitadas, sem espaços no início e no fim. Se nenhuma forma de pagamento estiver selecionada, o cartão de crédito é salvo e a página mostra Choose at least one payment method — credit card was selected. Um Title vazio ou com mais de 128 caracteres, um Sort Order que não seja um número inteiro (valores negativos são permitidos), um Total que não seja um número igual ou maior que 0, ou uma zona geográfica ou um status de pedido inexistente não são aceitos: nada é salvo e a página mostra a mensagem, por exemplo Enter a title for the payment method (1 to 128 characters).
Vindi
Enable / Disable: Enable Vindi payments ativa ou desativa a forma de pagamento. Padrão: desativado.
Title: o nome da forma de pagamento exibido na finalização da compra. É também o nome da forma de pagamento salvo no pedido. Padrão: Vindi. Obrigatório, no máximo 128 caracteres.
Description: o texto exibido ao cliente na etapa Confirm Order, acima dos campos de pagamento. Padrão: Pay by credit card on the secure Vindi page, or by boleto / PIX.
Sort Order: a posição da Vindi entre as formas de pagamento na finalização da compra. Deixe em branco ou informe um número inteiro (valores negativos são permitidos).
Geo Zone: oferece a Vindi somente para endereços de pagamento na zona geográfica selecionada. Padrão: All zones. As zonas geográficas são configuradas em System > Localisation > Geo Zones.
Total: o total da finalização da compra, na moeda padrão da loja, que um pedido precisa atingir antes de a Vindi ser oferecida. Deixe em branco para oferecer a Vindi com qualquer total.
Chaves de API
Crie as chaves no painel da Vindi, em Settings > API keys: em app.vindi.com.br para produção e em sandbox-app.vindi.com.br para o sandbox. Produção e sandbox têm hosts e chaves separados. Cada pagamento lembra onde a sua cobrança foi criada, por isso as verificações, os cancelamentos e os estornos sempre usam esse ambiente.
Sandbox mode: cria os novos pagamentos no sandbox da Vindi, usando sandbox-app.vindi.com.br com a chave de API do sandbox. Os clientes veem uma nota TEST MODE na finalização da compra: Vindi sandbox: no real charges. Padrão: ativado. Desative para receber pagamentos reais.
Live API key: a chave privada da conta de produção da Vindi. Ela é enviada somente para a API da Vindi.
Sandbox API key: a chave privada da conta sandbox da Vindi.
As chaves salvas nunca são exibidas novamente. O campo fica vazio e mostra Saved — leave empty to keep it. Informe um novo valor somente para alterá-lo. Para remover uma chave salva, marque Clear the saved key on save abaixo do campo e clique em Save.
Formas de pagamento
Offered methods: as formas que os clientes podem escolher. Padrão: cartão de crédito. As formas também precisam estar ativadas na sua conta da Vindi.
Boleto, PIX e BolePix precisam do CPF ou CNPJ do cliente, que é solicitado na finalização da compra.
Notificações de pagamento (webhook)
O webhook informa à sua loja que uma cobrança foi paga, cancelada, recusada ou estornada. O campo Webhook URL desta seção mostra a URL. No OpenCart 3 ela tem o formato https://your-store/index.php?route=extension/payment/wcp_vindi_gateway/webhook&token=... e no OpenCart 4 o formato https://your-store/index.php?route=extension/wcp_vindi_gateway/payment/wcp_vindi_gateway.webhook&token=..., é formada a partir do endereço da loja na sua instalação do OpenCart e contém um token secreto criado pela extensão. Copie-a exatamente como as configurações a mostram. Na Vindi, acesse Settings > Webhooks, tanto na conta de produção quanto na do sandbox, adicione esta URL e selecione estes eventos:
A Vindi não assina as suas notificações; por isso, as requisições com token ausente ou incorreto são recusadas, e cada notificação apenas faz a extensão consultar a cobrança novamente pela API da Vindi antes que um pedido seja alterado. A URL também funciona enquanto a loja está em modo de manutenção (no OpenCart 4, uma ação de inicialização da extensão deixa passar o webhook e a página de status do pagamento). As cobranças da Vindi não têm URL de retorno, portanto, sem o webhook, um pagamento com cartão só é reconhecido quando o cliente confirma o pedido novamente com o mesmo carrinho (a cobrança paga é então encontrada), e um pagamento por boleto ou PIX quando o cliente abre o pedido novamente na conta dele (My Account > Order History).
Pedidos
O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente). Ele só recebe um status depois que a Vindi informa a cobrança; a cobrança é sempre consultada novamente na Vindi. Pedidos com boleto, PIX e BolePix recebem o status de aguardando assim que a cobrança é emitida. Cada campo abaixo lista os seus status de pedido do OpenCart. O OpenCart não tem o status Retido, por isso os status de aguardando e de retido usam Pendente por padrão; as notas do pedido os diferenciam. Você pode criar os seus próprios status em System > Localisation > Order Statuses e selecioná-los aqui.
Order Status After Payment: definido após um pagamento verificado na Vindi. Padrão: Processando.
Awaiting Vindi Payment Status: boleto, PIX ou BolePix emitido na finalização da compra; a Vindi confirma o recebimento depois. Os dados do pagamento são adicionados ao comentário do histórico que o cliente vê. Padrão: Pendente.
Vindi Payment On Hold Status: a cobrança está em análise na Vindi, a cobrança paga não corresponde ao pedido (moeda, valor, código da cobrança ou cliente na Vindi), ou foi paga depois que o pedido já havia sido cancelado. Uma nota explica o motivo. Padrão: Pendente.
Payment Error Status: a Vindi recusou a tentativa de pagamento de um pedido aguardando. O cliente ainda pode pagar a mesma cobrança; um pagamento posterior define o status após o pagamento. Padrão: Falhou.
Canceled Status: a cobrança de um pedido aguardando foi cancelada na Vindi. Quando você define um pedido desta extensão para este status, a cobrança pendente na Vindi também é cancelada. Padrão: Cancelado.
Refunded Status: definido após o estorno total do pagamento pela página do pedido. Padrão: Estornado.
Avançado
Debug log: registra chamadas de API e notificações em wc_vdi_debug.log.php, na pasta de logs do OpenCart (storage/logs; no OpenCart 4, system/storage/logs). O arquivo não pode ser aberto pela web. Erros e avisos são sempre registrados, mesmo com esta opção desativada. Chaves, o token do webhook e dados de clientes nunca são registrados. 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, desinstalar a extensão remove as configurações, o token do webhook, o cache de produtos e o log. Os pedidos e as referências das cobranças da Vindi nos pedidos são mantidos. Padrão: desativado.
Importar / Exportar
Export: Download JSON salva as configurações em um arquivo JSON. As chaves de API não são exportadas.
Import: cole um JSON exportado anteriormente e clique em Import para restaurar as configurações. As chaves de API salvas são mantidas.
Finalização da compra
Na etapa Payment Method, o cliente escolhe a forma de pagamento (por padrão, Vindi). Na etapa Confirm Order, o cliente vê a sua descrição. Quando mais de uma forma é oferecida, a caixa de pagamento mostra Pay with e uma escolha entre cartão de crédito, boleto, PIX ou BolePix. Quando boleto, PIX ou BolePix é oferecido, a caixa também tem um campo CPF or CNPJ. Ele é obrigatório quando o cartão de crédito não é oferecido; caso contrário, mostra Required for boleto and PIX. O campo é preenchido a partir de um campo personalizado do cliente ou do endereço chamado CPF ou CNPJ, quando contém um número válido. O número é validado pelos dígitos verificadores. Se algo estiver faltando, o cliente vê Please choose how you want to pay with Vindi., Please enter a valid CPF or CNPJ. ou Please enter your CPF or CNPJ — it is required for boleto and PIX. No OpenCart 4 o cliente escolhe a forma de pagamento com o botão Choose do bloco da forma de pagamento, na janela Payment method options; a caixa de pagamento com estes campos e o botão Confirm Order ficam na parte de baixo da página de finalização da compra.
Quando o cliente clica em Confirm Order, a extensão cria um cliente na Vindi para este carrinho, a partir do endereço de pagamento, e uma cobrança na Vindi para o total do pedido, em parcela única. Na Vindi, a cobrança recebe o nome Order # seguido do número do pedido do OpenCart.
Cartão de crédito: o cliente é enviado para a página de cobrança da Vindi e paga por lá. O pedido permanece sem status. A Vindi não tem URL de retorno para as cobranças, então o cliente não é devolvido automaticamente para a loja. O pedido recebe o status quando a Vindi confirma o pagamento pelo webhook. Se o cliente confirmar o pedido novamente com o mesmo carrinho e a cobrança já estiver paga, o pedido pago é confirmado e o cliente vê a página de sucesso.
Boleto, PIX e BolePix: a cobrança é emitida imediatamente, o pedido recebe o status de aguardando e o cliente chega à página de sucesso do pedido do OpenCart. Ali, e nos detalhes do pedido na conta do cliente, uma seção Payment mostra o QR code do PIX, o código PIX de copiar e colar com um botão Copy code e a data de vencimento, além de um botão Open boleto. O e-mail do pedido e o histórico de pedidos do cliente contêm o código PIX e o link do boleto. Se a Vindi não devolver os dados do boleto ou do PIX, a cobrança é cancelada e o cliente vê um erro.
O pedido só é marcado como pago depois que a Vindi confirma: a extensão consulta a cobrança na API da Vindi e verifica a moeda, se a cobrança pertence ao pedido (código da cobrança e cliente na Vindi) e se o valor pago é igual ao total do pedido. A página de sucesso e a página do pedido na conta do cliente verificam novamente, pela API, um pedido aguardando, no máximo a cada 15 segundos. Quando o pagamento foi recebido, a página de sucesso mostra Your payment with Vindi has been received. Enquanto o pagamento não estiver confirmado, mostra We are confirming your payment with Vindi. The order will be updated automatically — please do not pay again. Para um pedido cancelado, mostra This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid.
Enquanto o pagamento não estiver confirmado, a página de sucesso e a página do pedido na conta do cliente (para um pedido aguardando ou retido) também mostram um botão Check payment status. Ele verifica a cobrança mais recente do pedido na Vindi. Um pedido confirmado ou aguardando volta para a página de sucesso com os dados de pagamento. Se a cobrança ainda estiver sem pagamento, a seção Payment diz Your payment has not been completed yet. If you have already paid, the order is confirmed as soon as Vindi reports the payment — please do not pay again. e exibe os botões Pay at Vindi, Check again e Back to checkout.
O OpenCart 3 cria um novo pedido sempre que a etapa Confirm Order é exibida, e o OpenCart 4 atualiza o pedido da finalização da compra, então a extensão cobra cada carrinho apenas uma vez. Se outro pedido do mesmo carrinho já estiver pago, aguardando boleto ou PIX, ou retido, o cliente vai para a página de sucesso e nenhuma nova cobrança é emitida. Uma nova tentativa para o mesmo pedido reutiliza a cobrança pendente na Vindi se a forma, o valor e o ambiente forem os mesmos. Caso contrário, a cobrança anterior é cancelada na Vindi antes que outra seja criada, para que o cliente não consiga pagar duas vezes o mesmo carrinho. Uma alteração do carrinho, inclusive uma nova quantidade, conta como um novo carrinho que precisa de um pagamento próprio.
No OpenCart 4 o pedido permanece na finalização da compra até a página de sucesso ser exibida. Depois de um pagamento com cartão recusado ou de uma cobrança cancelada, o cliente paga o mesmo pedido de novo. Se, nesse meio-tempo, esse pedido tiver sido fechado sem pagamento, o cliente volta à finalização da compra, e o próximo Confirm Order paga um novo pedido: para um pedido cancelado aparece This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid., para um pedido com falha Your Vindi payment attempt was rejected. You can try again below. No OpenCart 4, as mensagens da página de status Payment que levam de volta à finalização da compra são exibidas acima da página de finalização da compra.
Se a Vindi não conseguir iniciar o pagamento, o cliente permanece na etapa Confirm Order com uma mensagem curta acima do botão, por exemplo para verificar o CPF / CNPJ, o endereço de cobrança (rua, CEP, cidade e estado são obrigatórios para o boleto), o e-mail ou o telefone, ou informando que a Vindi está temporariamente indisponível. O motivo técnico é gravado no log.
A extensão aceita pagamentos avulsos em parcela única. Ela não tem assinaturas nem cobranças recorrentes, cartões salvos, parcelamento nem formulário de cartão no seu site: o cartão é sempre digitado na página da Vindi. O número da residência e o bairro não fazem parte do endereço do OpenCart, por isso não são enviados à Vindi.
Pedidos e estornos
Status de pedido
Sem status (pedido ausente): um pagamento com cartão foi iniciado e a Vindi ainda não o confirmou. Em Sales > Orders, esses pedidos aparecem somente com o filtro Order Status definido como Missing Orders. No OpenCart 4.1, esse pedido também pode ter o status Voided, que o OpenCart define quando a etapa de confirmação é exibida novamente; a extensão o considera um pedido sem status.
Awaiting Vindi Payment Status (padrão Pendente): um pagamento por boleto, PIX ou BolePix está aguardando. O pedido passa para Order Status After Payment quando a Vindi informa que a cobrança foi paga.
Order Status After Payment (padrão Processando): o pagamento foi confirmado. O pedido recebe o status da forma habitual do OpenCart, com os e-mails de pedido de costume e a atualização do estoque. Uma nota mostra a cobrança na Vindi, o valor e o ambiente.
Vindi Payment On Hold Status (padrão Pendente): a cobrança na Vindi está em análise, a cobrança paga não corresponde ao pedido (moeda, valor, código da cobrança ou cliente na Vindi), ou a cobrança foi paga depois que o pedido havia sido cancelado. A nota explica. Verifique o pedido e o estoque, depois conclua o pedido ou estorne o pagamento.
Payment Error Status (padrão Falhou): a Vindi recusou a tentativa de pagamento de um pedido aguardando. A nota mostra o motivo informado pela adquirente, se houver. O cliente ainda pode pagar a mesma cobrança, e um pagamento posterior move o pedido para Order Status After Payment.
Canceled Status (padrão Cancelado): a cobrança de um pedido aguardando foi cancelada na Vindi. Quando você define um pedido com este status no OpenCart, a cobrança pendente na Vindi também é cancelada, de modo que não pode mais ser paga. Se isso não for possível, uma nota pede que você cancele a cobrança no painel da Vindi.
Refunded Status (padrão Estornado): o pagamento foi estornado integralmente pela extensão.
Se uma segunda cobrança for paga para um pedido que já está pago, ou para outro pedido de um carrinho que já está pago, o pedido não é alterado. Uma nota no pedido pago pede que você estorne um dos pagamentos na Vindi. As notas são registros do History do pedido que o cliente não vê.
Aba VibeFox Vindi Gateway
Em Sales > Orders, abra um pedido pago com a Vindi. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Vindi Gateway mostra a Vindi bill, a Charge, o ambiente (com o selo Sandbox para pagamentos de sandbox), o Payment method, o Status, os valores Paid / refunded, o formulário de estorno, o histórico de estornos, todas as Bills of this cart e as Vindi notes do pedido. A aba é exibida para usuários que têm acesso à extensão.
Estornos
Na aba VibeFox Vindi Gateway, informe o Amount (o valor ainda não estornado é preenchido), opcionalmente um Reason (optional), e clique em Refund via Vindi. Confirme a pergunta Refund this amount through Vindi? This cannot be undone. São aceitos estornos totais e parciais de pagamentos com cartão e PIX. Você precisa do direito de modificar a extensão (definido em System > Users > User Groups). Os estornos são limitados ao valor que a Vindi de fato cobrou; por isso, após uma divergência, você pode estornar até o que o cliente pagou, e não o total do pedido. O estorno é enviado no ambiente do pagamento (produção ou sandbox), então a chave de API desse ambiente precisa estar configurada.
Um estorno total também cancela a cobrança na Vindi e define o pedido como Refunded Status sem notificar o cliente e sem devolver produtos ao estoque, como uma alteração manual de status. Um estorno parcial não altera o status. Um estorno bem-sucedido é adicionado ao histórico de estornos e às notas, com a cobrança da Vindi e o status. Se a Vindi ou a adquirente recusar o estorno, a aba mostra o erro e nenhum estorno é registrado. Os estornos ficam disponíveis depois que a Vindi informa que a cobrança foi paga.
A Vindi não pode estornar pagamentos por boleto. A aba mostra Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually.
As devoluções de produtos em Sales > Returns não devolvem dinheiro pela Vindi. Os estornos feitos no painel da Vindi chegam pelo webhook charge_refunded e são adicionados às notas. O status do pedido não é alterado automaticamente. Atualize-o manualmente, se necessário.
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 Vindi Gateway é o primeiro bloco em Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit, acima das configurações. Informe 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 estão a linha Product: opencart-payment-vindi e o link Manage licenses and domains in your account, que abre a sua conta na vibefox.net. Somente usuários administradores com a permissão Modify para a extensão podem alterar a chave. Os textos do bloco seguem o idioma do painel administrativo (inglês e russo estão incluídos).
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 mudar, ou depois que você liberar 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 domínio: o endereço da loja na configuração do OpenCart. Remover a chave da loja não libera a sua vaga de domínio. Libere a vaga na sua conta vibefox.net.
Sem uma chave ativa, a Vindi não é exibida aos clientes na finalização da compra. Se mesmo assim um pagamento for iniciado, o cliente vê This payment method is not available. Please choose another one. Um usuário administrador que esteja conectado ao painel no mesmo navegador ainda vê a forma de pagamento na loja, marcada como (unlicensed — visible to admins only), para que você possa configurar e testar a extensão antes de comprar uma chave. No OpenCart 4 essa prévia não está disponível: a loja não enxerga o login do administrador, por isso, sem uma chave ativa, a forma de pagamento fica oculta 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: os pagamentos já criados continuam sendo confirmados pelo webhook da Vindi, e os estornos funcionam.
Quando uma licença expira, a extensão continua funcionando, mas atualizações e suporte precisam de renovação. O status é verificado novamente de forma automática quando você abre o Dashboard do painel administrativo ou a página Edit: 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 Vindi não aparece na finalização da compra: verifique se a licença está ativa, se Enable / Disable está ativado, se o cliente paga em BRL, se pelo menos uma forma está selecionada em Offered methods e se o modo atual tem uma chave de API: Sandbox API key no modo sandbox, Live API key no modo de produção. A página de configurações mostra um aviso quando a chave está ausente ou quando a moeda da loja não é BRL. Verifique também se o endereço de pagamento está na Geo Zone selecionada e se o pedido atinge o Total definido nas configurações.
O pagamento foi feito, mas o pedido permanece sem status ou no status de aguardando: o webhook não está funcionando. Na Vindi, verifique se o webhook existe na conta que você usa (produção ou sandbox), se a URL dele é exatamente a mostrada nas configurações, incluindo o token, e se os quatro eventos estão selecionados.
O webhook responde Forbidden: o token na URL está ausente ou incorreto. Copie a URL novamente das configurações.
O webhook responde Verification failed, retry later: não foi possível ler a cobrança na API da Vindi (por exemplo, a chave de API desse ambiente foi removida), o carrinho estava sendo atualizado por outra requisição naquele mesmo momento, ou não foi possível definir o status do pedido. A Vindi enviará a notificação novamente. O log mostra o motivo.
A URL do webhook mostra Method not allowed no navegador: isso é normal. A URL aceita somente requisições da Vindi.
O cliente vê This payment method is temporarily unavailable: a Vindi recusou a chave de API. Verifique a chave do modo atual.
O cliente vê um erro depois de Confirm Order: veja o campo Log na página da extensão. Os erros são registrados mesmo com Debug log desativado. Para o boleto, o endereço de cobrança precisa ter rua, CEP, cidade e estado.
O pedido está no status retido: leia as notas na aba VibeFox Vindi Gateway (veja Status de pedido), depois conclua o pedido ou estorne o pagamento.
Pedidos antigos de sandbox depois da troca para produção: cada pagamento mantém o ambiente da sua cobrança. Verificações, cancelamentos e estornos de pedidos de sandbox continuam usando a chave do sandbox enquanto ela estiver nas configurações.
O estorno falha: leia a mensagem. Pagamentos por boleto não podem ser estornados pela Vindi, e a chave de API do ambiente do pagamento precisa estar configurada. Sem o direito de modificar a extensão, a aba informa You do not have permission to refund orders (modify this extension).
Para desenvolvedores: antes de o cliente e a cobrança serem criados na Vindi, a extensão dispara os eventos do OpenCart wc_vdi_customer_request e wc_vdi_bill_request com os dados da requisição e o pedido.
Desinstalação
Vá em Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Vindi 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 nova instalação. Os eventos do OpenCart da extensão também são removidos (no OpenCart 4, também a sua ação de inicialização, que deixa passar o webhook e a página de status do pagamento no modo de manutenção). Se Delete data on uninstall estiver ativado, as demais configurações (título, descrição, modo sandbox, chaves de API, formas de pagamento, registro de log), o token do webhook, o cache de produtos e o log são removidos. Se estiver desativado, são mantidos para uma reinstalação posterior. As cobranças e os estornos da Vindi dos pedidos são sempre mantidos, então pedidos pagos antes ainda podem ser estornados após uma reinstalação. Os pedidos existentes mantêm as suas notas de pagamento.
No OpenCart 4, para remover também os arquivos da extensão, vá em Extensions > Installer após a desinstalação e clique em Uninstall (o botão laranja −) ao lado de VibeFox Vindi Gateway na lista de extensões instaladas, depois em Delete (o botão vermelho com lixeira) para remover o pacote enviado.
A Vindi é uma marca comercial de seu respectivo proprietário. Esta extensão não é afiliada nem endossada pela Vindi.