Point-of-sale icon

Checklist de ativação - integração com a API de terminais

Siga esta checklist para colocar a integração da API de Terminais ao vivo.

Suporte

Artigos, FAQs e solicitação de suporte: Adyen Help

Uma integração com a API de Terminais da Adyen permite que você inicie os pagamentos de seu sistema de caixa registradora e processe esses pagamentos através da Adyen usando nossos terminais.

Aqui, descrevemos como você pode colocar sua integração com a API de terminais ao vivo.

Antes de você começar

Etapa 1: configure sua conta ativa da Adyen

A estrutura da sua conta de teste não é copiada. Isso significa que você precisa configurar uma estrutura para sua conta ativa usando sua live Customer Area.

  1. Solicite as merchant accounts de que precisa, fornecendo o máximo de detalhes possíveis e garantindo o envio dos documentos e links corretos. O tempo de processamento normal é de cerca de quatro dias úteis.

  2. Se você precisar de stores em sua estrutura de conta, aguarde a confirmação de que suas merchant accounts ativas foram criadas e envie um formulário de solicitação de loja. O tempo de processamento normal é de cerca de dois dias úteis.

Etapa 2: Revise suas configurações financeiras

  1. Receba pagamentos da Adyen:

    1. Forneça informações sobre as contas bancárias nas quais deseja receber os pagamentos da Adyen. Se você aceita pagamentos em várias moedas, pode adicionar uma conta bancária separada para cada moeda.
    2. Opcionalmente, altere o cronograma de pagamento em sua Customer Area > Finance > Payout model.
      O padrão é o pagamento do dia de vendas. Com esse cronograma, pagamos os fundos diariamente (de segunda a sexta-feira), com as transações processadas em um único dia pagas em um lote.

  2. Use relatórios para reconciliação:

    1. Configure a geração automática e o download de relatórios.
    2. Use o relatório de detalhes de liquidação para reconciliar suas contas a nível de transação.
    3. Considere automatizar seu processo de reconciliação.

  3. Considere a criação de uma reserva e autofinanciamento.
    Sua reserva é usada para reembolsos e outras despesas operacionais em caso de fundos em processamento insuficientes. Para garantir que sempre haja saldo suficiente disponível em sua conta para reembolsos, você também pode configurar o financiamento automático.

Etapa 3: solicitar terminais ativos

Seus terminais de teste são apenas para fins de teste. Eles não podem processar pagamentos ativos. Isso significa que você precisa solicitar novos terminais de sua live Customer Area.

  1. Solicite os terminais necessários em suas lojas físicas.

Geralmente, leva cerca de quatro dias úteis antes da chegada dos terminais.

Etapa 4: prepare seus terminais

As configurações definidas de seu ambiente de teste não são copiadas. Isso significa que você precisa configurar seus terminais ativos e recursos de pagamento do zero em sua live Customer Area. Você pode definir as configurações no nível de company account, merchant account, store level e a nível de terminal.

  1. Habilite Terminal API para seus terminais.

  2. Adicione métodos de pagamento e configure o terminal e os recursos de pagamento que deseja usar. Nossa Support Team irá ajudá-lo com quaisquer recursos que você não consiga configurar totalmente.

  3. Atribua os terminais ativos a uma loja. Isso torna mais fácil começar a usar os terminais quando você os recebe. Você pode atribuir terminais de sua área de cliente ou usando nosso Terminal Management API.

Etapa 5: atualize sua integração

  1. Adicione credenciais de API e, opcionalmente, adicione usuários à sua live Customer Area.
    Para sua conta ativa, recomendamos a criação de uma nova credencial de API além da padrão. Por exemplo, você pode adicionar uma nova credencial de API a cada conta de comerciante, ou uma para ponto de venda e outra para comércio eletrônico.
    Você também pode criar usuários adicionais para os membros da equipe e atribuir as funções de que precisam para suas tarefas.

  2. Atualize seu código:

    • Para uma integração local, atualize sua integração para refletir os endereços IP (ou nomes de host resolvíveis) dos terminais ativos e instale e verifique nosso certificado de terminal ativo (ou use uma biblioteca). Se você ignorou a criptografia de comunicações na integração de teste, será necessário implementar a criptografia agora.

      Um terminal ativo não aceitará solicitações de API sem criptografia.

    • Para uma integração em nuvem, gere uma nova chave de API para a credencial de API que você está usando e mude para os terminais ativos e a nova chave de API.

  3. Ao receber os terminais, siga as etapas no manual do modelo do terminal para colocá-los em funcionamento. As etapas são:

    • Inspecione o terminal para verificar se ele não foi adulterado.
    • Insira o rolo de papel de recibo (se aplicável).
    • Ligue o terminal.
    • Conecte o terminal à sua rede.
    • Ative o terminal.
    • Teste a conexão com aplataforma de pagamentos da Adyen.

Etapa 6: teste sua integração

Para ter certeza de que sua integração está funcionando conforme o esperado, você deve fazer testes de ponta a ponta, desde fazer um pagamento com um cartão real até completar sua reconciliação.

Por exemplo:

  1. Faça um pagamento de baixo valor com um cartão real.

  2. Faça o login em sua live Customer Area e verifique se o pagamento foi bem-sucedido:

    1. Vá para Transactions > Payments e localize o pagamento.
    2. Clique na PSP reference do pagamento.

    3. Em History, você deverá ver a transição do JournalType para:

      • Received
      • Authorised

      • Settled

    Se o pagamento atingiu o JournalType de Settled, o pagamento foi processado com sucesso pelo emissor do cartão.

  3. Reembolsar o pagamento, para testar seu fluxo de reembolso.