Guia

Solução de problemas

Encontre o que você vê, verifique a causa provável e siga a correção. Se um pagamento estava em andamento, verifique primeiro o resultado: consertar uma conexão não informa se um pagamento anterior foi realizado.

Um pagamento ou reembolso mostra Resultado desconhecido

Aviso

Não cobrar ou reembolsar novamente só porque o app não tem resposta. A solicitação pode ter chegado a Adyen.

  1. Abrir Histórico, filtrar por Precisa de atenção e abra o pagamento ou reembolso original.
  2. Toque Verifique o resultado novamente. Para um terminal, o aplicativo solicita o resultado da transação.
  3. Se o resultado ainda for desconhecido, encontre o pagamento em Customer Area › Pagamentos › Lista de pagamentos por referência, tempo e valor. Decida o que fazer somente após verificar.

Uma falha ou reinicialização deixa a operação interrompida no Histórico como desconhecida. Não limpe os dados do aplicativo para removê-lo.

Com Tap to Pay, Verifique o resultado novamente usa primeiro uma resposta tardia recebida e depois consulta o resultado original no aplicativo Payments selecionado. As consultas exigem a versão 1.8.0 ou posterior; confirme o acesso beta com a Adyen. Sem resposta ou com NotFound, o resultado permanece desconhecido. Consulte Customer Area › Payments › Payment list antes de cobrar novamente.

Voltar ao conteúdo

Um pagamento é recusado ou não processado

A tela de resultados mostra o status, o motivo e o conselho da Adyen. Siga o conselho:

"Não tente novamente com este cartão. Peça ao comprador um cartão ou método de pagamento diferente."

CorreçãoSolicite outro cartão ou forma de pagamento. O banco do cliente pode explicar a recusa; o Razões de recusa da Adyen explicar o motivo mostrado.

Causa

O emissor do cartão recusou este cartão por um motivo que não mudará, tal como um cartão bloqueado ou restrito ou suspeita de fraude, ou o cartão não é permitido para este pagamento.

“Você pode tentar novamente.”

CorreçãoToque Tente novamente, ou peça outro cartão.

Causa

O pagamento foi cancelado, o PIN estava errado ou o cartão foi recusado por um motivo que pode não se repetir, como fundos insuficientes.

“O terminal está ocupado com outra transação ou com seu menu de administração.”

CorreçãoFinalize o outro pagamento ou saia do menu e tente novamente. Se a tela oferecer Cancelar a transação atual do terminal, use-o apenas para interromper a transação e verifique seu resultado antes de tentar novamente.

Causa

O terminal está processando outro pagamento ou mostrando seu menu de administração.

“O terminal não está disponível no momento.”

CorreçãoAguarde um momento, verifique se o terminal está ligado e conectado e tente novamente. Veja quedas de rede.

Causa

O terminal ou seu leitor de cartões fica temporariamente indisponível.

"O terminal não aceitou a solicitação. Verifique as configurações do Terminal antes de tentar novamente."

CorreçãoExecutar os testes em Configurações › Terminal; veja emparelhamento e configuração. Se passarem, peça a Adyen para verificar a configuração do terminal.

Causa

O terminal rejeitou a solicitação conforme enviada, geralmente devido a um problema de configuração.

"O terminal ou sua conta Adyen não suporta esta solicitação. Peça ao suporte da Adyen para verificar se está ativado e tente novamente."

CorreçãoPeça ao suporte da Adyen para verificar se ele está habilitado para a conta do comerciante. Para Tap to Pay, verifique se Tap to Pay em Android está habilitado, não apenas em Adyen Payments App role. Então tente novamente.

Causa

O terminal ou Adyen não oferece o que o pagamento pediu, muitas vezes porque não está habilitado para a conta.

“Não cobrar novamente: este pagamento foi realizado.”

CorreçãoNão carregue novamente. Reembolse se o cliente não pagar.

Causa

O pagamento foi aprovado mesmo que o terminal tenha comunicado um cancelamento.

Voltar ao conteúdo

Um recurso de terminal opcional está faltando ou os totais diferem

Um recurso de terminal está faltando ou foi rejeitado

Verifique o destino selecionado e Capacidades da Adyen, atualize suas configurações e confirme as funções API e a configuração da conta Adyen. Os interruptores de checkout locais por si só não habilitam um serviço na Adyen. Tap to Pay não oferece fluxos de trabalho de terminal físico. Para gorjetas, compare gorjetas no terminal com gorjeta de recibo.

Apenas parte do valor foi aprovado

Siga o fluxo de trabalho de pagamento parcial na tela de resultados. Não carregue novamente o total original completo. Se o resultado de uma tentativa posterior for desconhecido, resolvê-lo antes de coletar mais.

Os totais dos terminais não correspondem a Mini mPOS

Revise o período do terminal, outros dispositivos que utilizam esse terminal, histórico local retido e transações não resolvidas em reconciliação terminal. O encerramento do período não corrige diferenças nem confirma a liquidação.

Uma venda off-line não tem referência PSP ou permanecem lotes não confirmados

Seguir cheques de pagamento off-line. Restaure a conexão do terminal com a Adyen e verifique os pagamentos carregados na Customer Area. Não receba novamente um pagamento aprovado só porque falta a referência PSP.

Voltar ao conteúdo

A digitalização da carteira está faltando ou a digitalização falha

Sem botão Digitalizar carteira

Abrir Configurações › Terminal e toque em Atualizar carteiras escaneadas. Uma verificação bem-sucedida sem carteiras POS elegíveis deixa o botão oculto. Verifique a loja atribuída, a moeda atual e Funções principais de API. Tap to Pay e pré-autorizações não oferecem esta ação.

A descoberta de carteira relata um erro

O erro aparece apenas em Configurações e não bloqueia pagamentos com cartão. Corrija ali a credencial, o ambiente ou o acesso de leitura e atualize. Uma falha temporária mantém as últimas carteiras verificadas.

O código é inválido ou nenhum código chega

Use o código de pagamento do comprador, não um QR de perfil, transferência ou recibo, e escolha a carteira correta. Uma leitura no terminal termina após 30 segundos: toque em Digitalizar novamente ou Usar câmera.

O salvamento é rejeitado ou nenhum token é criado

Um pagamento aprovado continua aprovado sem token salvo. Após uma recusa, desative Salvar cartão e leia de novo, se for o caso. Para Resultado desconhecido, verifique a transação original.

Veja o procedimento de pagamento com carteira.

Voltar ao conteúdo

Falha no emparelhamento ou configuração

Comece com a mensagem em Início, depois abra Configurações › Terminal e completar o final Testar conexão etapa. Isso verifica o acesso API e as verificações de conexão suportadas pela sua integração. Uso de configuração de rede e nuvem Encontre o terminal para configurar testar acesso API e listar terminais; Teste API é oferecido para terminais no dispositivo e Tap to Pay. Para as etapas completas, consulte Conectar-se à Adyen.

Para qualquer integração, abra Configurações › Ajuda e solução de problemas › Detalhes de solução de problemas. Os resultados incluem lacunas de configuração, acesso API, verificações de conexão suportadas, carimbos de data/hora e detalhes do dispositivo; verificações não suportadas são identificadas. Esses cheques não comprovam que pagamentos, reembolsos ou impressões serão bem-sucedidos e não aceitam pagamentos, registram telefones ou trocam chaves. Usar Compartilhar relatório com dados sensíveis ocultados para compartilhar os detalhes exibidos: os IDs do comerciante, do terminal, da instalação e das credenciais permanecem; segredos, mensagens não estruturadas e dados do comprador são excluídos.

A página inicial diz “Os pagamentos ainda não foram configurados”

CorreçãoToque Concluir a configuração dos pagamentos. Em Configurações › Terminal, digite o que está faltando ou digite a chave novamente e toque em Testar conexão.

Causa

Um campo obrigatório está vazio, uma chave salva não pôde ser lida neste dispositivo ou nenhum teste de conexão foi aprovado desde que a configuração foi alterada. Até então, pagamentos, reembolsos, impressões e outras ações da Adyen explicam isso em vez de correrem.

O teste API falha ou a configuração relata um problema de acesso

CorreçãoVerifique as funções e o acesso da credencial em relação ao requisitos de credenciais. Para LIVE, verifique o Prefixo de URL LIVE.

Causa

A chave API, a conta do comerciante ou o prefixo URL ativo estão errados, uma função está faltando ou a credencial é de outra conta ou ambiente da empresa.

“A conta do comerciante não corresponde à atribuição atual deste terminal.”

CorreçãoInsira a conta de comerciante à qual o terminal está atribuído ou reatribua o terminal na Customer Area.

Causa

O terminal é atribuído a uma conta de comerciante diferente na Adyen.

O teste de conexão falha em um terminal Adyen ou terminal de rede

CorreçãoCompare o identificador, a senha e a versão da chave compartilhada com o Customer Area. Para um terminal de rede, verifique o endereço IP e POIID na tela de informações do dispositivo do terminal.

Causa

A chave compartilhada não corresponde, ou o endereço IP ou ID do Terminal (POIID) está desatualizado.

A conexão é rejeitada por causa do ambiente

CorreçãoPara um terminal de rede/nuvem ou Tap to Pay, verifique Ambiente em Configurações › Terminal. Em um terminal Adyen, use um dispositivo do ambiente certo.

Causa

TEST e LIVE são mistos: o terminal, a conta e a chave API devem ser todos de um ambiente.

Um terminal de nuvem não pode ser alcançado

CorreçãoVerifique se o terminal está ligado e online e, em seguida, verifique o POIID e as funções da credencial.

Causa

O terminal está offline, o POIID está errado ou a chave API não possui o Cloud Device API role.

O aplicativo Adyen Payments selecionado está faltando

CorreçãoVerificar Configurações › Terminal › Ambiente e instale o aplicativo correspondente do Google Play. Ambos os aplicativos podem permanecer instalados. Conclua o registro e insira a chave compartilhada correspondente; confirme com um pagamento TEST.

Causa

O aplicativo Adyen Payments para o ambiente TEST ou LIVE selecionado não está instalado.

Tap to Pay retorna UnavailableService antes da apresentação do cartão

O aplicativo Adyen Payments não conseguiu concluir a solicitação. Este erro genérico não prova uma interrupção do Adyen ou uma chave de cliente ausente.

Executar Testar conexão em Configurações › Terminal. Para obter uma tabela compacta de verificações e um relatório redigido, expanda Configurações › Ajuda e solução de problemas › Detalhes de solução de problemas.

Configurar Tap to Pay provisiona automaticamente a credencial de registro e a chave do cliente usando sua chave API primária. Verifique seu funções necessárias se o provisionamento for negado. Aguarde alguns minutos para que novas chaves sejam propagadas e execute Testar conexão novamente. Se a recuperação ainda falhar, tente novamente mais tarde ou peça ao suporte da Adyen para inspecionar a correspondência TEST Customer Area ou LIVE Customer Area. Veja o Requisitos do aplicativo Adyen Payments.

A chave do cliente deverá pertencer à mesma credencial utilizada para registro.

Ao pedir ajuda, use Compartilhar relatório com dados sensíveis ocultados.

"A nova chave está salva. Atualize a configuração deste terminal"

CorreçãoNo terminal, abra Menu Admin › Configuração › Atualizar, depois retorne para Mini mPOS e toque em Verifique novamente. Se a criação foi interrompida, toque em Retomar configuração da chave; ele não cria uma segunda chave. Veja criação de chave e o Guia de atualização de configuração da Adyen.

Causa

A chave de criptografia foi criada na Adyen, mas o terminal ainda não a carregou.

As ações em um pagamento mais antigo são bloqueadas

CorreçãoRestaure o setup que recebeu o pagamento, ou trate-o na Customer Area. Não o processe em outra conta.

Causa

A conta do comerciante, ambiente ou terminal mudou após esse pagamento.

Voltar ao conteúdo

A conexão cai ou o terminal não responde

Importante

Se um pagamento estava em andamento quando a conexão caiu, verificar seu resultado antes de cobrar novamente.

“O terminal não respondeu”, ou um terminal de rede funciona apenas às vezes

Correção

  1. Verifique o endereço IP do terminal na tela de informações do dispositivo e atualize-o em Configurações › Terminal.
  2. Conecte o dispositivo e o terminal à mesma rede. Evite o convidado Wi-Fi, que geralmente isola dispositivos.
  3. Peça ao administrador da rede para permitir TCP 8443 entre eles e reservar o endereço IP do terminal; veja requisitos de rede.
Causa

O endereço IP do terminal mudou, o dispositivo mudou para outra rede ou a rede bloqueia a conexão.

Pagamentos ou testes API falham em todas as configurações

CorreçãoVerifique a conexão com a Internet e certifique-se de que HTTPS em TCP 443 para os domínios da Adyen seja permitido.

Causa

O dispositivo ou terminal não tem acesso à Internet ou um firewall bloqueia a Adyen.

Tempo limite de pagamentos na nuvem

CorreçãoVerifique o Wi-Fi do terminal, Ethernet ou dados móveis e, em seguida, execute Testar conexão.

Causa

O terminal perdeu sua conexão com a internet.

Voltar ao conteúdo

Uma captura ou ajuste falhou ou é desconhecido

Abra a entrada original em Histórico e leia seu motivo. Se a configuração do Checkout API estiver faltando, conclua-a; se a conta ou o ambiente foram alterados, restaure o original.

Captura falhou ou Resultado de captura desconhecido

CorreçãoToque Tentar novamente a captura. Reenvia a mesma captura com segurança; não crie um novo pagamento.

Um ajuste de valor não foi resolvido

CorreçãoTente novamente com o mesmo valor. Um valor diferente é uma solicitação separada e pode ser bloqueada até que a primeira seja resolvida.

Uma gorjeta não foi salva

CorreçãoInsira uma gorjeta menor ou toque em Nenhuma gorjeta.

Causa

O emissor do cartão recusou-se a aumentar a retenção para uma gorjeta superior a 20%.

Captura solicitada ou Reembolso solicitado não muda

CorreçãoConfira o resultado final na Customer Area.

Causa

Isso significa que Adyen aceitou o pedido. Mini mPOS não possui servidor, portanto nunca recebe a confirmação final.

As retenções expiram, portanto resolva-as imediatamente. Para as etapas normais, consulte depósitos e gorjetas sobre o recibo.

Voltar ao conteúdo

A impressora ou os recibos de e-mail não funcionam

Nada é impresso, ou Imprimir recibo está faltando

Correção

  1. Em Configurações › Sobre, verifique se Impressora mostra Disponível. Se não, corra Testar conexão em Configurações › Terminal.
  2. Em Configurações › Recibos, conjunto Impressora para Detectar automaticamente e verifique Imprimir automaticamente.
  3. Toque Imprimir recibo de teste. Se nada for impresso, verifique o rolo de papel do terminal.
Causa

O terminal não tem impressora, a impressora não foi detectada ou a conexão caiu. Os terminais AMS1 e os telefones Tap to Pay não possuem impressora.

O layout está cortado ou mal embrulhado

CorreçãoMudança Caracteres por linha em Configurações › Recibos e imprimir um recibo de teste.

O e-mail de teste falha

CorreçãoEm Configurações › Recibos por e-mail, verifique o servidor, porta, STARTTLS ou SSL/TLS, nome de usuário e senha. Seu provedor pode exigir que o acesso SMTP esteja ativado ou uma senha de aplicativo; veja configuração de e-mail.

Causa

Servidor, porta, segurança ou senha errada, ou o provedor bloqueia SMTP ou login com senha.

E-mails de teste funcionam, mas os clientes não recebem recibo

CorreçãoEm Configurações › Recibos por e-mail, verifique quando o e-mail é solicitado e se os recibos são enviados automaticamente.

O logotipo não foi impresso

Confira a prévia em Configurações › Recibos e imprima um recibo de teste. Se o terminal recusar o logotipo, o Mini mPOS ainda pode imprimir o texto e mostra um aviso na primeira recusa. Problemas de papel, falta de impressora ou uma solicitação de impressão sem resposta interrompem a impressão. Consulte as configurações do logotipo para tentar uma imagem mais simples ou removê-lo.

Voltar ao conteúdo

PIN e problemas de transferência de configuração

A equipe esqueceu o Gerente PIN

CorreçãoUm administrador pode substituí-lo ou removê-lo em Configurações › Segurança. O PIN de administrador e o gerente PIN protegem ações diferentes; um não desbloqueia o outro.

O PIN de administrador foi esquecido

CausaNão há recuperação PIN.

Para começar novamente sem o PIN de administrador, siga recuperação de armazenamento. Leia o aviso de perda de dados antes de redefinir.

O código de transferência é rejeitado ou faltam chaves após a importação

CorreçãoUse o código mostrado com estes códigos QR, e não um recém-gerado. Cada transferência precisa do seu código. Um código errado ou em branco não importa nada. Após a cópia, verifique o destino e as credenciais do novo dispositivo; veja mais dispositivos.

Causa

O código não pertence a estes códigos QR, ou foi deixado em branco.

Para revisar quais ações cada PIN protege, consulte equipe PINs.

Voltar ao conteúdo

As configurações ou credenciais salvas não podem ser lidas ou gravadas

Mini mPOS para em vez de substituir configurações ou credenciais ilegíveis. Isso preserva os arquivos, incluindo qualquer configuração inacabada ou registros de recuperação de pagamento.

Aviso

A limpeza do armazenamento ou a desinstalação exclui todos os produtos locais, configurações, credenciais, PINs, histórico e registros de recuperação de operações inacabadas. Uma transferência de configuração não pode restaurar o histórico ou esses registros de recuperação. A redefinição não desfaz pagamentos, reembolsos ou capturas já enviadas à Adyen.

  1. Reinicie o dispositivo e abra Mini mPOS novamente. Se o armazenamento do dispositivo estiver cheio, libere primeiro espaço fora do Mini mPOS. Limpar apenas o cache do aplicativo não redefine as configurações salvas.
  2. Antes de zerar, guarde os registros necessários e resolva pagamentos inacabados, reembolsos, capturas e ajustes. Caso o aplicativo não abra, verifique o resultado na Customer Area; veja resultados desconhecidos. Se o resultado ainda for incerto, guarde os dados do aplicativo e reconcilie-os primeiro com a Adyen. Não envie a operação novamente só porque o aplicativo não consegue abrir.
  3. Se o erro persistir e você aceitar a perda de todos os dados locais, reinicie Mini mPOS. Em um telefone ou tablet, abra Android Configurações › Aplicativos › Mini mPOS › Armazenamento e cache › Limpar armazenamento (os rótulos variam de acordo com o dispositivo) ou desinstale o Mini mPOS e reinstale-o a partir do último lançamento . Em um terminal Adyen, peça à pessoa que gerencia os aplicativos do terminal que organize a redefinição ou remoção e reinstalação; veja o Guia de implantação do aplicativo Adyen.
  4. Configure Mini mPOS novamente ou importe uma transferência de configuração confiável e conclua Testar conexão antes de receber pagamentos reais. Veja Conectar-se à Adyen.

Instalar uma atualização sobre o aplicativo existente não redefine seu armazenamento. Se o erro retornar, relatar um problema de aplicativo no GitHub; não anexe arquivos de configuração ou credenciais salvas.

Voltar ao conteúdo

O aplicativo não é instalado em um terminal

INSTALL_PARSE_FAILED_NO_CERTIFICATES

CorreçãoCarregar o assinado minimpos-<version>.apk do último lançamento.

Causa

O APK não está assinado.

INVALID_SIGNING_CERTIFICATE_MISMATCH

CorreçãoManter a fonte de assinatura original. Se precisar alterá-lo, pergunte ao suporte da Adyen sobre a remoção de versões anteriores.

Causa

O APK é assinado com uma chave diferente dos uploads anteriores.

A versão Android não é suportada

CorreçãoUtilize um terminal suportado; veja instalação .

Causa

Mini mPOS precisa de Android 9 ou posterior; o S1E mais antigo executa o Android 7.1.

Voltar ao conteúdo

Uma mensagem de erro nomeia um problema

Cada mensagem nomeia o problema e o que verificar. Detalhes entre colchetes, como endereço IP, status HTTP ou as próprias palavras da Adyen, ajudam o suporte da Adyen: inclua-os quando pedir ajuda. Se um pagamento estivesse em andamento, verificar seu resultado antes de consertar qualquer outra coisa.

Mensagens de erro
"O terminal não pôde ser alcançado. Verifique se ele está ligado, na mesma rede e neste endereço IP."

CorreçãoSeguir quedas de rede.

Causa

Mini mPOS não conseguiu abrir uma conexão com o terminal de rede no endereço IP salvo.

"Este endereço não é um terminal Adyen do ambiente selecionado. Verifique o endereço IP e TEST ou LIVE."

CorreçãoVerifique o endereço IP na tela de informações do dispositivo do terminal e Ambiente em Configurações › Terminal.

Causa

Algo respondeu naquele endereço, mas não um terminal Adyen do ambiente selecionado: o endereço agora pertence a outro dispositivo, ou TEST e LIVE estão misturados.

"O terminal rejeitou a chave compartilhada. Verifique o identificador da chave, versão e senha nas configurações do Terminal."

CorreçãoCompare-os com o Customer Area, ou configure a chave novamente.

Causa

O identificador, versão ou frase secreta da chave compartilhada difere do terminal.

"A resposta do terminal não pôde ser verificada. Verifique a chave compartilhada nas configurações do Terminal."

CorreçãoConfira o resultado antes de cobrar novamente e, em seguida, corrija a chave compartilhada.

Causa

O terminal respondeu com uma chave compartilhada diferente, portanto a solicitação pode ter chegado até ele.

"O terminal não está conectado ao Adyen. Verifique se ele está ligado e online."

CorreçãoVerifique o Wi-Fi, Ethernet ou dados móveis do terminal e, em seguida, execute Testar conexão.

Causa

O terminal em nuvem está desligado ou não tem conexão com a internet.

"Adyen não aceitou a chave API. Verifique nas configurações do Terminal."

CorreçãoInsira a chave novamente e compare-a com o requisitos de credenciais.

Causa

A chave API está errada, revogada ou de outro ambiente.

"A chave API não possui uma função ou acesso a esta conta de comerciante. Verifique a credencial API na sua Customer Area."

CorreçãoAdicionar a função ou acesso à conta na Customer Area; veja o requisitos de credenciais.

Causa

A credencial não possui uma função ou acesso a esta conta de comerciante. Os colchetes nomeiam a função ausente quando ela é conhecida.

“Adyen está ocupado ou temporariamente indisponível.”

CorreçãoEspere um momento e tente novamente. Para um link de pagamento, captura ou pagamento, verificar seu resultado primeiro.

Causa

Adyen está limitando as solicitações ou está temporariamente indisponível.

“Nenhuma resposta voltou no tempo.”

CorreçãoConfira o resultado. Não carregue novamente até saber disso.

Causa

A solicitação foi enviada, mas nenhuma resposta chegou, portanto seu resultado é desconhecido.

“O resultado do Payments ainda é desconhecido. Atualize o aplicativo Payments selecionado, confirme o acesso às consultas com a Adyen e consulte a Customer Area antes de cobrar novamente.”

CorreçãoEncontre o pagamento na Customer Area antes de cobrar novamente.

Causa

Recuperação do resultado do Tap to Pay.

"Não foi possível abrir o aplicativo Adyen Payments. Verifique se ele está instalado."

CorreçãoInstale o aplicativo Adyen Payments para seu ambiente e tente novamente. Veja Conectar-se à Adyen.

Causa

O aplicativo Adyen Payments não está instalado ou foi removido.

"O servidor de e-mail não aceitou o nome de usuário ou senha. Verifique-os em Configurações › Recibos de e-mail."

CorreçãoCorrija-os e envie um e-mail de teste.

Causa

O nome de usuário ou senha SMTP está errado ou o provedor exige uma senha de aplicativo.

"O armazenamento seguro deste dispositivo não funcionou. Tente novamente ou reinicie o dispositivo."

CorreçãoSe continuar após uma reinicialização, insira novamente as chaves e senhas.

Causa

O armazenamento de chaves de Android não pôde criptografar ou ler um segredo salvo.

Voltar ao conteúdo

Ainda precisa de ajuda?

Para contas Adyen, implantação de terminal, métodos de pagamento ou resultados finais de pagamento, entre em contato com a Adyen. Para um problema de aplicativo, abrir um problema no GitHub com a versão do aplicativo, modelo do dispositivo, configuração, ambiente TEST ou LIVE e as etapas para reprodução.

Importante

Nunca inclua chaves, senhas, PINs ou dados de clientes. Relate vulnerabilidades suspeitas de forma privada sob o política de segurança .

Voltar ao conteúdo