Início rápido

Verifique os pré-requisitos

Verifique esses requisitos antes de instalar o aplicativo. O dispositivo executa Mini mPOS; o terminal de pagamento aceita o cartão. Eles podem ser o mesmo dispositivo.

Escolha uma configuração de dispositivo

Em um terminal Adyen

A verificação completa em um dispositivo. Use um terminal de pagamento Adyen Android com Android 9 ou posterior. Confira os modelos atuais no Guia do terminal Adyen Android.

Tablet ou telefone com terminal de rede

Recomendado para um contador. Um tablet ou telefone Android 9+ na mesma rede local que um terminal Adyen. Mini mPOS não está instalado nesse terminal.

Tablet ou telefone com terminal em nuvem

Para um dispositivo e terminal em redes diferentes. Ambos precisam de acesso à internet; os pagamentos chegam ao terminal através da Adyen.

Tap to Pay em um telefone

Nenhum terminal separado. Use um telefone com comunicação de proximidade (NFC) e o aplicativo Adyen Payments, ativado pelo Suporte Adyen. Verifique o Requisitos do telefone Adyen e Países e métodos de pagamento suportados pela Adyen.

Os recursos dependem do terminal, da forma de pagamento e da configuração da Adyen. Teste os fluxos necessários. Verifique as capacidades da Adyen.

• A impressão necessita de um terminal com impressora integrada. Se não houver nenhum, você pode enviar por e-mail ou compartilhar recibos.
• A leitura de códigos de barras, códigos de reembolso QR ou códigos de configuração precisa de uma câmera.

Preparar a rede

Peça ao administrador de rede do site para permitir o seguinte:

Internet

Saída HTTPS em TCP 443 do dispositivo e terminal para *.adyen.com e *.adyenpayments.com. Permitir estes por nome de domínio, não endereço IP, porque os endereços IP da Adyen mudam.

Líquido local (para terminais de rede)

O tablet ou telefone deve alcançar o endereço IP do terminal em TCP 8443. Conecte ambos à mesma rede, e certifique-se de que o isolamento do cliente Wi-Fi (comum em redes convidadas) não os separe.

Recibos de e-mail (opcional)

Acesso de saída para seu servidor SMTP, geralmente TCP 587 (STARTTLS) ou 465 (SSL/TLS).

Dê a cada terminal de rede um endereço IP fixo com uma reserva DHCP em seu roteador. Os dados móveis funcionam para tablet ou telefone em configurações de nuvem e Tap to Pay, mas não com um terminal de rede. Para os próprios requisitos do terminal, consulte o Guia de configuração de rede Adyen.

Preparar credenciais da Adyen

Para validar com a Adyen, você precisa de uma conta de comerciante de teste ativa com pagamentos presenciais habilitados e acesso Customer Area. Comece com credenciais TEST e um terminal TEST ou Adyen Payments Test. Para LIVE, use a conta real, credenciais e terminal ou aplicativo Adyen Payments correspondentes.

Para criar ou editar credenciais, seu usuário Customer Area precisa Manage API credentials ou Merchant admin. Estas são permissões de usuário, não funções para a chave API.

Habilite os métodos de pagamento POS que você pretende aceitar; siga o Guia de configuração do método de pagamento Adyen. Mini mPOS usa os métodos configurados do terminal.

1. No Customer Area, vá para Developers › API credentials. Crie uma credencial para Mini mPOS e gere sua chave API; veja o Guia de credenciais Adyen API.
2. Para a chave API principal, habilite estas funções adicionais:
   • Management API - Terminal actions read
   • Management API - Terminal settings read and write
   • Management API - Terminal settings Advanced read and write
   • Cloud Device API role
   • API tokenise payment details
   As mesmas funções são necessárias para cada configuração. A credencial deve pertencer à conta da sua empresa e ter acesso à conta do comerciante do destino. Veja o Guia de função Adyen API .
3. Para LIVE, observe o Prefixo de URL LIVE de Developers › API URLs.
4. Para Tap to Pay, Mini mPOS cria automaticamente uma credencial separada com escopo de comerciante com o Adyen Payments App role e uma chave de cliente. O suporte da Adyen deve habilitar Tap to Pay e tornar esta função atribuível a partir da credencial da sua empresa.
5. Se desejar configurar o dispositivo manualmente:
   • Observe o Conta de comerciante.
   • Para um terminal Adyen, terminal de rede ou Tap to Pay, encontre o Chave compartilhada (identificador, senha e versão) em Devices › Device settings › Integrations › Terminal API › Encryption key. Os terminais em nuvem não o utilizam.

Voltar ao conteúdo

Instale o aplicativo

Baixe o APK assinado minimpos-<version>.apk na versão mais recente.

Terminal Adyen

1. No Customer Area, carregue o APK e implante-o em seus terminais; veja o Guia de implantação do aplicativo Adyen. Seu usuário precisa de permissão para fazer upload e implantar aplicativos.
2. Abra Mini mPOS no terminal, selecione Conectar-se à Adyen e toque em Continuar.

Tablet ou telefone

1. Abra o APK no dispositivo e permita a instalação a partir do seu navegador ou gerenciador de arquivos quando o Android solicitar.
2. Abra Mini mPOS, selecione Conectar-se à Adyen e toque em Continuar.

Voltar ao conteúdo

Conectar-se à Adyen

Conectar pares Mini mPOS com seu terminal ou aplicativo Adyen Payments e verificar sua chave API da Adyen. Siga apenas a parte da sua configuração. Cada um tem duas opções: o auxiliar de configuração (recomendado), ou entrada manual em Configurações › Terminal.

Digitalizar códigos de configuração de um computador

1. Em um computador confiável, abra o assistente de configuração. Os códigos são gerados localmente; veja a nota sobre hospedagem e privacidade.
2. Escolha onde o Mini mPOS é executado e o ambiente, TEST ou LIVE.
3. Escolher Automático (recomendado) para inserir apenas a chave Adyen API; o dispositivo procura o resto. Escolha Manual para inserir todos os detalhes da conexão.
4. Insira os detalhes solicitados.
5. Clique Fazer códigos QR. Mantenha a página aberta: ela mostra o código de transferência de 12 caracteres.
6. No Mini mPOS, abra Configurações › Terminal e toque em Digitalizar códigos de configuração ou o ícone QR no canto superior direito. Leia as orientações, toque em Já tenho códigos e escaneie cada código.
7. Verifique o destino e o ambiente, insira o código de transferência e toque em Verificar e importar.
8. Se solicitado, escolha seu terminal. Para Tap to Pay, conclua o registro quando o aplicativo Adyen Payments for aberto. Nada é salvo até que todas as verificações sejam aprovadas.

Criar uma chave de criptografia ausente

Se um terminal físico ainda não tiver chave de criptografia, a configuração oferece Criar chave de criptografia após a aprovação das verificações de credenciais e contas.

1. Verifique o ID do terminal e o ambiente mostrado e depois confirme. Não altere as configurações deste terminal em outro lugar enquanto a chave é criada.
2. Caso a conexão ainda não tenha sido verificada, atualizar a configuração do terminal; veja recuperação de configuração de chave.
3. Se a criação for interrompida, toque em Retomar configuração da chave. Para configuração QR, leia os mesmos códigos novamente com seu código de transferência.

Voltar ao conteúdo

Valide sua configuração TEST

1. Em Configurações › Terminal, verifique se o ambiente está TEST. Conclua a final Testar conexão etapa para verificar o acesso API e verificações de conexão suportadas.
   • Terminal físico: execução Testar conexão e verifique se passa.
   • Tap to Pay: confirme se o telefone está registrado em Adyen Payments Test. A verificação da conexão valida apenas a configuração: não há diagnóstico do terminal. Use o pagamento de teste abaixo para verificar o comportamento do pagamento.
2. Em Configurações › Pagamentos, verifique a moeda. Em Configurações › Imposto, verificar as taxas e se os preços incluem impostos.
3. Na página inicial, toque em Nova venda, adicione um Item personalizado e toque em Cobrar.
4. Toque Pagar e siga o Guia de teste Adyen POS para um pagamento bem sucedido.
5. Verifique se o resultado está aprovado e se o recibo possui valor, moeda e imposto corretos. Abra a venda em Histórico. Combine com seu Referência PSP ao pagamento no TEST Customer Area.
6. Reembolsar o pagamento e verifique o resultado final do reembolso no TEST Customer Area. Reembolso solicitado não é uma confirmação final.
7. Repetir a venda com um cenário de pagamento recusado do Guia de teste Adyen POS. Verifique se Mini mPOS mostra uma recusa, não uma aprovação; veja pagamentos recusados.

Em seguida, configure produtos, recibos e acesso de pessoal em Usando Mini mPOS.

Voltar ao conteúdo

Ativar pagamentos LIVE

Antes de usar recursos de terminal opcionais, revise Capacidades da Adyen e teste seu destino real: gorjetas no terminal, pagamentos parciais, avisos do comprador, doações e digitação manual do cartão, processamento off-line e reconciliação terminal. A disponibilidade depende da configuração da Adyen e do destino do pagamento.

1. Em TEST, experimente apenas os fluxos de trabalho opcionais que você planeja usar: depósitos, gorjetas de recebimento, links de pagamento ou carteiras digitalizadas . Depósitos e gorjetas de recebimento retêm fundos até a captura. Verifique os resultados finais da captura na Customer Area.
2. Teste os métodos de entrega de recibos que você planeja usar: imprimir em uma impressora real, enviar um e-mail de teste ou compartilhar um recibo.
3. Definir um Administrador PIN e, se necessário, um Gerente PIN; veja acesso de pessoal.
4. Mude para o terminal LIVE ou para o aplicativo LIVE Pagamentos, com credenciais LIVE. Para um terminal de rede/nuvem ou Tap to Pay, escolha LIVE sob Ambiente. Digite o Prefixo de URL LIVE; veja o Guia de endpoints ativos da Adyen . Tap to Pay precisa de registro novamente no ambiente selecionado.
5. Em Configurações › Terminal, verifique se o ambiente está LIVE. Conclua a final Testar conexão etapa para verificar o acesso API e verificações de conexão suportadas.
   • Terminal físico: execução Testar conexão e verifique se passa.
   • Tap to Pay: confirme se o telefone está registrado no LIVE Adyen Payments aplicativo. A verificação da conexão valida apenas a configuração: não há diagnóstico do terminal.

Para verificações diárias e reconciliação, consulte Fechar o dia.

Voltar ao conteúdo

Experimente o simulador

Explore o Mini mPOS sem conta nem terminal Adyen. Nenhum cartão é cobrado.

1. Instale o aplicativo em um celular ou emulador Android 9+.
2. Na tela de boas-vindas, selecione Experimente uma demonstração em vez de Digitalizar códigos de configuração ou Conectar-se à Adyen e toque em Continuar.
3. Em Configurações › Simulador, escolha o resultado do pagamento, o atraso e se há impressora. Ative Aprovações off-line para ver os avisos off-line no histórico e na conciliação do terminal.

Em Configurações › Dados e transferência, use Adicionar dados de amostra ou Remover dados de amostra. As amostras são marcadas como demonstração e entram nos totais e relatórios dos dias de demonstração; adicioná-las substitui os dados do estabelecimento no recibo por um café fictício e adiciona o logotipo dele, se não houver um. Removê-las mantém seus próprios produtos, histórico, configurações e logotipo.

Os links de pagamento funcionam off-line sem credenciais de API, e suas telas e recibos são marcados como demonstração. Os QR codes deles não recebem pagamentos; toque em Simular pagamento para concluir um.

O simulador mostra como o Mini mPOS se comporta, não o que seu terminal ou sua conta Adyen aceitam. Recursos como orientação por áudio, aprovações off-line e capacidades da Adyen são imitados, então teste-os em um terminal TEST real antes de depender deles.

Pronto para conectar? Em Configurações › Simulador, toque em Configurar pagamentos reais e depois em Continuar com a configuração. Confirmar TEST ou LIVE exclui todo o histórico local; produtos de amostra e dados do recibo permanecem, então remova as amostras e revise os dados do estabelecimento antes de pagamentos reais. Comece com TEST.

Voltar ao conteúdo