3 - Tabela de Erros
Referência de erros do SDK Tap to Pay no Android — códigos, causas e orientações de resolução.
Consulte os códigos de erro retornados pelo SDK Tap to Pay no Android, com suas possíveis causas e orientações de resolução.
Os erros estão organizados em quatro categorias:
Erros internos do SDK (1xxx)
Estes erros são gerados pela camada interna do SDK e estão divididos por fluxo:
| Fluxo | Códigos |
|---|---|
| Ativação do Terminal | 1001, 1002, 1003, 1004, 1006, 1012–1018 |
| Pagamento | 1000, 1005, 1007–1011, 1019 |
Ativação do Terminal
1001 — Vendedor ou estabelecimento não identificado
Mensagem: Transação não concluída. Vendedor ou Estabelecimento não identificado. Entre em contato sua central de atendimento.
| Causas | O seller ou marketplace configurado não existe, está inativo ou não está associado às credenciais utilizadas. |
| Orientação | Confirme que os identificadores seller e marketplace estão corretos e ativos. Se o problema persistir, entre em contato com o suporte Zoop. |
1002 — Falha na ativação do terminal
Mensagem: Transação não concluída. Tente novamente.
| Causas | Falha temporária durante o processo de ativação do terminal. |
| Orientação | Tente novamente. Se o erro persistir, verifique a conectividade e reinicie a aplicação. |
1003 — Problema técnico na ativação
Mensagem: Ocorreu um problema técnico. Estamos trabalhando para resolver.
| Causas | Falha em serviço interno da Zoop ou indisponibilidade temporária do backend. |
| Orientação | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o suporte Zoop. |
1004 — Tempo limite excedido na ativação
Mensagem: Excedido o limite de tempo. Tente novamente.
| Causas | A ativação do terminal demorou mais que o tempo permitido. Conexão lenta ou instável. |
| Orientação | Verifique a qualidade da conexão de internet e tente novamente. |
1006 — Estado inconsistente na ativação
Mensagem: Ocorreu um problema. Feche e abra novamente o aplicativo.
| Causas | O SDK entrou em um estado inconsistente durante a ativação. |
| Orientação | Feche completamente o aplicativo e abra novamente. Se o erro persistir, desinstale e reinstale o app. |
1012 — Timeout na inicialização do MyPinPad SDK
Mensagem: Tempo esgotado na inicialização do Kernel SDK.
| Causas | O componente Kernel não respondeu dentro do tempo esperado. Possível conflito com outros processos ou recursos do dispositivo insuficientes. |
| Orientação | Reinicie o aplicativo. Verifique se o dispositivo possui memória e recursos suficientes. |
1013 — Problema na ativação (reinício necessário)
Mensagem: Ocorreu um problema. Feche e abra novamente o aplicativo.
| Causas | Falha interna no SDK durante a ativação do terminal. |
| Orientação | Feche completamente o aplicativo e abra novamente. |
1014 / 1015 / 1017 — Problema técnico (suporte necessário)
Mensagem: Ocorreu um problema técnico. Por favor, contate o suporte para assistência.
| Causas | Falha interna que requer análise do time Zoop. |
| Orientação | Colete os logs do SDK e entre em contato com o suporte Zoop. |
1016 — Estado inconsistente na ativação
Mensagem: Ocorreu um problema. Feche e abra novamente o aplicativo.
| Causas | O SDK entrou em um estado inconsistente durante a ativação. |
| Orientação | Feche completamente o aplicativo e abra novamente. Se o erro persistir, desinstale e reinstale o app. |
1018 — Timeout na ativação do terminal
Mensagem: Transação não concluída. Excedido o limite de tempo na ativação do terminal.
| Causas | O processo de ativação do terminal ultrapassou o tempo limite. Conexão lenta ou serviço temporariamente indisponível. |
| Orientação | Verifique a qualidade da conexão de internet e tente novamente. |
Pagamento
1000 — SDK não inicializado
Mensagem: A SDK não foi inicializada.
| Causas | O método de inicialização do SDK não foi chamado antes de iniciar o pagamento, ou a inicialização falhou silenciosamente. |
| Orientação | Certifique-se de chamar o método de inicialização do SDK com sucesso antes de iniciar qualquer transação. |
1005 — Timeout de sessão no pagamento
Mensagem: Transação não concluída. Excedido o limite de tempo da sessão.
| Causas | A sessão de pagamento expirou antes da conclusão da transação. O usuário pode ter demorado para aproximar o cartão. |
| Orientação | Inicie uma nova transação. Oriente o usuário a aproximar o cartão assim que a tela de pagamento for exibida. |
1007 — Problema técnico no pagamento
Mensagem: Ocorreu um problema técnico. Estamos trabalhando para resolver.
| Causas | Falha em serviço interno da Zoop durante o processamento do pagamento. |
| Orientação | Aguarde alguns minutos e tente novamente. Verifique se a transação não foi concluída antes de retentar (consulte via Webhook ou API). |
1008 — Falha crítica no pagamento
Mensagem: Transação não pode ser iniciada. Feche ou reinstale o aplicativo.
| Causas | O SDK está em estado irrecuperável. Possível corrupção de cache ou dados internos. |
| Orientação | Feche o aplicativo. Se o erro persistir, desinstale e reinstale o app. |
1009 — Tempo limite excedido no pagamento
Mensagem: Excedido o limite de tempo. Tente novamente.
| Causas | A operação de pagamento demorou mais que o tempo permitido. Conexão lenta ou instável. |
| Orientação | Verifique a qualidade da conexão de internet e tente novamente. |
1010 — Falha na transação
Mensagem: Transação não concluída. Tente novamente.
| Causas | Falha genérica durante o processamento da transação. |
| Orientação | Tente novamente. Se o erro persistir, verifique os logs do SDK para mais detalhes e entre em contato com o suporte Zoop. |
1011 — Erro na confirmação da transação
Mensagem: Transação não concluída. Erro na confirmação da transação.
| Causas | A transação foi processada, mas a confirmação falhou. Possível falha de comunicação com o servidor no momento da confirmação. |
| Orientação | Verifique o status real da transação via Webhook ou API antes de retentar. Não inicie uma nova cobrança sem confirmar se a anterior foi ou não efetivada. |
Antes de retentar, sempre verifique o status da transação original para evitar cobranças duplicadas.
1019 — Valor acima do permitido
Mensagem: Tentativa de transação com o valor acima do permitido.
| Causas | O valor informado na transação excede o limite máximo configurado para o estabelecimento ou para o meio de pagamento. |
| Orientação | Verifique os limites configurados para o seu marketplace/seller. Se precisar de um limite maior, entre em contato com o suporte Zoop. |
Erros de Kernel (2xxx)
Estes erros são gerados pelo kernel de pagamento interno e estão divididos por fluxo:
| Fluxo | Códigos |
|---|---|
| Criação de Terminal | 2030–2034 |
| Criação de Sessão | 2023–2029, 2035 |
| Transação | 2001–2022, 2036–2039 |
| Erros detalhados de Terminal | Códigos 1–21 |
| Erros internos do Kernel | Códigos 10003–10078 |
Criação de Terminal
Estes erros ocorrem ao chamar o método de criação do terminal (initialize ou pay). Cada código indica uma falha específica no processo de inicialização do terminal.
2030 — Falha na atestação de segurança do dispositivo
Mensagem: Não foi possível atestar segurança do seu dispositivo. Tente novamente.
| Erro | TerminalCreationFailureCause.DEVICE_STATE_FAILURE |
| Descrição | Device attestation has failed before Terminal instance created. |
| Causas | Dispositivo com root/bootloader desbloqueado, Google Play Services desatualizado ou dispositivo não certificado pelo Google. |
| Orientação | Verifique se o dispositivo possui certificação Google Play Protect. Atualize o Google Play Services e o sistema operacional. Certifique-se de que o dispositivo não está com root ativo. |
2031 — Erro interno na criação do terminal
Mensagem: Terminal não pode ser criado. Tente novamente.
| Erro | TerminalCreationFailureCause.INTERNAL_ERROR |
| Descrição | Internal error while creating terminal instance. |
| causas | Falha temporária no SDK, conflito de dependências ou estado inconsistente da aplicação. |
| Orientação | Tente novamente. Verifique os detalhes adicionais retornados no objeto de erro do terminal. Se o problema persistir, colete os logs e entre em contato com o suporte Zoop. |
Este erro pode conter detalhes adicionais no objeto de retorno. Inspecione o campo de mensagem do erro para obter mais informações sobre a causa raiz. Consulte a tabela de erros detalhados de Terminal para a lista de exceções internas.
2032 — Falha no provisionamento de chaves
Mensagem: Terminal não pode ser criado. Entre em contato com sua central de atendimento.
| Erro | TerminalCreationFailureCause.KEY_PROVISIONING_FAILURE |
| Descrição | Key provisioning has failed before Terminal instance created. |
| Causas | Credenciais inválidas ou expiradas, falha na comunicação com o servidor de chaves ou aplicativo não autorizado na Play Store. |
| Orientação | Confirme que as credenciais (clientId, clientSecret, accessKey) estão corretas e dentro da validade. Verifique se a versão do aplicativo foi liberada via API com as credenciais CSO. Se o erro persistir, entre em contato com o suporte Zoop. |
2033 — Versão do Android não suportada
Mensagem: A versão do sistema operacional Android não é suportada.
| Erro | TerminalCreationFailureCause.UNSUPPORTED_ANDROID_OS_VERSION |
| Descrição | Android os version is not supported by Terminal SDK.. |
| Causas | O dispositivo está rodando uma versão do Android inferior ao mínimo exigido pela versão do SDK utilizada. |
| Orientação | Verifique o requisito mínimo de acordo com a versão do SDK: |
| Versão do SDK | Android mínimo |
|---|---|
| Até 2.4.x | Android 9.0 (API Level 28) |
| 2.5.0 em diante | Android 10 (API Level 29) |
2034 — Conexão de rede indisponível
Mensagem: Terminal não pode ser criado. Conexão de rede não está disponível.
| Erro | TerminalCreationFailureCause.NETWORK_CONNECTION_ERROR |
| Descrição | Creating terminal failed because network connection is not available. |
| Causas | Dispositivo sem acesso à internet (Wi-Fi ou dados móveis desativados), rede instável ou firewall/proxy bloqueando a comunicação com os servidores da Zoop. |
| Orientação | Verifique se o dispositivo possui conexão ativa com a internet. Teste a conectividade acessando outro serviço. Caso utilize rede corporativa, confirme que os endpoints da Zoop não estão bloqueados por firewall ou proxy. |
Criação de Sessão
Estes erros ocorrem durante a ativação da sessão do terminal. Cada código indica uma falha específica no processo de criação da sessão.
2023 — Falha de rede na criação da sessão
Mensagem: Sessão não pode ser iniciada. Verifique a conexão do seu dispositivo e tente novamente.
| Erro | SessionActivationFailureCause.NETWORK_ERROR |
| Descrição | Activation failed due to a network communication or server issue. |
| Causas | Dispositivo sem conexão estável com a internet, falha de comunicação com os servidores da Zoop ou timeout na requisição de ativação. |
| Orientação | Verifique se o dispositivo possui conexão ativa com a internet. Teste a conectividade acessando outro serviço. Se o problema persistir, aguarde alguns minutos e tente novamente. |
2024 — Erro de serviço na criação da sessão
Mensagem: Sessão não pode ser iniciada. Entre em contato sua central de atendimento.
| Erro | SessionActivationFailureCause.SERVICE_ERROR |
| Descrição | Activation failed due to service error. |
| Causas | Falha em serviço interno da Zoop durante a ativação da sessão. Possível indisponibilidade temporária. |
| Orientação | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o suporte Zoop. |
2025 — Falha na atestação de segurança do dispositivo (sessão)
Mensagem: A atestação do dispositivo falhou antes da criação da instância da sessão do terminal.
| Erro | SessionActivationFailureCause.DEVICE_STATE_FAILURE |
| Descrição | Device attestation has failed before TerminalSession instance created. |
| Causas | Dispositivo com root/bootloader desbloqueado, Google Play Services desatualizado ou dispositivo não certificado pelo Google. |
| Orientação | Verifique se o dispositivo possui certificação Google Play Protect. Atualize o Google Play Services e o sistema operacional. Certifique-se de que o dispositivo não está com root ativo. |
2026 — Adaptador NFC não está pronto
Mensagem: O adaptador NFC não está pronto para aceitar cartões.
| Erro | SessionActivationFailureCause.NFC_ERROR |
| Descrição | NFC adapter is not ready for accepting cards. |
| Causas | NFC desativado nas configurações do dispositivo, hardware NFC com defeito ou outro aplicativo utilizando o adaptador NFC exclusivamente. |
| Orientação | Verifique se o NFC está ativado em Configurações > Conexões > NFC. Feche outros aplicativos que possam estar utilizando o NFC e tente novamente. |
2027 — Falha na validação de configuração do terminal
Mensagem: Sessão não pode ser iniciada. Entre em contato sua central de atendimento.
| Erro | SessionActivationFailureCause.CONFIGURATION_VALIDATION_HASH_FAILURE |
| Descrição | Terminal configuration validation has validation failed. |
| Causas | A configuração do terminal foi alterada ou corrompida. Possível incompatibilidade entre a versão do aplicativo e as configurações provisionadas pela Zoop. |
| Orientação | Confirme que a versão do aplicativo foi liberada via API com as credenciais CSO. Se o erro persistir, entre em contato com o suporte Zoop. |
2028 — Terminal desativado antes da resposta do serviço
Mensagem: Sessão não pode ser iniciada. Tente novamente.
| Erro | SessionActivationFailureCause.DEACTIVATED |
| Descrição | Terminal has been deactivated before service response has been processed. |
| Causas | O terminal foi desativado durante o processo de criação da sessão, antes que a resposta do servidor fosse processada. |
| Orientação | Tente novamente. Evite navegar para outras telas ou fechar o aplicativo durante a ativação da sessão. |
2029 — Erro interno na criação da sessão
Mensagem: Sessão não pode ser iniciada. Tente novamente.
| Erro | SessionActivationFailureCause.INTERNAL_ERROR |
| Descrição | Activation failed due to an internal error. |
| Causas | Falha temporária no SDK, conflito de dependências ou estado inconsistente da aplicação. |
| Orientação | Tente novamente. Verifique os detalhes adicionais retornados no objeto de erro do terminal. Se o problema persistir, colete os logs e entre em contato com o suporte Zoop. |
Este erro pode conter detalhes adicionais no objeto de retorno. Inspecione o campo de mensagem do erro para obter mais informações sobre a causa raiz. Consulte a tabela de erros detalhados de Terminal para a lista de exceções internas.
2035 — Conexão de rede indisponível (sessão)
Mensagem: Sessão não pode ser iniciada. Conexão de rede não está disponível.
| Erro | SessionActivationFailureCause.NETWORK_CONNECTION_ERROR |
| Descrição | Activation failed because network connection is not available. |
| Causas | Dispositivo sem acesso à internet (Wi-Fi ou dados móveis desativados), rede instável ou firewall/proxy bloqueando a comunicação com os servidores da Zoop. |
| Orientação | Verifique se o dispositivo possui conexão ativa com a internet. Teste a conectividade acessando outro serviço. Caso utilize rede corporativa, confirme que os endpoints da Zoop não estão bloqueados por firewall ou proxy. |
Transação
Estes erros ocorrem durante o processamento de uma transação de pagamento. Cada código indica uma falha específica no fluxo transacional do kernel.
2001 — Transação recusada online
Mensagem: Transação não autorizada. Tente novamente.
| Erro | TransactionNotAuthorisedReason.ONLINE_DECLINED |
| Descrição | Transaction not authorised by online response. |
| Causas | O emissor do cartão recusou a transação online. Possíveis motivos: saldo insuficiente, cartão bloqueado ou limite excedido. |
| Orientação | Solicite ao portador que verifique o cartão junto ao emissor. Tente novamente com outro cartão se necessário. |
2002 — Transação recusada offline
Mensagem: Transação não autorizada. Tente novamente.
| Erro | TransactionNotAuthorisedReason.OFFLINE_DECLINED |
| Descrição | Transaction not authorised by offline processing. |
| Causas | O processamento offline do cartão recusou a transação. O cartão pode ter restrições de uso offline ou estar expirado. |
| Orientação | Tente novamente. Se o erro persistir, solicite ao portador que utilize outro cartão. |
2003 — Dados de autorização inválidos
Mensagem: Transação não autorizada. Tente novamente.
| Erro | TransactionNotAuthorisedReason.INVALID_AUTHORISATION_DATA |
| Descrição | Issuer response contains invalid Authorisation response. |
| Causas | A resposta do emissor contém dados de autorização inválidos ou corrompidos. |
| Orientação | Tente novamente. Se o erro persistir, colete os logs e entre em contato com o suporte Zoop. |
2004 — Nenhuma aplicação compatível no cartão
Mensagem: Transação não pode ser iniciada. Use outro cartão.
| Erro | TransactionNotAuthorisedReason.NO_CARD_APPLICATION |
| Descrição | No card application is available to process the transaction. |
| Causas | O cartão não possui uma aplicação EMV compatível com o terminal. Pode ser um cartão não suportado (ex.: cartão de benefícios ou cartão estrangeiro não compatível). |
| Orientação | Solicite ao portador que utilize outro cartão compatível com pagamento por aproximação. |
2005 — Erro de processamento no kernel
Mensagem: Transação não concluída. Tente novamente.
| Erro | TransactionNotAuthorisedReason.PROCESSING_ERROR |
| Descrição | Transaction processing errors during kernel process. |
| Causas | Erro durante o processamento interno do kernel. Possível falha temporária ou problema na leitura do cartão. |
| Orientação | Tente novamente. Se o erro persistir, reinicie o aplicativo e tente com outro cartão. |
2006 — Erro no cartão
Mensagem: Transação não pode ser iniciada. Ligue para o seu cartão.
| Erro | TransactionNotAuthorisedReason.CARD_ERROR |
| Descrição | Card error being found during kernel process. |
| Causas | O cartão apresentou um erro durante o processamento. Possível chip danificado, cartão expirado ou bloqueado pelo emissor. |
| Orientação | Solicite ao portador que entre em contato com o emissor do cartão. Tente com outro cartão se disponível. |
2007 — Transação terminada pelo kernel
Mensagem: Transação encerrada. Tente novamente.
| Erro | TransactionCancelReason.TRANSACTION_WAS_TERMINATED |
| Descrição | Transaction is terminated by kernel processing. |
| Causas | O kernel encerrou a transação durante o processamento. Possível falha na comunicação com o cartão ou timeout. |
| Orientação | Tente novamente. Peça ao portador que mantenha o cartão próximo ao dispositivo durante toda a transação. |
2008 — Usuário cancelou a entrada de senha
Mensagem: Transação encerrada. Tente novamente.
| Erro | TransactionCancelReason.USER_CANCELLED_PIN_PAD |
| Descrição | User cancels pin entry. |
| Causas | O portador cancelou a entrada de senha (PIN) durante a transação. |
| Orientação | Inicie uma nova transação. Oriente o portador a digitar a senha quando solicitado. |
2009 — Conexão de rede indisponível na transação
Mensagem: Transação não pode ser iniciada. Verifique a conexão do seu dispositivo e tente novamente.
| Erro | TransactionErrorCause.NETWORK_CONNECTION_ERROR |
| Descrição | Network connection is not available at beginning of transaction processing. |
| Causas | Dispositivo sem acesso à internet no momento em que a transação foi iniciada. |
| Orientação | Verifique se o dispositivo possui conexão ativa com a internet e tente novamente. |
2010 — Uso de microfone detectado
Mensagem: Transação não pode ser iniciada. Foi detectado uso do microfone. Por favor, encerre o uso do microfone e tente novamente.
| Erro | TransactionErrorCause.MICROPHONE_USAGE_DETECTED |
| Descrição | Transaction processing failed because microphone usage has been detected. |
| Causas | Outro aplicativo está utilizando o microfone do dispositivo, o que representa risco de segurança durante a transação. |
| Orientação | Feche qualquer aplicativo que esteja usando o microfone (chamadas, gravações, assistentes de voz) e tente novamente. |
2011 — Uso de câmera detectado
Mensagem: Transação não pode ser iniciada. Foi detectado uso da câmera externa. Por favor, encerre o uso da câmera e tente novamente.
| Erro | TransactionErrorCause.CAMERA_USAGE_DETECTED |
| Descrição | Transaction processing failed because camera usage has been detected. |
| Causas | Outro aplicativo está utilizando a câmera do dispositivo, o que representa risco de segurança durante a transação. |
| Orientação | Feche qualquer aplicativo que esteja usando a câmera e tente novamente. |
2012 — Câmera externa detectada
Mensagem: Transação não pode ser iniciada. Foi detectada uma câmera externa. Por favor, remova a câmera e tente novamente.
| Erro | TransactionErrorCause.EXTERNAL_CAMERA_DETECTED |
| Descrição | Get card data processing failed because external camera has been detected. |
| Causas | Uma câmera externa (USB ou acessório) está conectada ao dispositivo, o que representa risco de captura de dados sensíveis do cartão. |
| Orientação | Remova a câmera externa do dispositivo e tente novamente. |
2013 — Falha de rede durante a transação
Mensagem: Transação não concluída. Verifique a conexão do seu dispositivo e tente novamente. Entre em contato para suporte.
| Erro | TransactionErrorCause.NETWORK_ERROR |
| Descrição | Transaction processing failed due to a network communication or server issue. |
| Causas | Falha de comunicação com os servidores da Zoop durante o processamento da transação. Rede instável ou timeout. |
| Orientação | Verifique a conexão de internet. Antes de retentar, confirme o status da transação via Webhook ou API para evitar cobranças duplicadas. |
2014 — Timeout total da transação
Mensagem: Excedido o limite de tempo para finalizar a transação. Tente novamente.
| Erro | TransactionErrorCause.TOTAL_ELAPSED_TIMEOUT |
| Descrição | Transaction processing total elapse timed out. |
| Causas | O tempo total permitido para concluir a transação foi excedido. Conexão lenta, demora na leitura do cartão ou na senha. |
| Orientação | Tente novamente. Oriente o portador a aproximar o cartão e digitar a senha rapidamente. |
2015 — Timeout na leitura do cartão
Mensagem: Excedido o limite de tempo para leitura do cartão. Tente novamente.
| Erro | TransactionErrorCause.DISCOVERY_TIMEOUT |
| Descrição | Transaction processing card discovery timed out. |
| Causas | O cartão não foi detectado pelo NFC dentro do tempo limite. O portador pode não ter aproximado o cartão corretamente. |
| Orientação | Inicie uma nova transação. Oriente o portador a aproximar o cartão na parte traseira do dispositivo assim que a tela de pagamento for exibida. |
2016 — Timeout acumulado na entrada de senha
Mensagem: Excedido o limite de tempo total para entrar com a senha do cartão. Tente novamente.
| Erro | TransactionErrorCause.PIN_ENTRY_ACCUMULATED_TIMEOUT |
| Descrição | Transaction processing pin entry accumulated timed out. |
| Causas | O tempo total acumulado para digitação da senha foi excedido (soma de todas as tentativas). |
| Orientação | Inicie uma nova transação. Oriente o portador a digitar a senha imediatamente quando o teclado for exibido. |
2017 — Timeout na entrada de senha
Mensagem: Excedido o limite de tempo para entrar com a senha do cartão. Tente novamente.
| Erro | TransactionErrorCause.PIN_ENTRY_TIMEOUT |
| Descrição | Transaction processing each pin entry timed out. |
| Causas | O tempo permitido para uma tentativa individual de digitação da senha foi excedido. |
| Orientação | Inicie uma nova transação. Oriente o portador a digitar a senha mais rapidamente. |
2018 — Timeout na autorização da transação
Mensagem: Excedido o limite de tempo para finalizar a transação. Tente novamente.
| Erro | TransactionErrorCause.AUTHORIZATION_IN_PROGRESS_TIMEOUT |
| Descrição | Transaction processing authorization in progress network timed out. |
| Causas | O processo de autorização junto ao servidor excedeu o tempo limite. Conexão lenta ou instável. |
| Orientação | Verifique a conexão de internet. Antes de retentar, confirme o status da transação via Webhook ou API para evitar cobranças duplicadas. |
2019 — Erro interno na transação
Mensagem: Transação não concluída. Tente novamente.
| Erro | TransactionErrorCause.INTERNAL_ERROR |
| Descrição | Transaction processing failed due to internal error. |
| Causas | Falha temporária no SDK, conflito de dependências ou estado inconsistente da aplicação. |
| Orientação | Tente novamente. Verifique os detalhes adicionais retornados no objeto de erro do terminal. Se o problema persistir, colete os logs e entre em contato com o suporte Zoop. |
Este erro pode conter detalhes adicionais no objeto de retorno. Inspecione o campo de mensagem do erro para obter mais informações sobre a causa raiz. Consulte a tabela de erros detalhados de Terminal para a lista de exceções internas.
2020 — Exceção recebida do aplicativo hospedeiro
Mensagem: Ocorreu uma falha no processamento da transação devido a uma exceção recebida do aplicativo hospedeiro.
| Erro | TransactionErrorCause.HOST_CALLBACK_ERROR |
| Descrição | Transaction processing failed due to an exception received from the host app. |
| Causas | O aplicativo hospedeiro lançou uma exceção durante um callback do SDK. Possível erro na implementação do callback ou estado inesperado da aplicação. |
| Orientação | Verifique a implementação dos callbacks do SDK no seu aplicativo. Colete os logs e entre em contato com o suporte Zoop. |
Este erro pode conter detalhes adicionais no objeto de retorno. Inspecione o campo de mensagem do erro para obter mais informações sobre a causa raiz. Consulte a tabela de erros detalhados de Terminal para a lista de exceções internas.
2021 — Teclado de senha obstruído
Mensagem: Transação não pode ser iniciada. Teclado de senha está obstruído por outra janela.
| Erro | TransactionErrorCause.PIN_PAD_OBSCURED_ERROR |
| Descrição | PIN pad view obscured by another window. |
| Causas | Outra janela ou overlay está sobrepondo o teclado de senha, impedindo a entrada segura do PIN. Pode ser um alerta do sistema ou outro app. |
| Orientação | Feche janelas flutuantes, overlays ou notificações que possam estar sobre a tela de senha. Tente novamente. |
2022 — Tela de senha fechada inesperadamente
Mensagem: Transação encerrada. Tela de senha foi fechada.
| Erro | TransactionCancelReason.PIN_PAD_DETACHED_ERROR |
| Descrição | PIN pad view was detached unexpectedly, probably PIN screen Activity was closed externally. |
| Causas | A Activity da tela de senha foi fechada externamente (ex.: navegação, rotação de tela ou gerenciamento de memória do Android). |
| Orientação | Evite navegar para outras telas durante a digitação da senha. Verifique se a Activity do pagamento está configurada corretamente. |
2036 — Aplicação do cartão incompatível (seletor)
Mensagem: Transação não pode ser iniciada. Use outro cartão.
| Erro | TransactionNotAuthorisedReason.NO_CARD_APPLICATION_SELECTOR_MISMATCHED |
| Descrição | No card application is available to process the transaction while application selector is mismatched. |
| Causas | O cartão possui aplicações EMV, mas nenhuma é compatível com o seletor de aplicação configurado no terminal. |
| Orientação | Solicite ao portador que utilize outro cartão compatível com pagamento por aproximação. |
2037 — Falha na validação de segurança do dispositivo
Mensagem: Falha na validação do seu dispositivo. Tente novamente. Para suporte, entre em contato conosco.
| Erro | TransactionCancelReason.DEVICE_STATE_FAILURE |
| Descrição | Device attestation has failed. |
| Causas | A atestação de segurança do dispositivo falhou durante a transação. Dispositivo com root, bootloader desbloqueado ou Google Play Services desatualizado. |
| Orientação | Verifique se o dispositivo possui certificação Google Play Protect. Atualize o Google Play Services e o sistema operacional. Certifique-se de que o dispositivo não está com root ativo. |
2038 — Sessão desativada durante a transação
Mensagem: Transação não concluída. Sessão desativada.
| Erro | TransactionCancelReason.SESSION_DEACTIVATED |
| Descrição | Session deactivated. |
| Causas | A sessão do terminal foi desativada durante o processamento da transação. Possível timeout de sessão ou desativação manual. |
| Orientação | Ative uma nova sessão e inicie a transação novamente. |
2039 — Horário do dispositivo incorreto
Mensagem: Transação não concluída. Ajuste a hora do dispositivo e tente novamente.
| Erro | TransactionCancelReason.TIME_CHECK_ERROR |
| Descrição | Device system time drifts beyond tolerance, correct device system and try again. |
| Causas | O relógio do dispositivo está fora do intervalo de tolerância aceito pelo servidor. Horário configurado manualmente ou fuso horário incorreto. |
| Orientação | Ative a opção Data e hora automáticas em Configurações > Sistema > Data e hora. Verifique se o fuso horário está correto e tente novamente. |
Erros detalhados de Terminal (Terminal Exception)
Quando os erros 2019, 2020, 2029 ou 2031 ocorrem, o kernel pode retornar um código de erro interno com detalhes adicionais. Inspecione o campo de mensagem do objeto de erro para identificar o código abaixo.
Tabela completa de Terminal Exception (códigos 1–21)
| Código | Erro | Descrição |
|---|---|---|
| 1 | TERMINAL_ALREADY_CREATED | createTerminal() should be only called once during the application lifecycle. |
| 2 | INVALID_TERMINAL_CONFIGURATION | Terminal EMV configuration could not be parsed. |
| 3 | NFC_ERROR | NFC error during Card Discovery. |
| 4 | TERMINAL_SESSION_DEACTIVATED | Transaction was attempted before terminal being activated. |
| 5 | PROCESSING_ALREADY_STARTED | A processing started on the active session before completion of the current processing. |
| 6 | ACTIVATION_ALREADY_STARTED | Multiple session activation commands sent. activateSession method executed while session still active. |
| 7 | NFC_NO_RUNTIME_PERMISSION | Manifest does not contain NFC permission. |
| 8 | NO_NFC_FEATURE | NFC system feature not included on device. |
| 9 | NFC_HARDWARE_NOT_AVAILABLE | The mobile has no built-in or attached NFC reader (default reader). |
| 10 | NFC_DISABLED | NFC needs to be enabled on the device, usually enabled via settings. |
| 11 | NFC_ALREADY_LISTENING | NFC adaptor already connected and listening. It might also happen that transaction is started twice. |
| 12 | INVALID_MERCHANT_ID | Invalid MerchantId format sent in activateSession(). |
| 13 | INVALID_RRN_FORMAT | Invalid RRN sent in startTransaction() parameters. |
| 14 | INVALID_CURRENCY_CODE | Invalid currency code is used. Ensure currency code follows the ISO 4217 standard. |
| 15 | DEVICE_STATE_FAILURE | The current execution environment is unsuitable for terminal activities. Local attestation failed. |
| 16 | HOSTAPP_ERROR_ON_UI_MESSAGE | Errors that are caught when calling back to the host app OnUiMessage. |
| 18 | ACTIVITY_NOT_AVAILABLE | Activity used to initiate transaction is unavailable (could be stopped for example), no visible activity is available. |
| 19 | TERMINAL_ALREADY_DISPOSED | Terminal instance is disposed or being disposed via terminalProvider.disposeTerminal method. |
| 20 | INVALID_SESSION_TIMEOUT | Session timeout is invalid to activate the session. |
| 21 | ACTIVATION_WHILE_TRANSACTION_IN_FLIGHT | Terminal.activateSession called while a transaction is in progress. |
Erros internos do Kernel (Internal Exception)
Estes são códigos de erro internos do kernel que podem acompanhar as exceções de terminal listadas acima. Diferente dos códigos de Terminal Exception, estes erros indicam falhas de baixo nível no processamento interno do SDK.
Estes códigos são úteis para diagnóstico avançado. Ao entrar em contato com o suporte Zoop, informe o código interno para agilizar a análise.
Tabela completa de Internal Exception (códigos 10003–10078)
| Código | Erro |
|---|---|
| 10003 | EXPECTED_PAYLOAD_MISSING |
| 10004 | NO_EMV_CONFIG_SET_CALLBACK |
| 10006 | ACTIVATE_CALLED_WHILE_SESSION_EXISTS |
| 10007 | SESSION_ALREADY_DISPOSED |
| 10008 | TERMINAL_PUBLIC_KEY_IS_MISSING |
| 10010 | MISSING_DISCOVERED_TAG |
| 10011 | UNKNOWN_CARD_SCHEME |
| 10012 | INVALID_OUTCOME |
| 10014 | UNSUPPORTED_CURRENCY_EXPONENT |
| 10015 | INVALID_TIMEOUT_STATE |
| 10016 | INVALID_AUTHORISATION_PAYLOAD |
| 10019 | INVALID_HEXADECIMAL_NUMBER |
| 10020 | INVALID_TAG_CLASS_TYPE |
| 10021 | INVALID_TAG_LABEL |
| 10022 | INVALID_TAG_VALUE |
| 10023 | INVALID_BER_TLV |
| 10025 | HTTP_NETWORK_ERROR |
| 10026 | HTTP_SERVER_ERROR |
| 10027 | HTTP_REQUEST_ERROR |
| 10028 | HTTP_RESPONSE_ERROR |
| 10029 | HTTP_OTHER_ERROR |
| 10030 | AUTHENTICATION_ERROR_ACCESS_TOKEN_NOT_PRESENT |
| 10031 | AUTHENTICATION_ERROR_ACCESS_TOKEN_EXPIRED |
| 10032 | AUTHENTICATION_ERROR_ACCESS_TOKEN_HTTP_ERROR |
| 10033 | AUTHENTICATION_ERROR_AUTHORIZATION_GRANT_NOT_PRESENT |
| 10034 | AUTHENTICATION_ERROR_ILLEGAL_IDENTITY_SERVICE_URL |
| 10036 | AUTHORISATION_ALREADY_IN_FLIGHT |
| 10037 | HTTP_UNEXPECTED_2xx_ERROR |
| 10038 | INVALID_BASE64_DECODING_ARG |
| 10041 | AUTHENTICATION_ERROR_MISSING_OID |
| 10042 | AUTHENTICATION_ERROR_INVALID_OID |
| 10043 | AUTHENTICATION_ERROR_MISSING_GROUPS |
| 10044 | AUTHENTICATION_ERROR_INVALID_GROUPS |
| 10045 | AUTHENTICATION_ERROR_MISSING_ROLES |
| 10046 | AUTHENTICATION_ERROR_INVALID_ROLES |
| 10047 | AUTHENTICATION_ERROR_TOKEN_PAYLOAD_PARSING_FAILED |
| 10048 | UNEXPECTED_EMV_OUTCOME |
| 10051 | ERROR_ON_UI_MESSAGE |
| 10052 | AUTHENTICATION_ERROR_ILLEGAL_SERVICE_URL |
| 10053 | TRANSACTION_FAILED |
| 10054 | TERMINAL_PROVIDER_INITIALISE_FAILED |
| 10055 | TERMINAL_PROVIDER_CREATE_TERMINAL_FAILED |
| 10056 | ANDROID_TERMINAL_ACTIVATE_SESSION_FAILED |
| 10057 | ANDROID_TERMINAL_SESSION_START_TRANSACTION_FAILED |
| 10058 | HTTP_NETWORK_RESPONSE_ERROR |
| 10059 | ATTESTATION_RESPONSE_ERROR |
| 10060 | ANDROID_TERMINAL_ACTIVATE_SESSION_TIMEOUT |
| 10061 | HTTP_NETWORK_GET_PURCHASE_RESULT_ERROR |
| 10062 | HTTP_NETWORK_GET_PAD_MATERIAL_RESPONSE_ERROR |
| 10063 | HTTP_NETWORK_GET_ENTROPY_ERROR |
| 10064 | HTTP_NETWORK_NEW_AGREEMENT_ERROR |
| 10065 | HTTP_NETWORK_INITIAL_AGREEMENT_ERROR |
| 10066 | HTTP_NETWORK_ROLL_AGREEMENT_ERROR |
| 10067 | HTTP_NETWORK_GET_NEW_TOKEN_ERROR |
| 10068 | HTTP_NETWORK_UPDATE_STATE_RECORD_ERROR |
| 10069 | HTTP_NETWORK_HANDLE_TRANSACTION_RESPONSE_ERROR |
| 10070 | ANDROID_GSM_PACKAGE_NOT_FOUND |
| 10071 | LOCAL_ATTESTATION_FAILED |
| 10072 | REMOTE_ATTESTATION_FAILED |
| 10073 | PIN_BYPASS_NOT_SUPPORTED |
| 10074 | MAIN_PROCESS_EXCEPTION_RESPONSE |
| 10075 | ISOLATED_PROCESS_DEAD_EXCEPTION |
| 10076 | CRITICAL_ATTESTATION_FAILURE_EXCEPTION |
| 10077 | INVALID_EMV_PAYLOAD_NO_PAN |
| 10078 | TERMINAL_MANUAL_INITIALISATION_MISUSE |
Erros de Backend Zoop (3xxx)
Estes erros são retornados pelo servidor da Zoop durante o fluxo de Pagamento. Indicam falhas de validação, autorização ou disponibilidade no backend.
3003 — Dados cadastrais inválidos
Mensagem: Vendedor ou Estabelecimento verifique os dados cadastrais. Entre em contato sua central de atendimento.
| Causas | Dados cadastrais do vendedor ou estabelecimento estão incompletos, incorretos ou não foram aprovados no backend da Zoop. |
| Orientação | Verifique os dados cadastrais do seller e do marketplace. Se estiverem corretos, entre em contato com o suporte Zoop para validação. |
3005 — Transação não autorizada pelo emissor
Mensagem: Transação não autorizada. Use outro cartão.
| Causas | O emissor do cartão recusou a transação. Possíveis motivos: cartão bloqueado, saldo insuficiente, limite excedido ou restrição do emissor. |
| Orientação | Solicite ao portador que utilize outro cartão ou entre em contato com o emissor para verificar a restrição. |
3012 — Erro interno no backend
Mensagem: Transação não autorizada. Por favor, contate o suporte para assistência.
| Causas | Falha interna no servidor da Zoop durante o processamento da transação. Possível indisponibilidade temporária do serviço. |
| Orientação | Colete os logs do SDK e entre em contato com o suporte Zoop informando o código 3012 para análise. |
3053 — Transação não permitida para este cartão
Mensagem: Transação não permitida para este cartão. Use outro cartão.
| Causas | O tipo de transação não é permitido para o cartão utilizado. O cartão pode ter restrições de uso (ex.: somente débito, somente crédito, ou bloqueio por categoria). |
| Orientação | Solicite ao portador que utilize outro cartão compatível com o tipo de transação. |
3091 — Serviço temporariamente indisponível
Mensagem: Serviço temporariamente indisponível.
| Causas | O serviço de processamento da Zoop está temporariamente indisponível. Possível manutenção programada ou sobrecarga no servidor. |
| Orientação | Aguarde alguns minutos e tente novamente. Se o problema persistir por mais de 15 minutos, entre em contato com o suporte Zoop. |
Erros de Adquirente (4xxx)
Estes erros são retornados pela adquirente durante o fluxo de Pagamento. Indicam recusas, restrições do cartão ou falhas de comunicação com o emissor.
4001 — Consultar emissor do cartão
Mensagem: Transação não concluída. Consulte o emissor do seu cartão.
| Causas | O emissor do cartão solicitou que o portador entre em contato antes de autorizar. |
| Orientação | Solicite ao portador que entre em contato com o emissor do cartão para liberar a transação. |
4003 — Dados cadastrais do estabelecimento
Mensagem: Vendedor ou Estabelecimento verifique os dados cadastrais. Entre em contato sua central de atendimento.
| Causas | Dados cadastrais do vendedor ou estabelecimento estão incompletos ou incorretos na adquirente. |
| Orientação | Verifique os dados cadastrais do seller e do marketplace. Se estiverem corretos, entre em contato com o suporte Zoop para validação. |
4005 — Transação não autorizada
Mensagem: Transação não autorizada. Use outro cartão.
| Causas | O emissor do cartão recusou a transação. Possíveis motivos: cartão bloqueado, saldo insuficiente, limite excedido ou restrição do emissor. |
| Orientação | Solicite ao portador que utilize outro cartão ou entre em contato com o emissor. |
4006 — Problema técnico na adquirente
Mensagem: Ocorreu um problema técnico. Tente novamente ou contate o suporte para assistência.
| Causas | Falha técnica na comunicação com a adquirente ou erro interno no processamento. |
| Orientação | Tente novamente. Se o erro persistir, entre em contato com o suporte Zoop. |
4009 — Transação em andamento
Mensagem: Transação está em andamento.
| Causas | Já existe uma transação sendo processada para este cartão ou terminal. Possível requisição duplicada. |
| Orientação | Aguarde a conclusão da transação em andamento antes de iniciar uma nova. |
4012 — Fechamento contábil em andamento
Mensagem: Transação não concluída. Processando fechamento contábil.
| Causas | A adquirente está processando o fechamento contábil e não aceita novas transações neste momento. |
| Orientação | Aguarde alguns minutos até o fechamento contábil ser concluído e tente novamente. |
4013 — Valor não permitido
Mensagem: Valor da transação não permitido. Tente novamente.
| Causas | O valor informado na transação não é permitido pela adquirente. Pode estar abaixo do mínimo ou acima do máximo aceito. |
| Orientação | Verifique os limites de valor aceitos e ajuste o valor da transação. |
4014 — Cartão inválido
Mensagem: Cartão não é válido. Use outro cartão.
| Causas | O número do cartão é inválido ou o cartão não é reconhecido pela adquirente. |
| Orientação | Solicite ao portador que utilize outro cartão válido. |
4015 — Instituição não encontrada
Mensagem: Transação não concluída. Não foi possível encontrar informações sobre a Instituição.
| Causas | A instituição financeira do cartão não foi identificada pela adquirente. |
| Orientação | Solicite ao portador que utilize outro cartão. Se o problema persistir, entre em contato com o suporte Zoop. |
4019 — Refazer a transação
Mensagem: Refaça a transação.
| Causas | Falha temporária no processamento. A adquirente solicita que a transação seja refeita. |
| Orientação | Inicie uma nova transação. |
4021 — Transação não permitida para este cartão
Mensagem: Transação não permitida para este cartão. Use outro cartão.
| Causas | O tipo de transação não é permitido para o cartão utilizado. Restrição por categoria, tipo de conta ou configuração do emissor. |
| Orientação | Solicite ao portador que utilize outro cartão compatível com o tipo de transação. |
4022 — Contatar central do cartão
Mensagem: Entre em contato com a central do seu cartão.
| Causas | O emissor do cartão requer que o portador entre em contato com a central antes de autorizar. |
| Orientação | Solicite ao portador que entre em contato com a central do cartão para liberar a transação. |
4023 — Senha inválida
Mensagem: Senha inválida. Tente novamente.
| Causas | A senha (PIN) digitada pelo portador está incorreta. |
| Orientação | Solicite ao portador que digite a senha correta e tente novamente. |
4024 — Contatar central do cartão
Mensagem: Entre em contato com a central do seu cartão.
| Causas | O emissor do cartão requer contato do portador antes de autorizar esta transação. |
| Orientação | Solicite ao portador que entre em contato com a central do cartão. |
4030 — Problema técnico (suporte necessário)
Mensagem: Ocorreu um problema técnico. Por favor, contate o suporte para assistência.
| Causas | Erro técnico no processamento da transação pela adquirente. |
| Orientação | Colete os logs do SDK e entre em contato com o suporte Zoop informando o código 4030. |
4031 — Banco não faz parte da adquirente
Mensagem: Transação não concluída. Este banco não faz parte da adquirente.
| Causas | O banco emissor do cartão não possui convênio com a adquirente utilizada. |
| Orientação | Solicite ao portador que utilize outro cartão de um banco aceito pela adquirente. |
4038 — Tentativas de senha excedidas
Mensagem: Número de tentativas de senha excedido.
| Causas | O portador excedeu o número máximo de tentativas de senha permitido pelo emissor. O cartão pode ter sido bloqueado. |
| Orientação | Solicite ao portador que entre em contato com o emissor para desbloquear o cartão. Utilize outro cartão. |
4041 — Cartão extraviado
Mensagem: Transação não concluída. Cartão extraviado.
| Causas | O cartão foi registrado como extraviado junto ao emissor. |
| Orientação | A transação não pode ser processada com este cartão. Utilize outro cartão. |
4043 — Cartão roubado
Mensagem: Transação não concluída. Cartão roubado.
| Causas | O cartão foi registrado como roubado junto ao emissor. |
| Orientação | A transação não pode ser processada com este cartão. Utilize outro cartão. |
4051 — Saldo insuficiente
Mensagem: Transação não concluída. Saldo insuficiente na conta.
| Causas | O saldo disponível na conta do portador é insuficiente para cobrir o valor da transação. |
| Orientação | Solicite ao portador que utilize outro cartão ou meio de pagamento. |
4052 — Conta corrente não cadastrada
Mensagem: Conta corrente não cadastrada para transações. Atualize os dados.
| Causas | A conta corrente vinculada ao cartão não está habilitada para transações de pagamento. |
| Orientação | Solicite ao portador que entre em contato com o emissor para atualizar os dados da conta. |
4053 — Transação não permitida para este cartão
Mensagem: Transação não permitida para este cartão. Use outro cartão.
| Causas | O cartão possui restrições que impedem este tipo de transação. |
| Orientação | Solicite ao portador que utilize outro cartão compatível. |
4054 — Cartão vencido
Mensagem: Transação não concluída. Cartão do cliente está vencido.
| Causas | A data de validade do cartão expirou. |
| Orientação | Solicite ao portador que utilize um cartão válido. |
4055 — Senha incorreta
Mensagem: Transação não concluída. Senha digitada está incorreta.
| Causas | A senha (PIN) digitada pelo portador não confere com a registrada no emissor. |
| Orientação | Solicite ao portador que digite a senha correta. Atenção ao número restante de tentativas antes do bloqueio. |
4056 — Cartão sem registro
Mensagem: Transação não concluída. Cartão sem registro.
| Causas | O cartão não está registrado na base da adquirente ou do emissor. |
| Orientação | Solicite ao portador que utilize outro cartão. |
4057 — Transação não permitida para este cliente
Mensagem: Transação não permitida para esse cliente. Use outro cartão.
| Causas | O perfil do portador possui restrições que impedem a realização desta transação. |
| Orientação | Solicite ao portador que utilize outro cartão ou entre em contato com o emissor. |
4058 — Transação não autorizada
Mensagem: Transação não autorizada.
| Causas | A adquirente recusou a transação sem motivo específico. |
| Orientação | Tente novamente com outro cartão. Se o erro persistir, entre em contato com o suporte Zoop. |
4060 — Autorização necessária por telefone
Mensagem: Transação não autorizada. Ligue para obter autorização.
| Causas | A transação requer autorização verbal do portador junto ao emissor. |
| Orientação | Solicite ao portador que entre em contato com o emissor para autorizar a transação por telefone. |
4061 — Limite de saque excedido
Mensagem: Transação não autorizada. Limite de saque excedido.
| Causas | O portador excedeu o limite de saque permitido pelo emissor para o período. |
| Orientação | Solicite ao portador que utilize outro cartão ou aguarde o próximo período de limite. |
4073 — Timeout na finalização da transação
Mensagem: Excedido o limite de tempo para finalizar a transação. Tente novamente.
| Causas | O tempo de resposta da adquirente ou do emissor excedeu o limite permitido. Conexão lenta ou instável. |
| Orientação | Verifique a conexão de internet e tente novamente. |
4075 — Tentativas de senha excedidas
Mensagem: Excedido o número permitido de tentativas de transações com senha.
| Causas | O número máximo de tentativas de transações com senha foi excedido. |
| Orientação | Solicite ao portador que entre em contato com o emissor para desbloquear. Utilize outro cartão se necessário. |
4076 — Conta de destino inválida
Mensagem: Transação não autorizada. Conta de destino especificada inválida.
| Causas | A conta de destino especificada na transação é inválida ou inexistente. |
| Orientação | Verifique os dados da conta de destino e tente novamente. |
4077 — Conta do titular não especificada
Mensagem: Transação não autorizada. Conta do Titular do cartão não especificado.
| Causas | A conta do titular do cartão não foi informada na transação. |
| Orientação | Verifique os parâmetros da transação e tente novamente. |
4078 — Conta especificada inválida
Mensagem: Transação não autorizada. Conta especificada inválida.
| Causas | A conta especificada na transação não é válida ou não existe. |
| Orientação | Verifique os dados da conta e tente novamente. |
4079 — Transação não permitida neste ciclo
Mensagem: Transação não permitida neste ciclo. Tente novamente mais tarde.
| Causas | O ciclo atual do cartão ou da conta não permite este tipo de transação. Restrição temporal do emissor. |
| Orientação | Aguarde o próximo ciclo e tente novamente, ou utilize outro cartão. |
4080 — Transação não encontrada na adquirente
Mensagem: A transação não consta na base de dados da adquirente.
| Causas | A transação referenciada não foi encontrada na base de dados da adquirente. Possível referência inválida ou expirada. |
| Orientação | Verifique os dados da transação. Se o problema persistir, entre em contato com o suporte Zoop. |
4081 — Transação estornada
Mensagem: A transação foi estornada.
| Causas | A transação já foi estornada anteriormente. |
| Orientação | Nenhuma ação necessária. A transação já foi revertida. |
4082 — Problema na criptografia
Mensagem: Transação não concluída. Problema na criptografia da transação.
| Causas | Falha na criptografia dos dados da transação. Possível incompatibilidade de chaves ou certificados. |
| Orientação | Tente novamente. Se o erro persistir, colete os logs e entre em contato com o suporte Zoop. |
4083 — Timeout na transação
Mensagem: Excedido o limite de tempo para finalizar a transação. Tente novamente.
| Causas | O tempo de resposta da adquirente excedeu o limite permitido. Conexão lenta ou instável. |
| Orientação | Verifique a conexão de internet e tente novamente. |
4084 — Ciclo de autorização inválido
Mensagem: Ciclo de autorização inválido.
| Causas | O ciclo de autorização utilizado na transação é inválido ou não reconhecido pela adquirente. |
| Orientação | Tente novamente. Se o erro persistir, entre em contato com o suporte Zoop. |
4086 — Transação desfeita
Mensagem: A transação foi desfeita.
| Causas | A transação foi desfeita (void) antes da finalização. |
| Orientação | Nenhuma ação necessária. Inicie uma nova transação se for o caso. |
4090 — Fechamento contábil em andamento
Mensagem: Transação não concluída. Processando fechamento contábil.
| Causas | A adquirente está processando o fechamento contábil e não aceita novas transações neste momento. |
| Orientação | Aguarde alguns minutos até o fechamento contábil ser concluído e tente novamente. |
4091 — Falha de comunicação
Mensagem: Transação não concluída. Falha de comunicação. Tente novamente mais tarde.
| Causas | Falha na comunicação entre a adquirente e o emissor. Rede instável ou serviço temporariamente indisponível. |
| Orientação | Aguarde alguns minutos e tente novamente. Se o problema persistir, entre em contato com o suporte Zoop. |
4096 — Problema técnico (suporte necessário)
Mensagem: Ocorreu um problema técnico. Por favor, contate o suporte para assistência.
| Causas | Erro técnico no processamento da transação que requer análise. |
| Orientação | Colete os logs do SDK e entre em contato com o suporte Zoop informando o código 4096. |
4101 — Problemas no cartão
Mensagem: Transação não concluída. Problemas no cartão, entre em contato com o emissor.
| Causas | O cartão apresentou problemas durante o processamento. O emissor precisa ser consultado. |
| Orientação | Solicite ao portador que entre em contato com o emissor do cartão. |
4102 — Situação do estabelecimento com o emissor
Mensagem: Transação não concluída. Vendedor ou Estabelecimento verifique sua situação com o Banco emissor.
| Causas | O estabelecimento possui pendências ou restrições junto ao banco emissor que impedem a conclusão da transação. |
| Orientação | Verifique a situação do estabelecimento junto ao banco emissor. Entre em contato com o suporte Zoop se necessário. |
4103 — Transação não autorizada
Mensagem: Transação não autorizada.
| Causas | A adquirente recusou a transação sem motivo específico detalhado. |
| Orientação | Tente novamente com outro cartão. Se o erro persistir, entre em contato com o suporte Zoop. |
4104 — Transação não autorizada
Mensagem: Transação não autorizada.
| Causas | A adquirente recusou a transação sem motivo específico detalhado. |
| Orientação | Tente novamente com outro cartão. Se o erro persistir, entre em contato com o suporte Zoop. |
4105 — Transação não autorizada
Mensagem: Transação não autorizada.
| Causas | A adquirente recusou a transação sem motivo específico detalhado. |
| Orientação | Tente novamente com outro cartão. Se o erro persistir, entre em contato com o suporte Zoop. |
4106 — Falha na transação
Mensagem: Transação não concluída. Tente novamente.
| Causas | Falha genérica na transação junto à adquirente. Possível erro temporário. |
| Orientação | Tente novamente. Se o erro persistir, colete os logs e entre em contato com o suporte Zoop. |
4107 — Transação não autorizada
Mensagem: Transação não autorizada.
| Causas | A adquirente recusou a transação sem motivo específico detalhado. |
| Orientação | Tente novamente com outro cartão. Se o erro persistir, entre em contato com o suporte Zoop. |
4108 — Valor não permitido para este cartão
Mensagem: Transação não autorizada. Valor não permitido para este tipo de cartão.
| Causas | O valor da transação excede o limite aceito para o tipo de cartão utilizado (ex.: cartão pré-pago, cartão básico). |
| Orientação | Reduza o valor da transação ou solicite ao portador que utilize outro cartão. |
4109 — Transação não autorizada
Mensagem: Transação não autorizada. Use outro cartão.
| Causas | A adquirente recusou a transação. Restrição associada ao cartão utilizado. |
| Orientação | Solicite ao portador que utilize outro cartão. |
4110 — Transação não autorizada
Mensagem: Transação não autorizada. Use outro cartão.
| Causas | A adquirente recusou a transação. Restrição associada ao cartão utilizado. |
| Orientação | Solicite ao portador que utilize outro cartão. |
Precisa de ajuda?
Se o erro persistir após seguir as orientações acima, entre em contato com o suporte:
📞 Telefone (segunda a sexta, 9h às 19h)
- Capitais: 4003-3261
- Demais regiões: 0800 878 8161
✉️ E-mail
Updated about 4 hours ago