Voltar

VibeFox Adyen for OpenCart — Ajuda

Requisitos

OpenCart: 3.0.x (testado na versão 3.0.5.0) ou 4.0.2 ou superior (testado na versão 4.1.0.3).

PHP: 8.0 ou superior.

Conta Adyen: você precisa do nome da sua conta de comerciante na Adyen, de uma chave de API e de uma chave HMAC para cada ambiente que usar (teste e produção) e, para pagamentos reais, do prefixo de URL de produção. A chave de API pertence a uma credencial de API com as funções Checkout webservice e Merchant PAL webservice. A chave HMAC é gerada para o webhook Standard (veja Configuration). O Customer Area de teste é ca-test.adyen.com, e o de produção é ca-live.adyen.com. As chaves de teste e de produção são diferentes. Não é necessária nenhuma chave de cliente, porque a página de pagamento é hospedada pela Adyen.

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 das duas versões do OpenCart. Descompacte-o no seu computador. Ele contém o README.txt, o pacote do OpenCart 3, wcp_adyen_gateway-oc3-(version).ocmod.zip, e o pacote do OpenCart 4, wcp_adyen_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, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_adyen_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 do arquivo para a pasta raiz da sua loja.

2. Acesse Extensions > Extensions e escolha o tipo Payments. Localize VibeFox Adyen 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 com o lápis) para abrir a página de configurações. Cole 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. Informe a sua conta de comerciante, a chave de API de teste e a chave HMAC de teste e, depois, a chave de API de produção, a chave HMAC de produção e o prefixo de URL de produção.

5. No Customer Area da Adyen (teste e produção), adicione um webhook Standard com a URL exibida na seção Webhook das configurações (veja Configuração).

6. Ative Enable/Disable e clique em Save. Faça um pagamento de teste com Test mode ativado e, depois, desative-o.

OpenCart 4

1. No painel administrativo, acesse Extensions > Installer, clique em Upload e escolha o arquivo wcp_adyen_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. Acesse Extensions > Extensions e escolha o tipo de extensão Payments. Localize VibeFox Adyen Gateway, clique em Install (o botão verde +) e depois em Edit (o botão com o lápis).

4. Informe a chave de licença e as configurações como nas etapas 3 a 6 do 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 de teste ativado.

Configuração

Todas as configurações ficam na página da extensão: Extensions > Extensions > Payments > VibeFox Adyen Gateway > Edit. As seções aparecem à esquerda; o botão Save abaixo da lista salva a página inteira. Enquanto as configurações do modo atual estiverem incompletas, a página mostra Adyen is hidden at checkout until the test settings are complete (ou as configurações de produção) e lista o que está faltando: Merchant account, a chave de API, a chave HMAC e, no modo de produção, Live URL prefix. Enquanto o modo de teste estiver ativado, a página mostra Test mode is on: payment links and refunds go to the Adyen test environment, no real money. Sem o direito de modificar a extensão, a página mostra as configurações, mas não consegue salvá-las.

Ao salvar, Title deve ter de 1 a 128 caracteres, Sort Order precisa ser um número inteiro e Total um número igual ou maior que 0; a zona geográfica e os status de pedido precisam existir. Caso contrário, nada é salvo e a página indica o campo. Uma chave HMAC que não seja hexadecimal, ou um prefixo de URL de produção com caracteres diferentes de letras, dígitos e hífens, não são salvos: um aviso indica o campo, o valor anterior é mantido e as demais configurações são salvas.

Adyen

Enable/Disable: Enable Adyen payment gateway ativa ou desativa a forma de pagamento. Padrão: desativado.

Title: o nome da forma de pagamento que o cliente vê na finalização de compra. Ele também é o nome da forma de pagamento armazenado no pedido. Padrão: Adyen. Obrigatório, até 128 caracteres.

Description: o texto mostrado ao cliente na etapa Confirm Order, acima do botão de confirmação. Padrão: Pay securely via Adyen.

Sort Order: a posição da Adyen entre as formas de pagamento da finalização de compra. Deixe vazio ou informe um número inteiro.

Geo Zone: oferece a Adyen apenas 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 valor total da finalização de compra, na moeda padrão da loja, que um pedido precisa atingir para que a Adyen seja oferecida. Deixe vazio para oferecer a Adyen com qualquer valor.

Conta Adyen

As chaves de API são criadas no Customer Area da Adyen, em Developers > API credentials (a seção traz links para o Customer Area de teste e o de produção). Preencha os dois conjuntos de chaves; a chave Test mode seleciona qual deles é usado.

Test mode: usa o ambiente de teste da Adyen (sem dinheiro real). Quando ativado, os links de pagamento e os reembolsos são enviados a checkout-test.adyen.com com a chave de API de teste. Padrão: ativado. Desative para receber pagamentos reais. Enquanto estiver ativado, os clientes veem Test mode: no real payment is taken. na etapa Confirm Order.

Merchant account: o nome da sua conta de comerciante na Adyen (não a conta da empresa), por exemplo MyShopECOM. Normalmente é o mesmo no Customer Area de teste e no de produção.

Credenciais de teste

Usadas enquanto Test mode estiver ativado.

Test API key: do Customer Area de teste: Developers > API credentials > a sua credencial > API key.

Test HMAC key: do Customer Area de teste: Developers > Webhooks > o seu webhook Standard > HMAC key (hexadecimal). Obrigatória: webhooks sem uma assinatura válida são recusados.

Credenciais de produção

Usadas quando Test mode estiver desativado.

Live API key: do Customer Area de produção: Developers > API credentials > a sua credencial > API key.

Live HMAC key: do Customer Area de produção: Developers > Webhooks > o seu webhook Standard > HMAC key (hexadecimal).

Live URL prefix: do Customer Area de produção: Developers > API URLs, por exemplo 1797a841fbb37ca7-AdyenDemo, a partir de https://1797a841fbb37ca7-AdyenDemo-checkout-live.adyenpayments.com. Você pode colar a URL inteira; o prefixo é extraído dela ao salvar.

As chaves de API e HMAC salvas nunca são exibidas novamente. O campo fica vazio e mostra Saved — leave empty to keep it. Digite um novo valor somente se quiser alterá-lo. Para remover uma chave salva, marque Clear the saved value on save abaixo do campo e clique em Save.

Webhook

Os pedidos só são marcados como pagos por webhooks da Adyen. No Customer Area (teste e produção), acesse Developers > Webhooks e adicione um Standard webhook com a URL exibida em Webhook URL nesta seção. No OpenCart 3 ela tem este formato: https://your-store/index.php?route=extension/payment/wcp_adyen_gateway/webhook, e no OpenCart 4: https://your-store/index.php?route=extension/wcp_adyen_gateway/payment/wcp_adyen_gateway.webhook. Ela é montada a partir do endereço da vitrine da sua instalação do OpenCart. Copie a URL exatamente como as configurações a mostram, porque a Adyen não segue redirecionamentos. Escolha o método JSON, ative Generate HMAC key e copie a chave para Test HMAC key ou Live HMAC key.

O ambiente de cada notificação seleciona a chave HMAC, e uma notificação é aplicada somente a um link de pagamento criado no mesmo ambiente e com a mesma conta de comerciante. Uma notificação de teste nunca confirma um pagamento real. Webhooks sem uma assinatura válida são recusados com HTTP 401, e a Adyen os reenvia depois. Sem o webhook, nenhum pedido recebe um status.

A extensão trata estes eventos (eles também estão listados nesta seção):

AUTHORISATION: o pagamento foi autorizado (o pedido recebe o seu status depois da verificação do valor) ou recusado (a tentativa de pagamento é marcada como falha, e o cliente pode pagar novamente).
CAPTURE: o pagamento foi capturado; uma nota é adicionada.
CAPTURE_FAILED: a captura falhou; um pedido pago é movido para o status de análise.
CANCELLATION: o pagamento deste pedido foi cancelado na Adyen; o pedido recebe o status cancelado.
REFUND: um reembolso foi confirmado ou falhou; uma nota é adicionada.
REFUND_FAILED: um reembolso falhou; uma nota avisa que o dinheiro não foi devolvido.
Se um reembolso total enviado pela página do pedido falhar (REFUND sem sucesso ou REFUND_FAILED) enquanto o pedido ainda estiver no status reembolsado, o pedido vai para o status de análise com uma nota, porque o dinheiro não foi devolvido.

Os demais eventos são adicionados às notas do pedido. Notificações de um pedido sem status, exceto AUTHORISATION, são ignoradas. Notificações que não são de um pedido desta loja, por exemplo o botão de teste no Customer Area, são aceitas e ignoradas. 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, a extensão adiciona para isso uma startup action.

Pedidos

O OpenCart cria o pedido na etapa Confirm Order sem status (um pedido ausente). Ele só recebe um status quando a Adyen confirma o pagamento com o webhook AUTHORISATION assinado e o valor e a moeda coincidem com o pedido. O retorno do cliente nunca altera o pedido. Cada campo abaixo lista os seus status de pedido do OpenCart.

Order status after payment: o status definido por um webhook AUTHORISATION bem-sucedido e assinado. Padrão: Em processamento.

On hold (review) status: uma divergência de valor ou moeda, uma captura com falha de um pedido pago, ou um pagamento recebido depois que o status do pedido já tinha sido alterado (por exemplo, cancelado). Uma nota explica o motivo. Padrão: Pendente de pagamento, porque o OpenCart não tem o status On hold. Você pode criar o seu próprio status em System > Localisation > Order Statuses e selecioná-lo aqui.

Cancelled status: definido quando a Adyen cancela o pagamento do pedido (CANCELLATION). Padrão: Cancelado.

Refunded status: definido depois que o pagamento é totalmente reembolsado pela página do pedido. Se a Adyen informar depois que esse reembolso falhou, o pedido vai para o status de análise com uma nota. Padrão: Reembolsado.

Avançado

Debug log: grava as chamadas à API e os eventos dos webhooks em adyg_debug.log.php, na pasta de logs do OpenCart (storage/logs). O arquivo não pode ser aberto pela web e, ao atingir 5 MB, é movido para adyg_debug.old.log.php. Os erros são sempre registrados, mesmo com a opção desativada. Os logs nunca contêm chaves de API ou HMAC, nem dados pessoais dos compradores. 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. Os registros de pagamento da Adyen (referências PSP, eventos de webhook, reembolsos) são sempre mantidos, de modo que pedidos antigos continuam reembolsáveis. Padrão: desativado.

Importação / Exportação

Export: Download JSON salva as configurações em um arquivo JSON. As chaves de API e HMAC não são exportadas.

Import: cole um JSON exportado anteriormente e clique em Import para restaurar as configurações. As chaves salvas são mantidas.

Finalização de compra

Na etapa Payment Method, o cliente escolhe a forma de pagamento (por padrão, Adyen). Na etapa Confirm Order, o cliente vê a sua descrição e a nota You will be redirected to Adyen to complete the payment securely. O OpenCart cria o pedido nessa etapa, ainda sem status. Quando o cliente clica em Confirm Order, a extensão cria um link de pagamento da Adyen pelo total do pedido, na moeda do pedido, e envia o cliente para a página de pagamento da Adyen. Lá, o cliente paga com qualquer método habilitado na sua conta da Adyen. O e-mail, o nome e o país de cobrança do cliente (ou o país da loja) e o idioma da loja são enviados à Adyen, e o pagamento aparece como Order # seguido do número do pedido.

Depois de pagar, o cliente volta para a sua loja. O retorno em si não paga um pedido: o pedido só é marcado como pago quando a Adyen o confirma com o webhook AUTHORISATION assinado e o valor e a moeda coincidem com o pedido. Então o pedido recebe o seu status da forma padrão do OpenCart, com os e-mails habituais do pedido e a atualização do estoque. Se o webhook já tiver chegado, o cliente vê a página de sucesso do pedido do OpenCart com Your payment with Adyen has been received. (ou Your payment with Adyen has been received and is being reviewed by the store. para um pedido em análise). Se a Adyen cancelou o pagamento antes disso, a página mostra Your Adyen payment was not completed. Please contact us about this order. Se o webhook ainda não tiver chegado, uma página de Payment confirmation mostra Your payment is being confirmed by Adyen. Your order will be confirmed as soon as Adyen confirms the payment, and you will receive an e-mail. com os botões Check again e Back to checkout, para um cliente que não concluiu o pagamento.

Se o pagamento for recusado, o pedido permanece sem status e o cliente pode pagar pelo mesmo link ou voltar à finalização de compra. Cada nova tentativa (o OpenCart 3 cria um novo pedido sempre que a etapa Confirm Order é exibida, e o OpenCart 4 atualiza o pedido da finalização de compra) invalida os links de pagamento anteriores do pedido e do carrinho, de modo que também não podem ser pagos. Se o pedido já tiver um status, o cliente vai para a página de sucesso em vez de iniciar um novo pagamento.

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, e clica em Confirm Order na parte inferior da página de finalização de compra. O endereço de pagamento é opcional no OpenCart 4: sem ele, o nome do cliente é enviado como nome do pagador e o país do endereço de entrega (ou o país da loja) como país. O OpenCart 4 mantém um único pedido para a finalização de compra e o atualiza: Back to checkout e um novo Confirm Order criam um novo link de pagamento para o mesmo pedido e expiram o anterior. Se, nesse meio-tempo, esse pedido tiver sido fechado sem pagamento (por exemplo, se a Adyen cancelou o pagamento ou você cancelou o pedido), o cliente é enviado de volta à finalização de compra com a mensagem Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. acima da página de finalização, e o próximo Confirm Order paga um novo pedido. Se o pedido da finalização de compra já tiver sido pago para outro carrinho, o cliente volta à finalização de compra e paga um novo pedido. Qualquer alteração do carrinho, inclusive uma nova quantidade, conta como um novo carrinho que precisa de um pagamento próprio.

Se o link de pagamento não puder ser criado, o cliente permanece na etapa Confirm Order com Payment could not be initiated. Please try again or choose another payment method. O motivo é gravado no log. Se as configurações estiverem incompletas, a mensagem é Payment gateway is not configured properly. Please contact the store administrator.

A extensão não tem assinaturas ou pagamentos recorrentes, cartões salvos, campos de cartão no próprio site (Drop-in ou Components), botões de captura ou cancelamento no OpenCart, nem autenticação básica para os webhooks.

Pedidos e reembolsos

Status do pedido

No status (missing order): o cliente foi enviado à Adyen e não pagou, o pagamento foi recusado, ou a Adyen ainda não confirmou o pagamento. Em Sales > Orders, esses pedidos só aparecem com o filtro Order Status definido como Missing Orders.

Order status after payment (default Processing): o pagamento foi autorizado. Uma nota mostra o valor, a referência PSP e a forma de pagamento.

On hold (review) status (default Pending): a Adyen confirmou um valor ou uma moeda diferentes do total do pedido, uma captura falhou, um reembolso total falhou, ou o pagamento chegou depois que o status do pedido já tinha sido alterado, por exemplo para cancelado. A nota explica. Confira o pagamento no Customer Area e, depois, processe o pedido ou reembolse o pagamento. Um pagamento correto de um pedido em análise após uma divergência o marca como pago.

Cancelled status (default Canceled): o pagamento deste pedido foi cancelado na Adyen.

Refunded status (default Refunded): o pagamento foi totalmente reembolsado pela extensão. O status é definido quando o reembolso é enviado; se a Adyen informar depois que esse reembolso falhou, o pedido vai para o status de análise.

Se chegar um segundo pagamento bem-sucedido para um pedido que já está pago, por exemplo a partir de um link de pagamento antigo, o pedido não é alterado. Uma nota pede que você confira no Customer Area se há uma cobrança duplicada e, se necessário, reembolse-a por lá. O mesmo vale para um carrinho: depois que um pedido do carrinho é pago, nenhum novo link de pagamento é criado para outro pedido desse carrinho, e um pagamento que ainda chegue para esse pedido não lhe atribui status; o pedido pago recebe a nota.

No OpenCart 4, um pedido não pago da finalização de compra pode receber o status Voided, que o OpenCart 4 define quando o cliente volta à etapa Confirm Order. A extensão trata esse pedido como um pedido sem status, e um pagamento posterior ainda o confirma.

As notas são entradas do History do pedido que o cliente não vê.

Aba VibeFox Adyen Gateway

Em Sales > Orders, abra um pedido pago com a Adyen. Na parte inferior da página do pedido, ao lado de History e Additional, a aba VibeFox Adyen Gateway mostra a PSP reference com a etiqueta Test mode nos pagamentos de teste, o Payment link, a Merchant account, o Status do pagamento, os valores Paid / refunded, o formulário de reembolso, o histórico de reembolsos e as Adyen notes do pedido. A aba é mostrada aos usuários que têm acesso à extensão.

Reembolsos

Na aba VibeFox Adyen Gateway, informe o Amount (é preenchido o valor que ainda não foi reembolsado), opcionalmente um Reason (optional), e clique em Refund via Adyen. Confirme a pergunta Refund this amount through Adyen? This cannot be undone. Reembolsos totais e parciais são suportados. Você precisa do direito de modificar a extensão (definido em System > Users > User Groups). Os reembolsos são feitos no valor e na moeda que a Adyen autorizou; por isso, depois de uma divergência de valor ou moeda, você pode reembolsar até o que o cliente realmente pagou, e não o total do pedido. O reembolso é enviado ao ambiente e à conta de comerciante com os quais o pagamento foi feito, portanto a chave de API desse ambiente precisa estar configurada. Apenas um reembolso por pedido é executado por vez. Se a Adyen não aceitar a requisição, a aba mostra o erro e nenhum reembolso é registrado. Os reembolsos ficam disponíveis assim que a Adyen autoriza o pagamento.

A Adyen processa os reembolsos de forma assíncrona: a requisição é incluída no histórico de reembolsos e nas notas com o status received, e o resultado final chega pelo webhook REFUND ou REFUND_FAILED. Um reembolso com falha deixa de contar como reembolsado. Quando os reembolsos enviados atingem o valor pago, o pedido passa para o Refunded status sem notificar o cliente e sem devolver os produtos ao estoque, como em uma alteração manual de status. Um reembolso parcial não altera o status. Com captura manual na Adyen, apenas pagamentos capturados podem ser reembolsados.

As devoluções de produtos em Sales > Returns não devolvem dinheiro pela Adyen. Os reembolsos feitos no Customer Area da Adyen chegam por webhook e são incluídos nas notas. O status do pedido não muda automaticamente.

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 Adyen Gateway é o primeiro bloco em Extensions > Extensions > Payments > VibeFox Adyen 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 ficam a linha Product: opencart-payment-adyen 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 administrador (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 de mudar o endereço da loja, ou depois de 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 único 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 Adyen não é mostrada aos clientes na finalização de compra. 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 administrador 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 vê o login no 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 administrador. Feche-o com × para ocultá-lo por 7 dias. Os pedidos existentes não são afetados: os 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 a renovação. O status é verificado de novo automaticamente quando você abre o Dashboard ou a página Edit do administrador: 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 Adyen não aparece na finalização de compra: verifique se a licença está ativa, se Enable/Disable está ativado e se as configurações do modo atual estão completas: Merchant account, a chave de API e a chave HMAC desse modo e, no modo de produção, Live URL prefix. A página de configurações lista o que está faltando. 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.

O pagamento foi feito, mas o pedido continua sem status: o webhook não está funcionando. No Customer Area do ambiente que você usa (teste ou produção), verifique se o webhook Standard existe, se a URL dele é exatamente a exibida em Webhook URL e se o método é JSON. Confira se a chave HMAC desse webhook está no campo correspondente (Test HMAC key ou Live HMAC key). Com uma chave HMAC inválida ou ausente, a extensão responde HTTP 401 e a Adyen tenta a entrega novamente depois, então o pedido recebe o status automaticamente assim que a chave for corrigida. O log mostra que a assinatura HMAC é inválida ou que a chave HMAC não está configurada.

O webhook responde [rejected] HMAC key not configured: a chave HMAC do ambiente da notificação está vazia. Cole-a nas configurações.

O webhook responde [rejected] invalid HMAC signature: a chave HMAC pertence a outro webhook ou a outro ambiente. Se um item de um lote tiver assinatura incorreta, o lote inteiro é recusado.

O webhook responde [rejected] busy, retry later: o pedido estava sendo processado por outra entrega no mesmo momento, ou o processamento falhou. A Adyen tenta o webhook novamente de forma automática. O motivo está no log.

A URL do webhook mostra [rejected] POST required no navegador: isso é normal. A URL aceita apenas notificações da Adyen.

Aviso sobre a chave HMAC ao salvar: o campo deve conter a chave HMAC hexadecimal do Customer Area. O valor anterior foi mantido.

O cliente vê Payment could not be initiated: veja o campo Log na página da extensão (os erros são sempre registrados). Confira a chave de API, a conta de comerciante e, no modo de produção, o prefixo de URL de produção.

O cliente vê This payment method is not available. Please reload the checkout page.: a sessão da finalização de compra não corresponde mais ao pedido, ou a forma de pagamento foi desativada entretanto. O cliente recarrega a finalização de compra.

O pedido está no status de análise após o pagamento: leia as notas na aba VibeFox Adyen Gateway. O valor ou a moeda confirmados pela Adyen não correspondiam ao pedido, uma captura falhou, ou o pagamento chegou depois que o status do pedido já tinha sido alterado.

Não há formulário de reembolso na aba: a aba informa o motivo: a Adyen ainda não autorizou o pagamento, ele já foi totalmente reembolsado, o seu grupo de usuários não tem o direito de modificar a extensão, ou as credenciais do ambiente em que o pagamento foi feito não estão configuradas.

O reembolso falha: a aba mostra a mensagem da Adyen. Com captura manual, apenas pagamentos capturados podem ser reembolsados. Se outro reembolso do pedido estiver em andamento, aguarde um momento e tente novamente.

Para desenvolvedores: antes de o link de pagamento ser criado, a extensão dispara o evento do OpenCart adyg_payment_link_request com os dados da requisição e o pedido.

Desinstalação

Acesse Extensions > Extensions, escolha o tipo Payments e clique em Uninstall (o botão vermelho −) ao lado de VibeFox Adyen 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, os seus eventos e a sua startup action, que deixa o webhook passar 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, conta de comerciante, chaves, prefixo de URL de produção, registro de log) e o log são removidos. Se estiver desativado, elas são mantidas para uma reinstalação futura. Os registros de pagamento da Adyen (referências PSP, eventos de webhook, reembolsos) são sempre mantidos, de modo que pedidos pagos antes ainda podem ser reembolsados depois de 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, acesse Extensions > Installer após a desinstalação e clique em Uninstall (o botão laranja −) ao lado de VibeFox Adyen Gateway na lista de extensões instaladas. Depois, clique em Delete (o botão vermelho de lixeira) para remover o pacote enviado.

A Adyen é uma marca registrada de seu respectivo proprietário. Esta extensão não é afiliada nem endossada pela Adyen.