A configuração da Adyen é feita no Admin em 4 etapas:
1ª etapa: Formas de Pagamento;
2ª etapa: Antifraude;
3ª etapa: Webhook;
4ª etapa: Grupos de Pagamento e Parcelamentos.
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 se direcionar ao conector em >> Adyen >> "Adicionar Configuração":
Cadastre um nome para a configuração e selecione o seu tipo:Cartão, PIXou Boleto:
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.
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.
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 antifraude disponíveis hoje na plataforma.
Abaixo listamos quais são e como funcionam:
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.
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.
Essa URL de callback será utilizada pela Adyen para enviar os Webhooks das transações. Os webhooks funcionam como "avisos" que a Adyen envia, como por exemplo o "aviso" de que um PIX foi pago.
Orientação no Painel da Adyen:
Para funcionamento do Webhook, a URL de callback deve ser criado e ficar online constantemente. Esse URL precisa ser cadastrada seguindo o passo a passo abaixo:
- Acesse o Painel da Adyen com seus dados de acesso;
- Vá até o Menu Desenvolvedores > Webhooks;
- Clique em "+Webhook";
- Clique em "Adicionar" na opção "Webhook comum";
- Preencha as informações abaixo:
Descrição: Eventos de transação para Wake Commerce (Sugestão);
Configuração do servidor:
- URL: https://gateway-postback.fbits.net/api/Adyen
- 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 - Grupos de Pagamento e Parcelamento
Após as primeiras configurações, você deverá clicar em Grupos e Parcelamentos >> Parcelamentos e seguir o passo a passo completo no artigo Grupos e Pagamentos.
Recomendações Gerais
- Realize um pedido teste com um cartão válido para verificar se o pagamento transacionará corretamente na Adyen;
- 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;
- Troca de forma de Pagamento: Para utilizar a troca na forma de pagamento para pedidos que estão “Aguardando Pagamento”, basta seguir nossa documentação Troca na forma de pagamento do pedido.
- 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.