Skip to main content

Como configurar PinPad ADYEN e suas modalidades de pagamento?

Objetivo

Este guia explica como integrar e configurar terminais de pagamento ADYEN (modelo Verifone P400 Plus)Plus ou outros homologados) no sistema Fokus, incluindo a criação das modalidades de pagamento.

Pré-requisitos

Antes de iniciar a configuração, certifique-se de ter:

  • API KEY da ADYEN: Chave de acesso fornecida pela própria ADYEN (não controlada pela Link Tecnologia)
  • POI ID de cada PinPad: Número de série do equipamento (encontrado na parte traseira)
  • Terminais cadastrados: Os terminais (CAIXA, ATM, SAÍDA ASSISTIDA) devem estar previamente cadastrados no sistema

Parte 1: Configuração dos Terminais

1. Acessar o Menu de Terminais

Navegue até: CONFIGURAÇÕES DA GARAGEM > TERMINAIS

terminais.jpg

2. Configurar cada Terminal com PinPad ADYEN

Para cada terminal do tipo CAIXA, ATM ou SAÍDA ASSISTIDA que terá um PinPad ADYEN:

  1. Clique no terminal para editá-lo
  2. Localize a área de configuração JSON
  3. Procure o bloco "faturamento"
  4. Adicione a configuração do ADYEN:ADYEN e o poi_id:
"faturamento": {
  "adyen": {
    "poi_id": "P400Plus-803396566"
  }
}
``` ###

3. Identificar o POI_ID do Equipamento

O **POI_ID**POI_ID é composto por: `[MODELO]-[NÚMERO_DE_SÉRIE]`

**

Como encontrar:**

1.
  1. Vire o PinPad ADYEN

    2.

    adyen-frente.jpeg


  2. Localize a etiqueta de informações técnicas na parte traseira

    3.

    adyen-tras.jpeg


  3. Identifique os campos: -
      **Model**
    • Model: Ex.: P400 Plus
      • - **
    • S/N**N (Serial Number): Ex.: 803-396-566
      • **

Formato do POI_ID:**

-
  • Remova os hífens do S/N
    • -
  • Combine: `P400Plus-803396566`803396566
    • **

⚠️ Importante:** Cada PinPad tem um S/N único e deve ser configurado no seu terminal correspondente.

---

Timeouts ##Recomendados (configuração do terminal):

Parte 2: Configuração das Modalidades de Pagamento

###

4. Acessar Modalidades de Pagamento

Navegue até: **CONFIGURAÇÕES DE FATURAMENTO > MODALIDADES DE PAGAMENTO**PAGAMENTO

###

5. Criar as Modalidades

modalidade.jpg

Você precisará criar **três modalidades**modalidades separadas: CRÉDITO, DÉBITO e PIX.

Para cada uma, clique em **+ ADICIONAR**ADICIONAR e preencha os camposcampos:

conforme

Identificação: aNome tabelada abaixo:forma | Campo | Valor | |-------|-------| | **Identificação** |ex.: ADYEN CRÉDITO / ADYEN DÉBITO / ADYEN PIX

| | **Tipo** |

Tipo: ADYEN

| | **

Permitida nos terminais** |terminais: Selecione todos os terminais que possuem PinPad ADYEN

| | **

Gerar documento fiscal** |fiscal: ATIVADO (se gerar RPS/NFC-e) ou DESATIVADO

|

URL: | **URL** | `https://terminal-api-live.adyen.com/sync`sync |(Refere-se |a **URL da api de produção)

API KEY** |KEY: Cole a chave fornecida pela ADYEN (ex.: `AQErhmfxKo7HbBFFw0m/n3Q5qf3V...`)

| | **

Receive Timeout**Timeout: | `60000`60000 (60 segundos)

| | **

Tipo de Transação** |Transação: CRÉDITO / DÉBITO / PIX (conforme a modalidade)

| | **

Caixa - Acumulador** |Acumulador: SIM

| | **

Caixa - Valor Inicial**Inicial: | `0` | ### Exemplo de Configuração - ADYEN CRÉDITO: ``` Identificação: ADYEN CRÉDITO Tipo: ADYEN Permitida nos terminais: CX01, ATM1, SAIDA 01 Gerar documento fiscal: ATIVADO URL: https://terminal-api-live.adyen.com/sync API KEY: AQErhmfxKo7HbBFFw0m/n3Q5qf3VZZ5BGZp6WXddkMupAi4Cs/bFSzLycbMB... Receive Timeout: 60000 Tipo de Transação: CRÉDITO Caixa Acumulador: SIM Caixa Valor Inicial: 0



Repita o processo para DÉBITOtodas eas PIXoutras modalidades, alterando apenas:

apenas
    a
  • Identificação
  • e o Tipo de Transação
.

URLs da ADYEN (Ambientes)

Ambiente URL
Produção https://terminal-api-live.adyen.com/sync
Teste https://terminal-api-test.adyen.com/sync

Atenção: Use sempre a URL de produção para operações reais.

Testando a Configuração

Após concluir todas as configurações:

  1. Verifique o status do PinPad na plataforma ADYEN
  2. Acesse o terminal configurado (CAIXA ou ATM)
  3. Inicie um faturamento de teste

    fatura.jpg

  4. Selecione a modalidade ADYEN criada
  5. O PinPad deve solicitarsolicitará ao formacartão, ou em caso de pagamentoPIX, aparecerá o QR CODE

     (crédito,

    pag1.jpeg

    débito ou PIX)
  6. Execute uma transação de teste

pag2.jpegpag3.jpeg

Se aparecer "PAGAMENTO EM ANDAMENTO... AGUARDANDO" na tela do sistema, significa que a comunicação está funcionando.

 

Solução de Problemas

O PinPad não responde

  • Verifique se o equipamento está ligado e conectado à rede
  • Confirme se o POI_ID foi digitado corretamente (sem espaços extras)
  • Teste a conectividade de rede do terminal

Erro de autenticação

  • Confirme se a API KEY está correta e completa
  • Verifique se não há espaços antes/depois da chave
  • Entre em contato com a ADYEN para validar a chave

Timeout na transação

  • Aumente o valor de "Receive Timeout" para 90000 (90 segundos)
  • Verifique a estabilidade da conexão de internet
  • Confirme se o PinPad está ativo no portal ADYEN

Modalidade não aparece no faturamento

  • Confirme se o terminal está vinculado em "Permitida nos terminais"
  • Verifique se o terminal está ativo no cadastro
  • Reinicie a sessão do operador no sistema

Checklist de Configuração

  • API KEY da ADYEN em mãos
  • POI_ID de cada PinPad identificado
  • JSON dos terminais configurado com poi_id
  • Modalidade CRÉDITO criada
  • Modalidade DÉBITO criada
  • Modalidade PIX criada
  • Teste realizado com sucesso
  • PinPads ativos na plataforma ADYEN

Suporte

Para questões sobre:

  • Configuração no Fokus: Entre em contato com o suporte Link Tecnologia
  • API KEY e credenciais: Entre em contato diretamente com a ADYEN
  • Status do equipamento: Acesse o portal de gerenciamento ADYEN

Última atualização: Outubro de 2025
Versão do Sistema: Fokus v2025.10.15

Back to top