VibeFox Viva Wallet 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.
Conta Viva: uma conta de comerciante Viva. Você pode usar uma conta de demonstração (demo.vivapayments.com) para os testes e uma conta real (www.vivapayments.com) para pagamentos reais. Cada conta tem suas próprias credenciais. Para os pagamentos você precisa das credenciais do Smart Checkout (Client ID e Client Secret) e do Source Code de uma fonte de pagamento. O Merchant ID e a API Key são opcionais: eles só são usados para responder à verificação da URL do webhook pela Viva.
Moeda: EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK ou CHF. A moeda selecionada pelo cliente na loja precisa ser uma delas; em outras moedas o método de pagamento fica oculto na finalização da compra.
Chave de licença do 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_viva_gateway-oc3-(version).ocmod.zip e o pacote para o OpenCart 4 wcp_viva_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_viva_gateway-oc3-(version).ocmod.zip. A extensão não tem modificações OCMOD, então 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. Encontre VibeFox Viva Wallet 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 de lápis) para abrir a página de configurações. Insira sua chave de licença do VibeFox em License key, no bloco de licença no topo da página, e clique em Activate (veja License key).
4. Insira as credenciais da conta de demonstração e/ou da conta real da Viva e configure a fonte de pagamento e o webhook na sua conta Viva (veja Configuration).
5. Ative Enable/Disable e clique em Save. Faça um pagamento de demonstração com um cartão de demonstração da Viva enquanto Test Mode estiver ativo, depois desative Test Mode para passar ao modo real.
OpenCart 4
1. No painel administrativo, vá em Extensions > Installer, clique em Upload e escolha o arquivo wcp_viva_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. Encontre VibeFox Viva Wallet Gateway, clique em Install (o botão verde +) e depois em Edit (o botão de lápis).
4. Insira a chave de licença, as credenciais da Viva, a fonte de pagamento e o webhook 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. Só os endereços da conta Viva são diferentes (veja Configuration).
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 ficam na página da extensão: Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit. As seções aparecem à esquerda; o botão Save sob a lista salva a página inteira. Acima das configurações, a página avisa quando o modo atual não tem Client ID, Client Secret ou Source Code (Viva Wallet is hidden at checkout until the Demo Client ID, Client Secret and Source Code are entered., ou Live no modo real) e quando a moeda padrão da loja não é suportada. Com o modo de teste ativado, ela mostra Test mode is on: payments go to the Viva demo environment. 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 ficar vazio e deve ter no máximo 128 caracteres (Enter a title for the payment method (at most 128 characters).), Sort Order deve ser um número inteiro (Sort Order must be a whole number.), Total deve ser um número igual ou maior que 0 (Total: enter a number, 0 or greater.), e a zona geográfica e os status de pedido selecionados devem existir; caso contrário, nada é salvo e a página mostra o erro. Salvar as configurações remove os tokens de acesso da Viva em cache, para que as novas credenciais sejam usadas imediatamente.
Viva Wallet
Enable/Disable: Enable Viva Wallet payment gateway liga ou desliga o método de pagamento. Padrão: off.
Title: o nome do método de pagamento que o cliente vê na finalização da compra. Também é o nome do método de pagamento salvo no pedido. Padrão: Viva Wallet. Obrigatório, no máximo 128 caracteres.
Description: o texto mostrado ao cliente na etapa Confirm Order, acima do botão de confirmação. Padrão: Pay securely with Viva Wallet — cards, Apple Pay, Google Pay and more.
Test Mode: usa o ambiente de demonstração da Viva (demo.vivapayments.com). Novos pagamentos e chamadas à API usam as credenciais da conta de demonstração. Nenhum dinheiro real é cobrado, e na etapa Confirm Order os clientes veem (Test mode: use Viva demo cards, no real money is charged.) Padrão: on. Desative para aceitar pagamentos reais com a conta real. Pagamentos já feitos continuam sendo verificados e reembolsados no ambiente em que foram realizados.
Sort Order: a posição da Viva Wallet entre os métodos de pagamento na finalização da compra. Deixe vazio ou informe um número inteiro; números negativos são permitidos.
Geo Zone: oferece a Viva Wallet 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 para que a Viva Wallet seja oferecida: um número igual ou maior que 0. Deixe vazio para oferecê-la em qualquer total.
Demo account (test mode) and Live account
As duas seções têm os mesmos campos: um conjunto para a conta de demonstração e outro para a conta real. Na sua conta Viva, abra Settings > API Access e copie as credenciais do Smart Checkout (Client ID, Client Secret), o Merchant ID e a API Key. O Source Code fica em Sales > Online payments > Websites / apps.
Client ID (Demo) / Client ID (Live): o Client ID OAuth 2.0 do Smart Checkout da conta. Necessário para os pagamentos.
Client Secret (Demo) / Client Secret (Live): o Client Secret OAuth 2.0 do Smart Checkout da conta. Necessário para os pagamentos.
Source Code (Demo) / Source Code (Live): o código de 4 dígitos da fonte de pagamento da conta. Suas URLs de sucesso e de falha devem apontar para esta loja (veja abaixo). Necessário para os pagamentos.
Merchant ID (Demo) / Merchant ID (Live): opcional. Usado somente para responder à verificação da URL do webhook pela Viva.
API Key (Demo) / API Key (Live): opcional. Usada somente para responder à verificação da URL do webhook pela Viva.
Client Secrets e API Keys salvos nunca são exibidos novamente. O campo fica vazio e mostra Saved — leave empty to keep it. Digite um novo valor somente para alterá-lo.
Clear saved secrets: no fim da seção Live account. Marque um segredo salvo e clique em Save para removê-lo. Um campo vazio mantém o valor salvo.
Return URLs and webhook
Addresses for the Viva account: este campo mostra os três endereços da sua loja para informar na conta Viva. Eles são montados a partir do endereço da vitrine da sua instalação do OpenCart e têm esta aparência: https://your-store/index.php?route=extension/payment/wcp_viva_gateway/success&, https://your-store/index.php?route=extension/payment/wcp_viva_gateway/fail& e https://your-store/index.php?route=extension/payment/wcp_viva_gateway/webhook no OpenCart 3, e no OpenCart 4 https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.success&, https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.fail& e https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.webhook. Copie-os exatamente como as configurações os mostram. O & no final dos endereços de sucesso e de falha é necessário: a Viva acrescenta a transação ao endereço, e sem ele o OpenCart responde com página não encontrada.
Payment source: em Sales > Online payments > Websites / apps, crie uma fonte de pagamento para o domínio da sua loja, em cada conta que você usar. Como Success URL e Failure URL, informe os caminhos que seguem o domínio nos endereços de sucesso e de falha.
Webhook: em Settings > API Access > Webhooks, adicione o endereço do webhook para estes eventos:
A Viva verifica a URL antes de salvá-la. A extensão responde com a chave de verificação da sua conta: ela busca a chave com o Merchant ID e a API Key do modo atual, ou usa a chave informada abaixo. Os webhooks confirmam os pagamentos mesmo quando o cliente fecha o navegador. Os webhooks da Viva não são assinados, então a extensão nunca confia no webhook sozinho: cada pagamento é verificado pela API da Viva antes de o pedido receber seu status. Sem o webhook, um pedido só recebe seu status quando o cliente volta para a loja depois de pagar.
Webhook Verification Key: opcional. Deixe vazio para buscar a chave automaticamente com o Merchant ID e a API Key do modo atual, ou cole aqui a chave de verificação da sua conta Viva.
Order statuses
O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente). O pedido só recebe um status depois que o pagamento da Viva é verificado. Os campos de status listam os seus status de pedido do OpenCart.
Order Status After Payment: o status que um pedido pago recebe. Ele é definido de uma vez, com uma única mudança de status.
Processing Status: o status de um pedido pago para Default e Processing. Padrão: Processing.
Complete Status: o status de um pedido pago para Completed. Padrão: Complete.
On Hold Status: o status de um pedido pago para On Hold, e de um pedido cujo pagamento da Viva não corresponde ao valor ou à moeda do pedido (retido para revisão, não pago; a observação informa o motivo). Padrão: Pending, porque o OpenCart não tem o status On hold. Você pode criar um status próprio em System > Localisation > Order Statuses e selecioná-lo aqui.
Cancelled Order Status: um pagamento da Viva recebido para um pedido nesse status nunca o reabre; uma observação pede que você restaure o pedido ou reembolse o pagamento. A extensão nunca define esse status. Padrão: Canceled.
Refunded Status: definido depois que o pagamento é totalmente reembolsado pela aba do pedido. Um pagamento posterior também não reabre um pedido assim. Padrão: Refunded.
Advanced Settings
Brand Color: um código de cor HEX de 6 dígitos para a página de pagamento da Viva, por exemplo 0000ff. Um # inicial é removido. Deixe vazio para a cor padrão. Qualquer outro valor não é salvo: o restante das configurações é salvo, e a página mostra Brand Color must be a 6-digit HEX code (e.g. 0000ff). The previous value was kept.
Debug Logging: grava as requisições à API em viva_wp_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. Chaves, tokens e dados de clientes não são registrados. Erros são sempre registrados, mesmo quando esta opção está desligada. Padrão: off.
Log: mostra o tamanho e as últimas entradas do log. Clique em Clear log para esvaziá-lo.
Delete Data on Uninstall: quando ativado, desinstalar a extensão remove as configurações do gateway e o log. Pedidos e seus dados de pagamento (tentativas de pagamento da Viva, reembolsos) nunca são excluídos. Padrão: off.
Import / Export
Export: Download JSON salva as configurações em um arquivo JSON. Os segredos não são exportados.
Import: cole um JSON exportado anteriormente e clique em Import para restaurar as configurações. Os segredos salvos são mantidos.
Finalização da compra
Na etapa Payment Method, o cliente escolhe o método de pagamento (por padrão, Viva Wallet). Na etapa Confirm Order, o cliente vê a sua descrição e a observação You will be redirected to the secure Viva Wallet payment page (cards, Apple Pay, Google Pay and more). O OpenCart cria o pedido nessa etapa, ainda sem status. No OpenCart 4 o cliente escolhe o método de pagamento com o botão Choose do 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 da compra. Quando o cliente clica em Confirm Order, a extensão cria um pedido de pagamento na Viva pelo total do pedido na moeda do pedido e envia o cliente para a página Smart Checkout da Viva, com a sua Brand Color, se houver uma definida. Lá o cliente paga com um dos métodos ativados na sua conta Viva. O e-mail, o nome, o telefone, o país e o idioma da loja do cliente são passados para a Viva. O pagamento aparece na Viva como OpenCart # e o número do pedido, e é descrito ao cliente como Order, o número do pedido, at e o nome da sua loja. O pedido de pagamento na Viva expira após 30 minutos.
Depois de pagar, o cliente volta para a sua loja. O pedido só é marcado como pago depois que a Viva confirma: a extensão lê novamente a transação pela API da Viva, tanto no retorno do cliente quanto no webhook. Em seguida, o pedido recebe seu status do jeito padrão do OpenCart, com os e-mails habituais do pedido e a atualização do estoque, e o cliente vê a página de sucesso do pedido do OpenCart. Se o pagamento ainda não estiver confirmado, uma página Payment confirmation mostra We are waiting for Viva Wallet to confirm your payment. You will receive an e-mail as soon as it is confirmed. com os botões Check again e Back to checkout. O carrinho é mantido até o pagamento ser confirmado; o webhook define o status do pedido assim que a Viva confirma. No OpenCart 4, quando o cliente volta da página da Viva, uma breve página intermediária reabre o endereço de retorno da sua loja, para que o carrinho e a sessão do cliente sejam mantidos.
Se o pagamento falhar ou o cliente cancelar na página da Viva, o pedido continua sem status e o carrinho é mantido. O cliente volta à finalização da compra com The Viva Wallet payment was not completed. Please try again or choose another payment method. ou The Viva Wallet payment was cancelled. You can try again or choose another payment method. e pode pagar de novo. Cada nova tentativa inicia um novo pedido de pagamento na Viva. Um carrinho é pago somente uma vez: se o carrinho já estiver pago por outro pedido da mesma finalização de compra, o cliente vai direto para a página de sucesso. No OpenCart 4 essas mensagens são exibidas acima da página de finalização da compra. 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. 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 que falhou ou foi cancelado, o cliente paga o mesmo pedido de novo, com um novo pedido de pagamento na Viva. Se esse pedido tiver sido fechado nesse meio-tempo (por exemplo, você o cancelou), ou se foi pago para um carrinho que mudou desde então, o cliente volta à finalização da compra com This order can no longer be paid. Please confirm your order again., e o próximo Confirm Order paga um novo pedido.
Se a Viva não conseguir iniciar o pagamento, o cliente permanece na etapa Confirm Order com uma mensagem acima do botão: Viva Wallet payments are not available at the moment. Please choose another payment method or contact us. (credenciais ausentes ou incorretas) ou We could not connect to Viva Wallet. Please try again in a moment or choose another payment method. O motivo técnico é gravado no log.
As páginas de retorno mostram a página de sucesso do pedido somente para o cliente que pagou. Qualquer outra pessoa que abrir o endereço de retorno é enviada ao histórico de pedidos ou à finalização da compra, sem os detalhes do pedido.
O webhook também funciona enquanto a loja está em modo de manutenção, porque o OpenCart deixa passar as requisições das extensões de pagamento. No OpenCart 4, uma ação de inicialização da extensão deixa passar o webhook e os endereços de sucesso e de falha.
A extensão aceita somente pagamentos únicos, cobrados na hora na página da Viva. Não há pré-autorização e captura, parcelamento, cartões salvos, assinaturas, Viva Native Checkout (campos de cartão na sua própria página) nem terminais POS. Quando o cliente inicia uma nova tentativa, o pedido de pagamento antigo e não pago na Viva não é cancelado; a Viva o deixa expirar após 30 minutos.
Pedidos e reembolsos
Order statuses
Sem status (pedido ausente): o cliente foi enviado para a Viva e não pagou, o pagamento falhou ou foi cancelado, ou a Viva ainda não finalizou o pagamento. O cliente pode pagar de novo. Em Sales > Orders, esses pedidos só aparecem 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.
Order Status After Payment (padrão Processing): o pagamento foi confirmado. Uma observação mostra o valor, a transação, o código do pedido na Viva, o ambiente (demonstração ou real) e como foi confirmado (webhook ou retorno do cliente).
On Hold Status após divergência (padrão Pending): a Viva informou um valor ou uma moeda diferentes do total do pedido. O pedido não é marcado como pago, e a observação Viva Wallet payment held for review indica o motivo. Compare o pagamento no painel da Viva com o pedido e atenda-o ou reembolse-o manualmente. Se mais tarde chegar um pagamento correspondente para o mesmo pedido, ele passa para o status pago.
Um pagamento que chega para um pedido em Cancelled Order Status ou Refunded Status não altera o status do pedido; uma observação pede que você restaure o pedido ou reembolse o pagamento no painel da Viva. Se chegar um segundo pagamento para um pedido já pago, ou para outro pedido de um carrinho já pago, o pedido não é alterado; uma observação no pedido pago pede que você reembolse a duplicata no painel da Viva.
As observações são entradas do History do pedido que o cliente não vê. As mudanças de status não notificam o cliente por si mesmas; o OpenCart envia o e-mail habitual do pedido quando um pedido pago recebe o status pela primeira vez.
VibeFox Viva Wallet Gateway tab
Em Sales > Orders, abra um pedido pago com a Viva Wallet. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Viva Wallet Gateway mostra o Viva order code, o Transaction ID com um rótulo Demo nos pagamentos de demonstração, o Environment / Source Code, o Viva status, os valores Paid / refunded, o formulário de reembolso, o histórico de reembolsos, as Viva payment attempts do pedido (quando houve mais de uma) e as Viva Wallet notes do pedido. A aba é mostrada aos usuários que têm acesso à extensão.
Refunds
Na aba VibeFox Viva Wallet Gateway, informe o Amount (o valor ainda não reembolsado é preenchido), opcionalmente um Reason (optional), e clique em Refund via Viva Wallet. Confirme a pergunta Refund this amount via Viva Wallet? This cannot be undone. Reembolsos totais e parciais são aceitos para pedidos com pagamento confirmado da Viva. Você precisa ter permissão para modificar a extensão (definida em System > Users > User Groups). Você pode reembolsar até o valor que a Viva cobrou pelo pagamento, mesmo que o pedido tenha sido editado depois. O reembolso é enviado à conta em que o pagamento foi feito (demonstração ou real), na moeda do pagamento; por isso, o Client ID e o Client Secret dessa conta precisam estar informados. Se a Viva não aceitar o reembolso, a aba mostra o erro e nenhum reembolso é registrado. Um reembolso bem-sucedido é adicionado ao histórico de reembolsos e às observações, com a transação de reembolso da Viva. Um reembolso total define o pedido como Refunded Status sem notificar o cliente e sem devolver produtos ao estoque, como uma mudança manual de status. Um reembolso parcial não altera o status. Um pedido retido para revisão após uma divergência não tem pagamento confirmado e não pode ser reembolsado pela aba.
Devoluções de produtos em Sales > Returns não devolvem dinheiro pela Viva. Reembolsos feitos no painel da Viva não são importados. Atualize o pedido manualmente, se necessário.
Chave de licença
A extensão funciona com uma chave de licença do VibeFox obtida em vibefox.net. O bloco de licença License — VibeFox Viva Wallet Gateway é o primeiro bloco da página Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit, acima das configurações. Insira 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 ficam a linha Product: opencart-payment-viva e o link Manage licenses and domains in your account, que abre a sua conta em 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 vaga de domínio. Libere a vaga na sua conta em vibefox.net.
Sem uma chave ativa, a Viva Wallet não é mostrada 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ê 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 essa prévia não está disponível: a loja não enxerga o login do administrador, por isso, 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: os pagamentos já iniciados continuam sendo confirmados pelo webhook da Viva e pelo retorno à loja, e os reembolsos 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 Viva Wallet não aparece na finalização da compra: verifique se a licença está ativa, se Enable/Disable está ligado e se o modo atual tem seu Client ID, seu Client Secret e seu Source Code (os campos Demo no modo de teste, os campos Live no modo real). A moeda selecionada na loja precisa ser uma de EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK ou CHF. 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. A página de configurações mostra um aviso quando faltam credenciais.
O pagamento foi feito, mas o pedido continua sem status: o webhook não está funcionando. Na Viva, verifique se o webhook existe na conta que você usa (demonstração ou real), se a URL dele é exatamente a mostrada nas configurações e se Transaction Payment Created está selecionado. Confira se o Client ID e o Client Secret da conta desse pagamento ainda estão informados: a extensão precisa deles para verificar o pagamento. Ative o Debug Logging e consulte o campo Log. O pedido também recebe seu status quando o cliente volta para a loja depois de pagar.
O cliente volta para uma página não encontrada: a Success URL ou a Failure URL da fonte de pagamento não termina com &. Copie os caminhos exatamente como as configurações os mostram.
A Viva não consegue verificar a URL do webhook: informe o Merchant ID e a API Key do modo atual (ou a própria chave de verificação em Webhook Verification Key), salve e verifique novamente na Viva. Para verificar o webhook da outra conta, troque antes o Test Mode ou informe a chave dessa conta.
O webhook responde com erro: a Viva mostra a resposta da sua loja e repete os webhooks com falha. verification_failed (HTTP 500) significa que não foi possível acessar a API da Viva para verificar o pagamento, ou que não foi possível definir o status do pedido. busy (HTTP 503) significa que o pedido estava sendo processado por outra requisição no mesmo momento. transaction_not_found (HTTP 404) significa que a transação não existe na conta desse pagamento, por exemplo por causa de credenciais erradas. Eventos de pagamentos de outras lojas na mesma conta Viva recebem a resposta ignored.
O cliente vê um erro depois de Confirm Order: consulte o campo Log na página da extensão. Um Client ID ou Client Secret errado gera a mensagem de que os pagamentos com a Viva Wallet não estão disponíveis. Se a Viva não puder ser acessada ou recusar o pedido de pagamento, por exemplo porque o Source Code pertence a outra conta, o cliente recebe a mensagem de que a loja não conseguiu se conectar à Viva Wallet. This payment method is not available. significa que a sessão da finalização da compra não corresponde mais ao pedido: o cliente recarrega a finalização da compra.
O cliente volta e vê We could not find your order. If you were charged, please contact us.: o código do pedido da Viva no endereço de retorno não é um pagamento desta loja, por exemplo porque a fonte de pagamento de outra loja aponta para cá. Confira a Success URL e a Failure URL da fonte de pagamento.
O pedido está no status de revisão depois do pagamento: leia as observações na aba VibeFox Viva Wallet Gateway (veja Order statuses) e depois atenda o pedido ou reembolse o pagamento.
Não há formulário de reembolso na aba: a aba informa o motivo: o pedido não tem pagamento confirmado da Viva (Transaction ID not found. Cannot process refund.), já está totalmente reembolsado, faltam as credenciais da conta do pagamento, ou seu grupo de usuários não tem permissão para modificar a extensão.
O reembolso falha com This payment was made in the Viva demo (or live) environment: o Client ID e o Client Secret da conta em que o pagamento foi feito não estão informados. Informe-os e tente novamente. Outros erros de reembolso mostram a mensagem da Viva.
Desinstalação
Vá em Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Viva Wallet 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 campos de status da seção Order statuses, que voltam aos padrões em uma reinstalação. Os tokens de acesso da Viva em cache e as chaves de webhook são sempre removidos. No OpenCart 4, também são sempre removidos o evento da extensão e a sua ação de inicialização, que deixa passar o webhook e os endereços de retorno 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, credenciais, status do pedido após o pagamento, cor da marca, registro de logs) e o log são removidos. Se estiver desativado, elas são mantidas para uma reinstalação futura. As tentativas de pagamento e os reembolsos da Viva são sempre mantidos, de modo que pedidos pagos antes ainda podem ser reembolsados após uma reinstalação. Os pedidos existentes mantêm suas observações 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 Viva Wallet Gateway na lista de extensões instaladas, depois em Delete (o botão vermelho com lixeira) para remover o pacote enviado.
A Viva Wallet é uma marca registrada de seu respectivo proprietário. Esta extensão não é afiliada nem endossada pela Viva Wallet.