Iniciando sua integração no terminal

Crie uma conta de teste na Adyen

A primeira coisa que você precisa fazer é obter uma conta de teste da Adyen.

1. Inscreva-se para uma conta de teste.
   Enviaremos um link para criar credenciais de login de administrador para sua área de cliente de teste. Na área do cliente, você pode gerenciar sua conta, solicitar terminais de pagamento, visualizar transações e adicionar usuários.

   Ao se inscrever, use detalhes reais. Entradas com "teste" ou endereços de e-mail contendo @ gmail.com ou @ hotmail.com podem ser descartadas automaticamente.

2. Determine e configure a estrutura da sua conta.
   Em sua company account, você verá uma merchant account que criamos para você. Agora você precisa criar a estrutura de uma ou mais merchant accounts que representem lojas ou tenham lojas por baixo. Você pode adicionar mais merchant accounts ou lojas mais tarde, mas a estrutura básica deve refletir a estrutura que você planeja ter ao entrar no ar.

3. Adicione usuários (você também pode fazer isso posteriormente).

   Quando criamos sua conta de teste, criamos um usuário da Área do cliente para você (o usuário Admin) e um usuário padrão do serviço da Web : ws@Company.[YourCompanyAccount]. Você não pode fazer login com seu usuário de serviço da web; nosso sistema o utiliza para fluxos que exigem autenticação, como processamento de pagamentos e pedidos de terminais de pagamento.

   • Opcionalmente, crie usuários adicionais da Área do Cliente para os membros da sua equipe.

   • Crie usuários adicionais de serviços na web. Ao entrar no ar, você precisará criar usuários de serviços da web. Por exemplo, um para cada merchant account, ou um para o terminal e um para ecommerce. É uma boa prática (embora não seja necessária) fazer o mesmo em sua conta de teste.

Escopo da sua integração no ponto de venda

O próximo passo é determinar o escopo de sua integração.

1. Escolha sua arquitetura de integração:

   • Com as as comunicações locais, sua caixa registradora se comunica diretamente com o terminal em sua rede local.

   • Com as comunicações na nuvem sua caixa registradora se comunica com o terminal de pagamento através da plataforma de pagamentos Adyen.

2. Determine os recursos de pagamento você deseja oferecer suporte.

3. Determine suas necessidades de criptografia.
   Por padrão, protegemos as mensagens de pagamento com nossa solução de criptografia de ponta a ponta (E2EE), mas também oferecemos criptografia ponto a ponto (P2PE). Ambos são igualmente seguros. Se você precisar de P2PE, informe-nos, pois precisamos fornecer software diferente nos seus terminais de pagamento.

Escolha seus terminais

Agora, vamos nos concentrar nos dispositivos para processar pagamentos. Esses dispositivos são chamados de pin entry devices (PED) ou points of interaction (POI), mas os chamamos de terminais.

1. Selecione os modelos de terminais adequados ao seu negócio.

2. Faça o pedido dos terminais de teste na área do cliente de teste.

3. Ative seus terminais para associá-los a uma loja e prepará-los para aceitar pagamentos.

Configurar recursos

Configure os recursos que seus terminais devem suportar.

1. Ative a API de terminais em sua company account na área do cliente.

2. Adicione métodos de pagamento. Seus terminais de pagamento aceitam cartões de crédito globais e Maestro imediatamente. Se você também quiser aceitar cartões de crédito ou débito, carteiras ou cartões vale presente, precisará adicionar esses métodos de pagamento à sua conta.

3. Configure os recursos de pagamento que estão no escopo que você decidiu.

Construa sua integração

Agora você pode começar a construir sua integração e testar se tudo funciona.

1. Dependendo da arquitetura de integração que você escolheu:

   • Crie uma integração loca.
   • Crie uma integração em nuvem. Para uma integração na nuvem, também gere uma chave de API para autenticar suas solicitações de API.

   Isso envolve a configuração da sua rede, a instalação opcional de uma biblioteca de API e a criação de um fluxo para o recebimento de resultados de pagamento

   Enquanto isso, certifique-se de implementar nossas recomendações de rede e práticas recomendadas.

2. Teste sua integração.

   • Faça pagamentos:

     • Teste o fluxo feliz fazendo pagamentos com seus terminais e cartões de teste.
     • Teste fluxos não felizes como tempos limite e problemas de conexão.
     • Simule várias respostas do adquirente para testar sua manipulação de transações recusadas.

     • Teste diferentes tipos de cartões e métodos de verificação dde títular do cartão (CVM) .

   • Cancele os pagamentos, tanto da caixa registradora como do terminal.
   • Reembolso de pagamentos, com e sem referência a uma transação original.

   • Teste os métodos e recursos de pagamento que você adicionou à sua integração.

3. Aprenda como lidar com erros da API de terminais e solucionar problemas dos seus terminais.

4. Verifique se a sua reconciliação está funcionando.
   • Faça o download do relatório de detalhes da liquidação automaticamente.
   • Saiba como automatizar sua reconciliação de pagamento.
   • Se você estiver usando Store IDs ou conversão de moeda (DCC), peça à nossa POS Support Team para adicionar esses campos aos seus relatórios.

Ao vivo

Depois de testar sua integração para todos os recursos que você planeja usar, você pode colocar sua integração em operação.

1. Inscreva-se para uma conta ativa .
   Esse processo leva algum tempo, portanto, você pode fazer isso em paralelo com uma das fases descritas acima.
2. Quando você receber credenciais de login para sua conta ativa, configure sua estrutura de conta.
3. Configure sua conta ativa com os métodos e recursos de pagamento que você deseja usar.
4. Adicione usuários de serviços da Web e usuários da Área do Cliente. Observe que não criamos um usuário padrão de serviço da web para sua conta ativa.
5. Peça terminais para pagamentos ativos e configure-os.
6. Adicione uma conta de pagamento a cada uma de suas merchant accounts ativas.
7. Atualize seu código:
   • Para uma integração em nuvem, gere uma nova chave de API e alterne para os terminais ativos e a nova chave de API.
   • Para uma integração local, proteja a comunicação com o certificado do terminal LIVE (ou use uma biblioteca).
8. Faça testes de ponta a ponta, desde efetuar um pagamento com cartão real até concluir sua reconciliação.