A configuração da Adyen é feita no Admin em 4 etapas:
1ª etapa: Formas de Pagamento;
2ª etapa: Antifraude;
3ª etapa: Webhook;
4ª etapa: Gereciamento de Pagamento
Confira o passo a passo das configurações dentro das suas respectivas etapas:
1ª Etapa - Formas de Pagamento
No painel administrativo da plataforma acesse o menu Pagamentos >> Conectores de pagamento.
Depois selecione o conector em >> Adyen >> "Nova configuração":
Cadastre um nome para a configuração e selecione o seu tipo: Cartão, PIX, Boleto ou Wallet:
Descrições dos campos dos métodos de pagamentos disponíveis
CARTÃO
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final);
MerchantAccount: Conta da loja na Adyen que identifica a conta que aceitará os pagamento;
ApiKey: Chave privada da loja na Adyen;
PublicKey: Chave publica da loja na AdyenChave identificada como "Client Key:
Antifraude: Integração nativa com Manual/Próprio ou Clearsale;
Sandbox: Para a realização de testes no ambiente Sandbox da Adyen.
Prefix: Prefix fornecido pela Adyen
Recuperação automática de assinaturas e pedidos avulsos com cartões sugeridos: Esta funcionalidade deve ser ativada para permitir a retentativa automática de cobrança em cartões previamente salvos, abrangendo dois cenários principais:
Assinaturas: Retentativa automática do novo ciclo de assinaturas de pedidos que falharam no cartão de origem.
Pedidos Avulsos: Retentativa automática para compras únicas realizadas com "cartões sugeridos" (cartões que o cliente já possui salvos na carteira).
⚠ ️ Observação Importante: Ao habilitar a feature flag de recuperação automática, é obrigatório definir o número máximo de dias corridos para o período de retentativa.
BOLETO
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final);
MerchantAccount: Conta da loja na Adyen que identifica a conta que aceitará os pagamento;
ApiKey: Chave privada da loja na Adyen;
DiasCancelamento: Prazo de vencimento do boleto em dias;
Sandbox: Para a realização de testes no ambiente Sandbox da Adyen.
PIX
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final);
MerchantAccount: Conta da loja na Adyen que identifica a conta que aceitará os pagamento;
ApiKey: Chave privada da loja na Adyen;
HorasCancelamento: Prazo de vencimento do QRCode em horas;
Editor HTML: Campo para inserir texto de instrução, campos ou informações em formato HTML (código de marcação geralmente criada por um desenvolvedor ou pela agencia). Essas informações serão apresentadas no Checkout, na opção de Pagamento Pix.
Sandbox: Para a realização de testes no ambiente Sandbox da Adyen.
WALLET
Nome da Configuração: Identificação interna da configuração. Não será o nome apresentado ao consumidor (cliente final);
MerchantAccount: Conta da loja na Adyen que identifica a conta que aceitará os pagamento;
ApiKey: Chave privada da loja na Adyen;
PublicKey: Chave pública da loja na AdyenChave identificada como "Client Key:
WalletType: Serviço de Wallet utilizado, podendo ser Google Pay ou ApplePay
WalletKey:Chave ou identificador exclusivo que a plataforma utiliza para associar carteiras digitais a uma transação ou cliente específico
Sandbox: Para a realização de testes no ambiente Sandbox da Adyen.
Para que a Apple Pay via Adyen funcione, é necessário adicionar um certificado da Apple no repositório da loja. Recomendamos utilizar o certificado disponibilizado pela própria Adyen para facilitar a configuração.
- Acesse a documentação aqui.
- Baixe o certificado pelo link
- Extraia o arquivo apple-developer-merchantid-domain-association
- Crie uma pasta com dentro da Pasta Root com o nome .well-known e coloque o certificado dentro dela
- O caminho dentro do Storefront deve ser: /.well-known/apple-developer-merchantid-domain-association.
Após a conclusão, teste na loja acessando, pelo navegador, o caminho https://sualoja.com//.well-known/apple-developer-merchantid-domain-association se ao acessar esse caminho, ocorrer o download de um arquivo, você configurou corretamente. Caso contrario, revise o passo a passo acima.
Ajuste de Layout
A configuração PIX necessita de alguns ajustes de Layout, uma delas é a exibição do botão "Copiar Código", que está no código-fonte da página de "Fechamento" e, por padrão, vem configurado como display:none de forma nativa.
Como são ajustes mais técnicos que necessitam de profissionais especializados, sugerimos que verifique com a sua agência esse e outros ajustes de layout necessários para que a experiência de pagamentos com PIX seja completa.
E-mail Transacional
Disponibilizamos algumas tags para enviar os dados do PIX nos e-mails transacionais, confira qual tag utilizar no artigo 'Como editar os e-mails transacionais'.
Atenção: Informamos que caso a imagem do QR Code seja no formato .svg, o Gmail não exibirá pois esse formato não é suportado pelo Gmail.
Exibição do QR Code para pagamentos no 'Minha Conta'
Por padrão, a exibição do QR Code vem desabilitada. Saiba como ajustar acessando o artigo Detalhes do Minha Conta.
2ª Etapa - Antifraude
O Conector Adyen permite trabalhar com 2 antifraudes disponíveis hoje na plataforma.
Abaixo listamos quais são e como funcionam:
1.Antifraude Clearsale: Nossa plataforma tem integração direta com a Clearsale e permite que seus pedidos pagos com cartão de crédito passem pela análise de fraude. Para configurar, basta inserir o código App e a Chave da Clearsale na plataforma acessando a aba Pagamentos>> Antifraude.
Em casos de recusa pelo antifraude da Clearsale, a Wake disponibiliza uma request para garantir que o pedido seja cancelado na Adyen. Essa funcionalidade assegura que os pedidos rejeitados sejam cancelados de forma eficaz em ambas as plataformas, evitando complicações futuras e mantendo a integridade das operações financeiras.
Antifraude Manual: Funciona como um antifraude manual, permitindo que os pedidos pagos com cartão de crédito sejam processados em 2 passos (Autorização e Captura). No primeiro passo, o pagamento será apenas Autorizado junto a Adyen e, após a aprovação manual do pedido, será capturado junto a Adyen.
Com este antifraude, o pedido será atualizado para “Autorizado” na plataforma quando a Adyen retornar com a autorização. Após a análise manual, o pedido deve ser alterado via API Pública ou via Admin para o status 14 “Pedido Aprovado Análise”, para que a captura do pagamento seja realizada na Adyen.
Lembrete: Você também pode definir um valor mínimo, fazendo com que somente os pedidos acima desse valor passem pelo Two-steps (Autorização e Captura). Pedidos abaixo sejam Capturados automaticamente.
3ª Etapa - Webhook
Após as configurações da forma de pagamento e do Antifraude, é necessário cadastrar nossa URL de Callback na Adyen conforme orientado na Documentação Webhook structure and types.
Utilizamos esta URL de Callback para capturar Webhooks da Adyen em tempo real. Isso permite que a plataforma receba notificações automáticas de eventos financeiros — como a confirmação de pagamentos — sem atrasos, eliminando a necessidade de consultas manuais ao gateway.
Orientação no Painel da Adyen:
Para garantir o recebimento ininterrupto de notificações, a URL de callback deve permanecer ativa e disponível (online) em tempo integral. Siga o procedimento abaixo para realizar o cadastro no ambiente da Adyen:
Acesse o Customer Area (Painel) da Adyen;
No menu lateral, navegue até Developers > Webhooks;
Clique no botão + Webhook;
Localize a opção Standard Webhook (Webhook comum) e clique em Add;
Configure os parâmetros conforme as especificações abaixo:
Descrição: Eventos de transação para Wake Commerce (Sugestão);
Configuração do servidor:
Método: JSON
Versão da SSL: TLSv1.3
Autenticação: Não precisa informar
ID HMAC: Não precisa informar
Eventos: Todos os eventos
Segue abaixo nossa URL de Callback para atualização de status de pagamentos:
https://gateway-postback.fbits.net/api/Adyen
4ª Etapa - Gerenciamento de pagamentos
Após as configurações iniciais, você deverá clicar em Pagamentos>> Gerenciamento de Pagamentos e seguir o passo a passo completo no artigo Grupos e Pagamentos.
Recomendações Gerais
Realize pedidos de teste com um cartão válido para verificar se os pagamentos são processados corretamente na Adyen;
O conector oferece a funcionalidade de Checkout Online, permitindo que, em casos de recusa de cartão por motivos como dados incorretos, o cliente permaneça na mesma página do carrinho para inserir e tentar novamente com novos dados do cartão.
Faça um pedido teste com Boleto Adyen, para verificar se o boleto será gerado corretamente, caso vá utilizar esta forma de pagamento;
Faça um pedido teste com PIX Adyen, para verificar se o QR Code será gerado corretamente, caso vá utilizar esta forma de pagamento;
Para utilizar o ambiente de teste da Adyen, ative a chave “Sandbox” dentro das configurações.
Transações internacionais: A integração com a Adyen permite transacionar com as moedas EUR, USD, MXN e BRL. Para isso, basta consultar nosso time de Onboarding para saber mais sobre o processo de definição de moeda da sua loja.
Cartões salvos: Para utilizar a funcionalidade de Cartões Salvos ou Cartões Sugeridos, basta solicitar à sua agência que siga a documentação Como configurar Cartões Sugeridos no Checkout;
Cancelamento/Estorno de Pagamentos: A opção de Cancelamento do pedido está disponível em nossa API Pública, assim como a opção de Estorno total ou parcial, que é permitido para Cartão de Crédito e Pix.
Os estornos são recebidos pela Adyen e processados numa fila, por este motivo não temos retornos em tempo real. Temos o comentário privado dentro do pedido no Admin que informa que o Estorno foi enviado para a Adyen e, posteriormente, temos um novo comentário privado informando se o estorno foi feito com sucesso ou falha.
Atenção: Cancelar os pedidos manualmente na plataforma não estorna os pagamentos na Adyen. Ou seja, você deverá solicitar o estorno via API Pública e cancelar os pedidos também no painel da Adyen para que os pagamentos sejam realmente cancelados, nessas situações.
Comentários
0 comentário
Por favor, entre para comentar.