Ajuda
Fazer login

Uso do Adyen na Shopify

A Adyen é um gateway de pagamento que permite o processamento de pagamentos em grandes empresas. Lojistas com uma conta existente da Adyen podem usá-la como processador de pagamentos diretamente na Shopify.

É possível integrar a Shopify, incluindo os dados de pagamento do Adyen, com o software de planejamento de recursos empresariais (ERP) para garantir um gerenciamento de dados e sincronização mais fluidos entre os sistemas.

Nesta página

Requisitos de qualificação para o Adyen na Shopify

Antes de usar o Adyen na Shopify, é preciso atender aos seguintes requisitos:

  • É necessário ter um plano Enterprise.
  • A empresa deve atender a critérios de qualificação específicos de acordo com a região.
  • É necessário ter uma conta do Adyen configurada antes de ativar a integração.
  • A loja precisa usar o Shopify Checkout.

O acesso ao Adyen é apenas mediante aprovação e não pode ser garantido. Para solicitar a ativação do Adyen, entre em contato com seu representante de vendas da Shopify ou com o Customer Success Manager (CSM). Caso você não tenha um Customer Success Manager, entre em contato com o Atendimento ao cliente da Shopify para receber orientações sobre as próximas etapas.

Recursos incompatíveis ou indisponíveis para o Adyen na Shopify

Alguns recursos não estão disponíveis ou são incompatíveis com a integração do Adyen na Shopify:

  • A Klarna e o PayPal não estão disponíveis: não é possível usar a Klarna e o PayPal como formas de pagamento por meio da integração do Adyen na Shopify.
  • Nem todas as formas de pagamento locais estão disponíveis: as formas de pagamento locais (LPMs) oferecidas por meio da integração do Adyen na Shopify variam de acordo com a região e podem não incluir todos os métodos oferecidos diretamente pelo Adyen. Consulte a documentação de formas de pagamento do Adyen para ver a lista completa.
  • As ferramentas contra fraude da Shopify não estão disponíveis: ao usar o Adyen, você não tem acesso às ferramentas contra fraude do Shopify Payments, como gestão de contestações, proteção contra teste de cartão e análise contra fraude. O Adyen oferece as próprias ferramentas de prevenção contra fraudes, que podem estar disponíveis por uma taxa adicional. Ainda é possível usar a análise contra fraude da Shopify e o Shopify Flow para criar regras personalizadas.
  • O Managed Markets não é compatível: o Managed Markets (serviço de empresa responsável por processar pagamentos) exige o Shopify Payments e não pode ser usado com o Adyen.
  • As formas de pagamento manuais não aceitam várias moedas: a funcionalidade de várias moedas só funciona para cartões de crédito. As formas de pagamento manuais, como transferência bancária ou pagamento em dinheiro na entrega, usam a moeda da loja por padrão.

Ativar o Adyen na Shopify

Antes de ativar o Adyen, trabalhe com seu representante de vendas da Shopify ou com o Customer Success Manager para receber a aprovação. Depois que a receber, configure uma conta no Adyen, instale e ative o app de pagamento.

Etapas:

  1. No admin da Shopify, acesse Configurações > Pagamentos.

  2. Na seção Shopify Payments, clique em Gerenciar.

  3. Clique em Mudar para um provedor de terceiros e, depois, clique novamente em Mudar para um provedor de terceiros para confirmar.

  4. Escolha Adyen Payments - Credit Cards na lista de provedores de pagamento disponíveis. Se você não tiver aprovação para usar o Adyen, a opção Adyen Payments - Credit Cards não será exibida na lista.

  5. Clique em Gerenciar conta.

  6. Se necessário, permita que a extensão de pagamento do Adyen acesse e modifique os dados da sua loja.

  7. Na página Configuração de pagamento do Adyen, selecione a conta do Adyen que você quer usar com sua loja da Shopify.

  8. Siga as instruções na Área do cliente do Adyen para instalar o app de pagamentos do Adyen para a Shopify e testar a integração.

Definir configurações do Adyen

Depois de ativar o Adyen, é possível ajustar as configurações para atender às necessidades da empresa.

Configurar a captura de pagamento

A captura de pagamento determina quando os fundos são cobrados dos clientes.

Etapas:

  1. No admin da Shopify, acesse Configurações > Pagamentos.

  2. Na seção do provedor de pagamento, clique em Gerenciar.

  3. Escolha o método de captura preferido:

    • Captura automática: os pagamentos são capturados imediatamente quando o pedido é feito.
    • Captura manual: os pagamentos são autorizados, mas não capturados até que você faça isso manualmente.
    • Captura no processamento: os pagamentos são capturados quando você processa o pedido.

Instalar formas de pagamento locais

Para oferecer formas de pagamento locais pelo Adyen, é necessário ter o app Adyen Payments - Credit Cards instalado como gateway principal. Se você não tiver o app de cartão de crédito instalado, não será possível instalar formas de pagamento locais.

Depois de instalar o app de cartão de crédito, entre em contato com o Customer Success Manager ou com o representante de vendas da Shopify para obter acesso às formas de pagamento locais de sua região.

Configurar o parcelamento no cartão de crédito para o Brasil e o México

Se você vende para clientes no Brasil ou no México, pode oferecer parcelamento no cartão de crédito no checkout.

Antes de configurar o parcelamento, verifique se os seguintes requisitos foram atendidos:

  • Para o Brasil, o mercado precisa usar a moeda BRL (Real brasileiro).
  • Para o México, o mercado precisa usar a moeda MXN (Peso mexicano).
  • O app Adyen Payments - Credit Cards precisa estar instalado como o gateway principal.

Etapas:

  1. No admin da Shopify, acesse Configurações > Pagamentos.

  2. Na seção Adyen Payments - Credit Cards, clique em Gerenciar.

  3. Clique em Mais ações e depois em Gerenciar.

  4. Na barra de endereços do navegador, adicione ?credit_card_installments=1 ao final do URL e pressione Enter no teclado.

  5. As opções de configuração de parcelamento são exibidas na parte inferior da página.

  6. Configure o número máximo de parcelas e o pagamento mínimo por parcela. Para o Brasil, é possível configurar de 2 a 12 parcelas. Para o México, é possível configurar 3, 6, 9, 12 ou 18 parcelas.

  7. Clique em Salvar.

Usar o Adyen com o Shopify Markets

O Adyen é compatível com o Shopify Markets. Quando o Shopify Markets é ativado, as transações são processadas na moeda que a Shopify envia ao Adyen.

Para vender em várias moedas com o Adyen, confirme se os seguintes requisitos foram atendidos:

  • As moedas dos mercados também precisam estar configuradas na conta do Adyen.
  • Se a moeda for uma das moedas de liquidação do Adyen para a região, o Adyen liquidará os fundos nessa mesma moeda.

Validar a integração com pedidos de teste

Antes de começar a aceitar pagamentos reais, teste a integração do Adyen com pedidos em rascunho para confirmar se os pagamentos são processados corretamente.

Etapas:

  1. No admin da Shopify, acesse Pedidos > Rascunhos.

  2. Clique em Criar pedido.

  3. Adicione um produto e as informações do cliente.

  4. Clique em Receber pagamento e selecione a forma de pagamento de sua preferência.

  5. Conclua o processo de pagamento e verifique se o pedido é exibido corretamente na Shopify e no portal do Adyen.

Conciliar pedidos ao usar o Adyen

Quando um pedido é pago com o Adyen, a Shopify envia um número de merchantReference ao Adyen referente à transação. Esse número é um identificador exclusivo que pode ser usado para conciliar pedidos.

O número merchantReference é composto por duas partes:

  • ID da loja na Shopify: a primeira parte do número identifica a loja na Shopify.
  • ID do pagamento: a segunda parte é o ID do pagamento da transação específica.

Por exemplo, o número merchantReference pode ser exibido como 12345-67890. Neste exemplo, 12345 é o ID da loja na Shopify e 67890 é o ID do pagamento.

O ID do pagamento de uma transação é exibido no cronograma do pedido no admin da Shopify.

Para conciliar transações, pesquise no admin da Shopify usando a parte correspondente ao ID do pagamento do número merchantReference. A função de pesquisa retorna o pedido associado a esse ID.

Considerações sobre a conciliação de pedidos

Ao usar o cronograma do pedido e o ID do pagamento para conciliar pedidos com transações no Adyen, avalie as seguintes considerações:

  • Encontrar a chave de autorização de um pedido: a chave de autorização não é atualizada no cronograma do pedido no admin da Shopify quando uma transação é concluída com o Adyen. Para recuperar a chave de autorização de um pedido, consulte a conta do Adyen.
  • Status de pagamento pendente: os pagamentos podem levar vários dias para serem processados. Caso não se receba uma resposta do provedor de pagamento, eles poderão ser exibidos como Pendente. Quando o status mudar para Pago, você poderá processar o pedido.
  • Status de pagamento expirado: se o status do pagamento mudar para Expirado, confirme se o valor não foi recebido na conta do Adyen antes de solicitá-lo novamente ao cliente. O status muda para Expirado para indicar que não foi possível processar o pagamento.

Solucionar problemas comuns do Adyen

Em caso de problemas com a integração do Adyen, consulte os seguintes problemas e soluções comuns.

Esse é o comportamento esperado para formas de pagamento locais, como AliPay e WeChat Pay. O pagamento entra em estado pendente até ser concluído pelo processador. Após a confirmação, o status é atualizado no Adyen e na Shopify.

O que fazer: aguarde o processamento do pagamento. A maioria deles é atualizada em poucos minutos, mas alguns podem levar de 10 a 15 minutos.

Isso pode acontecer se um cliente iniciar um pagamento que exija verificação do 3D Secure, mas abandonar o processo ou tiver problemas fora do controle da Shopify.

O que fazer:

  1. Verifique o portal do Adyen para confirmar se o pagamento foi capturado.
  2. Se o pagamento tiver sido capturado, crie um rascunho de pedido na Shopify.
  3. Marque o rascunho de pedido como pago e processe-o adequadamente.
  4. Se o pagamento não tiver sido capturado, nenhuma ação será necessária.

Isso pode ocorrer quando um cliente conclui a verificação do 3D Secure, mas não é redirecionado de volta à Shopify corretamente. É possível que ele veja duas tentativas de autorização no extrato.

O que fazer:

  1. Verifique o portal do Adyen para determinar quantos pagamentos foram de fato capturados.
  2. Se apenas um pagamento tiver sido capturado, avise o cliente que a segunda cobrança é uma autorização pendente que será liberada automaticamente pelo banco.
  3. Se dois pagamentos tiverem sido capturados, reembolse a transação duplicada no portal do Adyen.

Se o Adyen demorar mais que o esperado para processar uma recusa de pagamento, o pagamento poderá mudar para o status pendente, e o pedido será criado na Shopify.

O que fazer:

  1. Verifique o status do pagamento no admin da Shopify e no portal do Adyen.
  2. Se houver falha no pagamento, você poderá cancelar o pedido ou solicitá-lo novamente ao cliente.

Isso pode ocorrer quando a sessão de uma forma de pagamento local expira, mas o cliente ainda foi autorizado no Adyen.

O que fazer:

  1. Aguarde de 10 a 15 minutos para que o status do pagamento seja sincronizado entre o Adyen e a Shopify.
  2. Se o pagamento for exibido como concluído no Adyen, mas o pedido não for criado na Shopify após 15 minutos, crie um rascunho de pedido e marque-o manualmente como pago.

Em geral, esse erro indica que a loja não atende aos requisitos de qualificação para usar o Adyen.

O que fazer:

  1. Verifique se a loja está em um plano Enterprise.
  2. Entre em contato com o Customer Success Manager (CSM) ou representante de vendas da Shopify para falar sobre a qualificação e a ativação.
  3. Se você não tiver um Customer Success Manager, entre em contato com o Suporte da Shopify para receber orientação sobre os próximos passos.

Se as formas de pagamento locais não estiverem aparecendo para os clientes, confirme se os seguintes requisitos foram atendidos:

  • O app Adyen Payments - Credit Cards precisa estar instalado como o gateway principal. Não é possível usar formas de pagamento locais sem ele.
  • O endereço de entrega do cliente precisa ser de uma região em que a forma de pagamento local esteja disponível.
  • A moeda do checkout precisa ser compatível com a forma de pagamento local.

O que fazer:

  1. Confirme se o app Adyen Payments - Credit Cards está instalado e ativo.
  2. Verifique se as formas de pagamento locais estão configuradas corretamente na conta da Adyen.
  3. Teste o checkout com o endereço de um cliente na região de destino.

Se as parcelas no cartão de crédito não aparecerem para os clientes no Brasil ou no México, verifique se os seguintes requisitos foram atendidos:

  • No Brasil, o mercado precisa usar a moeda BRL (Real brasileiro).
  • No México, o mercado precisa usar a moeda MXN (Peso mexicano).
  • O app Adyen Payments - Credit Cards precisa estar instalado como o gateway principal.
  • As parcelas precisam ser ativadas usando o parâmetro da URL.
  • Não estão em uso crédito na loja nem apps de pagamento com cartão-presente de terceiros (não são compatíveis com parcelas).

Perguntas frequentes

Não. Para processar formas de pagamento locais com a Adyen, o app Adyen Payments - Credit Cards precisa estar instalado como gateway principal. A Adyen exige essa configuração e monitora o uso para evitar uma integração parcial.

Não. A referência do Payment Service Provider (PSP) da Adyen não fica armazenada na Shopify. Entretanto, a referência da transação da Shopify é armazenada como parte do campo merchantReference no portal da Adyen, que pode ser usada para a conciliação.

Sim, o app de pagamento da Adyen é compatível com assinaturas usando os apps correspondentes integrados ao checkout da Shopify. Se for necessário migrar as assinaturas para a Adyen, entre em contato com o Customer Success Manager (CSM) ou representante de vendas da Shopify para ver as opções de migração.

Sim, o Apple Pay (para iOS) e o Google Pay (para Android) estão disponíveis pela integração com a Adyen.

Sim, o app da Adyen é compatível com upsells pós-compra por meio da extensão de checkout pós-compra. Consulte a documentação do desenvolvedor da Shopify para ver as limitações e considerações das extensões de checkout pós-compra.

O gateway legado da Adyen não tem mais suporte e pode causar problemas de pagamento. Se você ainda usar esse recurso, faça a migração para o novo app de pagamento da Adyen imediatamente.

Para migrar, entre em contato com o Atendimento ao cliente da Shopify ou com o Customer Success Manager e solicite orientação sobre o processo de migração.

Antes de entrar em contato com o Atendimento ao cliente da Shopify a respeito da Adyen

Antes de entrar em contato com o Atendimento ao cliente da Shopify a respeito de um problema com a Adyen, reúna as seguintes informações para agilizar a resolução do caso:

  • O número ou os números de pedido afetados pelo problema
  • A data e a hora do problema
  • Capturas de tela das mensagens de erro recebidas
  • O status do pagamento exibido no admin da Shopify e no portal da Adyen
  • O número da merchantReference da Adyen, se aplicável
  • Uma descrição do que deveria acontecer versus o que realmente aconteceu
  • Etapas já realizadas com base na seção de solução de problemas

Atendimento e recursos do Adyen

Saber com qual equipe entrar em contato para receber atendimento pode melhorar a experiência e ajudar a conseguir respostas mais rapidamente ao usar a Adyen na Shopify.

Responsabilidades do Atendimento ao cliente da Shopify

Para receber assistência com a integração da Adyen na Shopify, como ajuda com a configuração e com a solução de problemas comuns, o Atendimento ao cliente da Shopify é o seu principal contato e pode ajudar com os seguintes tipos de problema:

  • Solicitação de acesso e ativação do gateway de pagamento do Adyen na Shopify
  • Problemas técnicos relacionados ao gateway de pagamento da Adyen na Shopify
  • Solução de problemas de integração
  • Orientação sobre como definir e gerenciar as configurações da Adyen na Shopify

Responsabilidades do Atendimento do Adyen

Para problemas específicos da sua conta da Adyen, entre em contato diretamente com o Atendimento ao cliente da Adyen pelo e-mail support@adyen.com. Essa equipe lida com os seguintes tipos de consulta:

  • Verificação da conta e adesão de lojistas
  • Conformidade com regulamentações
  • Preços e taxas de processamento
  • Programações de pagamento, pagamentos com falha e outras dúvidas relacionadas
  • Estratégias e ferramentas de prevenção contra fraudes
  • Gerenciamento de estornos e contestações
  • Necessidades detalhadas de relatórios e conciliação

Recursos

Para saber mais sobre a Adyen e sua integração com a Shopify, consulte os seguintes recursos: