8 - 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, 1023, 1024 |
| Pagamento | 1000, 1005, 1007–1011, 1019–1022, 1025–1027 |
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.
| Erro | PluginConstants.ERROR_MERCHANT_ID |
| Descrição | Not provided MyPinPad merchant id |
| 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.
| Erro | PluginConstants.ERROR_INVALID_RESPONSE_SESSION_ACTIVATION |
| Descrição | Invalid response to session activation |
| 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.
| Erro | PluginConstants.ERROR_NO_TERMINAL_PROVIDED |
| Descrição | No terminal instance provided |
| 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.
| Erro | PluginConstants.ERROR_TIMEOUT_MPP_ACTIVATION |
| Descrição | Timed out on MyPinPad terminal activation |
| 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.
| Erro | PluginConstants.ERROR_NO_ZOOP_TERMINAL_ID |
| Descrição | No exists zoop terminal id |
| 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 Kernel SDK
Mensagem: Tempo esgotado na inicialização do Kernel SDK.
| Erro | PluginConstants.ERROR_TIMEOUT_MPP_INITIALIZATION |
| Descrição | Timed out on Kernel SDK initialization |
| Causas | A inicialização do Kernel SDK excedeu o tempo limite permitido. Conexão lenta, recursos insuficientes ou serviço temporariamente indisponível. |
| Orientação | Feche outros aplicativos, verifique a conexão e tente novamente. |
1013 — Problema na ativação
Mensagem: Credenciais inválidas. Verifique marketplace, seller e accessKey.
| Erro | PluginConstants.ERROR_CREATING_ZOOP_TERMINAL |
| Descrição | Cannot create terminal on Zoop |
| Causas | Falha interna no SDK durante a ativação do terminal. |
| Orientação | Verifique se as credenciais informadas (marketplace, seller e accessKey) estão corretas. Caso o problema persista, entre em contato com o suporte para análise e validação das configurações. |
1014 — Problema técnico (suporte necessário)
Mensagem: Ocorreu um problema técnico. Por favor, contate o suporte para assistência.
| Erro | PluginConstants.ERROR_NO_MPP_SCOPE |
| Descrição | Not provided MyPinPad identity scope |
| 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. |
1015 — Problema técnico (suporte necessário)
Mensagem: Ocorreu um problema técnico. Por favor, contate o suporte para assistência.
| Erro | PluginConstants.ERROR_NO_MPP_CLIENT_ID |
| Descrição | Not provided MyPinPad identity client id |
| 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: Falha ao registar o terminal na Zoop. Verifique credenciais e rede e execute initialize de novo.
| Erro | PluginConstants.ERROR_NO_MPP_SECRET |
| Descrição | Not provided MyPinPad identity client secret |
| Causas | O client secret não foi passado ao chamar o SDK. |
| Orientação | Verifique se as credenciais informadas (client secret) estão corretas. Caso o problema persista, entre em contato com o suporte para análise e validação das configurações. |
1017 — Problema técnico (suporte necessário)
Mensagem: Não foi possível preparar o terminal de pagamento. Tente de novo ou contacte o suporte.
| Erro | PluginConstants.ERROR_INVALID_RESPONSE_TERMINAL_CREATION |
| Descrição | Invalid response to terminal creation |
| 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.
| Erro | PluginConstants.ERROR_TIMEOUT_MPP_CREATION |
| Descrição | Timed out on MyPinPad terminal creation |
| 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. |
1023 — Seller não informado na inicialização em modo multiseller
Mensagem: seller not provided on initialization.
| Erro | PluginConstants.ERROR_SELLER_NOT_PROVIDED_ON_INIT |
| Descrição | Seller not provided on initialization |
| Causas | O método initialize foi chamado sem informar o seller em uma configuração multiseller. |
| Orientação | Informe o identificador do seller ao chamar o método initialize quando operar em modo multiseller. |
1024 — Tentativa de alterar o seller no initialize
Mensagem: seller cannot be changed in initialize when already set in setConfig.
| Erro | PluginConstants.ERROR_SELLER_NOT_ALLOWED_IN_INITIALIZE |
| Descrição | Seller cannot be changed in initialize when already set in setConfig |
| Causas | O método initialize foi chamado com um seller diferente do já definido no setConfig. |
| Orientação | Não informe o seller no initialize se ele já foi definido no setConfig. Para alterar o seller, atualize-o no setConfig. |
Sessão
1002 — Falha na ativação da sessão
Mensagem: Transação não concluída. Tente novamente.
| Erro | PluginConstants.ERROR_INVALID_RESPONSE_SESSION_ACTIVATION |
| Descrição | Invalid response to session activation |
| Causas | Falha temporária durante o processo de ativação da sessão. |
| Orientação | Tente novamente. Se o erro persistir, verifique a conectividade e reinicie a aplicação. |
Pagamento
1000 — Terminal não inicializado
Mensagem: Terminal não inicializado. Execute initialize com sucesso antes de pagar ou ativar a sessão.
| Erro | PluginConstants.ERROR_NOT_INITIALIZED |
| Descrição | TapOnPhone not initialized. Should call initialize() with success first |
| 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.
| Erro | PluginConstants.ERROR_ABORTING_PAYMENT |
| Descrição | Aborting payment because session expired |
| 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.
| Erro | PluginConstants.ERROR_PARSING_ADDITIONAL_DATA |
| Descrição | Error to parse json into incoming additional data |
| 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.
| Erro | PluginConstants.ERROR_NO_SESSION_ACTIVE |
| Descrição | No session active |
| 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.
| Erro | PluginConstants.ERROR_TIMEOUT_TAP_PAYMENT |
| Descrição | Timed out on tap-on-phone's payment |
| 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.
| Erro | PluginConstants.ERROR_NO_TRANSACTION_ID |
| Descrição | Cannot confirm transaction because there is no transaction id |
| Causas | Falha 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.
| Erro | PluginConstants.ERROR_TO_CONFIRM_TRANSACTION |
| Descrição | Error to confirm transaction |
| 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: Valor da transação acima do limite máximo permitido.
| Erro | PluginConstants.ERROR_TRANSACTION_AMOUNT_EXCEEDED |
| Descrição | Transaction amount exceeded |
| 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. |
1020 — Plano de cobrança inválido
Mensagem: Plano de cobrança inválido. O identificador (planId) deve ter entre 1 e 52 caracteres.
| Erro | PluginConstants.ERROR_INVALID_BILLING_PLAN_ID |
| Descrição | Invalid planId (must have between 1 and 52 characters) |
| Causas | Foi enviado PaymentRequest.billing com planId vazio ou com mais de 52 caracteres. A validação ocorre em TapOnPhoneCore.validateRequest() antes do processamento do pagamento. |
| Orientação | Informe um planId não vazio, com até 52 caracteres, em Billing. Se o erro persistir, verifique os logs do SDK e entre em contato com o suporte Zoop. |
1021 — Valor de cobrança inválido
Mensagem: Valor de cobrança inválido. Informe um valor maior ou igual a zero.
| Erro | PluginConstants.ERROR_INVALID_BILLING_AMOUNT |
| Descrição | Invalid billing amount (must be non-negative) |
| Causas | Foi enviado PaymentRequest.billing com value negativo (centavos). A validação ocorre em TapOnPhoneCore.validateRequest() antes do processamento do pagamento. |
| Orientação | Use billing.value maior ou igual a zero. Se o erro persistir, verifique os logs do SDK e entre em contato com o suporte Zoop. |
1022 — Tap to Pay não está pronto
Mensagem: Tap to Pay não está pronto. Aguarde um instante e tente novamente.
| Erro | PluginConstants.ERROR_TAP_TO_PAY_NOT_READY |
| Descrição | TapToPay is not ready yet |
| Causas | A TapOnPhoneActivity não ficou pronta a tempo (waitForActivityToBeReady()), ou a activity não está ativa/visível quando o fluxo MyPinPad inicia a transação. Pode ocorrer em pay / payByGateway ou durante o arranque da transação no driver. |
| Orientação | Garanta que a tela integrada do SDK está em primeiro plano e totalmente exibida antes de concluir o arranque do pagamento. Evite minimizar o app ou sobrepor outras janelas sobre o PIN. Se o erro persistir, verifique os logs do SDK e entre em contato com o suporte Zoop. |
1025 — Transação cancelada pelo botão fechar
Mensagem: Transação cancelada pelo botão fechar. Tente novamente.
| Erro | PluginConstants.ERROR_USER_CANCELLED_TRANSACTION |
| Descrição | Transaction cancelled by user (close button) |
| Causas | O usuário encerrou a transação ao tocar no botão X (fechar) na tela de pagamento do SDK. |
| Orientação | Informe ao usuário que a transação foi cancelada e permita iniciar um novo pagamento. |
1026 — Transação cancelada pelo botão voltar
Mensagem: Transação cancelada pelo botão voltar. Tente novamente.
| Erro | PluginConstants.ERROR_USER_BACK_PRESSED_TRANSACTION |
| Descrição | Transaction cancelled by user (back button) |
| Causas | O usuário encerrou a transação ao pressionar o botão voltar do sistema ou da interface durante o fluxo de pagamento. |
| Orientação | Informe ao usuário que a transação foi cancelada e permita iniciar um novo pagamento. |
O fluxo de back/cancelamento é 100% interno ao SDK. Não intercepte o botão voltar nem sobrescreva as activities do SDK (fora do contrato).
1027 — O valor do pagamento deve ser maior que zero
Mensagem: O valor do pagamento deve ser maior que zero.
| Campo | Conteúdo |
|---|---|
| Erro | PluginConstants.ERROR_INVALID_PAYMENT_AMOUNT |
| Descrição | payment amount must be greater than zero |
| Causas | O valor informado em PaymentRequest.amount (em pay / payByGateway) ou em PixRequest.amount (em payByPix) é menor ou igual a zero (<= 0 centavos). A validação ocorre antes do fluxo de pagamento ser iniciado. |
| Orientação | Garanta que o valor da transação seja informado em centavos e seja maior que zero (ex.: R$ 10,00 = 1000). Trate o onError com ErrorType.Payment ou ErrorType.Pix, conforme o método chamado, e exiba a mensagem ao usuário para que informe um valor válido. |
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, 2040 |
| Criação de Sessão | 2023–2029, 2035 |
| Transação | 2001–2022, 2036–2039, 2042–2044, 2046 |
| Erros detalhados de Terminal | Códigos 1–24 |
| Erros internos do Kernel | Códigos 1110–52031 |
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) |
| 3.x 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. |
2040 — Timeout na criação do terminal no kernel
Mensagem: Creating terminal timed out. Terminal creation exceeded the allowed time limit.
| Erro | TerminalCreationFailureCause.TERMINAL_CREATION_TIMEOUT |
| Descrição | Creating terminal timed out. MyPinPad terminal creation exceeded the allowed time limit. |
| Causas | O processo de criação do terminal excedeu o tempo limite permitido. Conexão lenta, recursos do dispositivo insuficientes ou serviço temporariamente indisponível. |
| Orientação | Verifique a qualidade da conexão de internet e os recursos disponíveis no dispositivo. Reinicie o aplicativo e tente novamente. |
2045 - Falha na conexão do leitor de cartão
Mensagem: Falha na conexão do leitor de cartão ao preparar o terminal. Tente novamente.
| Erro | TerminalCreationFailureCause.READER_CONNECTION_FAILURE |
| Descrição | Card reader connection failed while preparing the terminal. |
| Causas | Falha na comunicação com o leitor de cartão (NFC) durante a preparação do terminal. |
| Orientação | Tente novamente. Verifique se o NFC está ativo e sem obstruções. Se persistir, entre em contato com o suporte Zoop. |
2047 - Configuração do leitor de cartão inválida
Mensagem: Configuração do leitor de cartão inválida ao preparar o terminal.
| Erro | TerminalCreationFailureCause.READER_CONFIGURATION_ERROR |
| Descrição | Card reader configuration is invalid while preparing the terminal. |
| Causas | Configuração do leitor de cartão inválida ou incompatível com o terminal. |
| Orientação | Tente novamente. Se persistir, colete os logs do SDK e entre em contato com o suporte Zoop. |
2048 - Acesso à internet indisponível
Mensagem: Não foi possível prosseguir porque não há acesso à internet.
| Erro | TerminalCreationFailureCause.NO_INTERNET_ACCESS |
| Descrição | Could not proceed because internet access is unavailable. |
| Causas | Dispositivo sem conexão com a internet (Wi-Fi ou dados móveis desativados) ou rede instável. |
| Orientação | Verifique a conexão de internet e tente novamente. |
2049 - Permissão de localização ausente
Mensagem: Permissão de localização é necessária antes de preparar o terminal.
| Erro | TerminalCreationFailureCause.LOCATION_PERMISSION_MISSING |
| Descrição | Location permission is required before preparing the terminal. |
| Causas | O aplicativo não possui a permissão de localização necessária para preparar o terminal. |
| Orientação | Conceda a permissão de localização ao aplicativo e tente novamente. |
2050 - Localização desabilitada
Mensagem: A localização do dispositivo deve estar habilitada antes de preparar o terminal.
| Erro | TerminalCreationFailureCause.LOCATION_DISABLED |
| Descrição | Device location must be enabled before preparing the terminal. |
| Causas | A localização do dispositivo está desabilitada nas configurações do sistema. |
| Orientação | Habilite a localização do dispositivo e tente novamente. |
2061 - Terminal ainda não inicializado
Mensagem: O terminal ainda não foi inicializado. Tente novamente.
| Erro | TerminalCreationFailureCause.TERMINAL_NOT_INITIALISED_YET |
| Descrição | Terminal SDK getReady was called before terminal initialisation completed. |
| Causas | O fluxo de pagamento foi iniciado antes da conclusão da inicialização do terminal. |
| Orientação | Aguarde a conclusão do initialize antes de iniciar o pagamento. Se persistir, reinicie o aplicativo e tente novamente. |
2062 - Permissão do leitor de cartão necessária
Mensagem: Permissão de leitor de cartão necessária para preparar o terminal.
| Erro | TerminalCreationFailureCause.READER_PERMISSION_REQUIRED |
| Descrição | Card reader permission is required before preparing the terminal. |
| Causas | O aplicativo não possui a permissão de acesso ao leitor de cartão (NFC). |
| Orientação | Verifique as permissões do aplicativo e conceda o acesso ao leitor de cartão. Tente novamente. |
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. |
2048 - Acesso à internet indisponível
Mensagem: Não foi possível prosseguir porque não há acesso à internet.
| Erro | SessionActivationFailureCause.NO_INTERNET_ACCESS |
| Descrição | Could not proceed because internet access is unavailable. |
| Causas | Dispositivo sem conexão com a internet ou rede instável durante a ativação da sessão. |
| Orientação | Verifique a conexão de internet e tente novamente. |
2069 - Configuração EMV indisponível
Mensagem: Falha na ativação porque nenhuma configuração EMV está disponível.
| Erro | SessionActivationFailureCause.NO_EMV_CONFIG_AVAILABLE |
| Descrição | Activation failed because no EMV configuration is available. |
| Causas | Nenhuma configuração EMV disponível para a ativação da sessão. |
| Orientação | Tente novamente. Se persistir, colete os logs do SDK e entre em contato com o suporte Zoop. |
2070 - Leitor de cartão desconectado
Mensagem: Falha na ativação porque o leitor de cartão foi desconectado.
| Erro | SessionActivationFailureCause.CARD_READER_DISCONNECTED |
| Descrição | Activation failed because the card reader was disconnected. |
| Causas | O leitor de cartão (NFC) foi desconectado durante a ativação da sessão. |
| Orientação | Verifique o leitor de cartão e tente novamente. |
2071 - Permissão de localização ausente
Mensagem: Permissão de localização é necessária antes da ativação da sessão.
| Erro | SessionActivationFailureCause.LOCATION_PERMISSION_MISSING |
| Descrição | Location permission is required before session activation. |
| Causas | O aplicativo não possui a permissão de localização necessária para ativar a sessão. |
| Orientação | Conceda a permissão de localização ao aplicativo e tente novamente. |
2072 - Localização desabilitada
Mensagem: A localização do dispositivo deve estar habilitada antes da ativação da sessão.
| Erro | SessionActivationFailureCause.LOCATION_DISABLED |
| Descrição | Device location must be enabled before session activation. |
| Causas | A localização do dispositivo está desabilitada nas configurações do sistema. |
| Orientação | Habilite a localização do dispositivo e tente novamente. |
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. |
| Orientação | Esse código é retornado quando o usuário clica no botão fechar na tela de aproximar o cartão, é emitido o evento CloseBuiltInScreen |
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. |
2044 — Falha na ativação da sessão (processo isolado)
Mensagem: Não foi possível ativar a sessão do terminal. Feche outros aplicativos, reinicie o app e tente novamente. Se persistir, reinicie o dispositivo.
| Erro | SessionActivationFailureCause.ISOLATED_PROCESS_EXCEPTION |
| Descrição | Isolated process being killed by system due to low memory or other reasons. |
| Causas | O processo isolado do Terminal SDK foi encerrado pelo Android (por exemplo, pouca memória RAM, otimização de bateria ou outro motivo do sistema), impedindo a ativação da sessão do terminal. |
| Orientação | Peça ao usuário que feche outros aplicativos, reinicie o app de pagamento e tente novamente; se persistir, reinicie o dispositivo. Este código não indica problema de cartão — para incompatibilidade de aplicação no cartão, use o código 2036. |
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. |
2046 — Falha ao preparar o terminal (processo isolado)
Mensagem: Não foi possível preparar o terminal de pagamento (processo isolado encerrado pelo sistema, por exemplo por memória). Feche outros aplicativos e tente novamente.
| Erro | TerminalCreationFailureCause.ISOLATED_PROCESS_EXCEPTION |
| Descrição | Isolated process being killed by system due to low memory or other reasons. |
| Causas | Durante a **criação do terminal** seguro, o Android encerrou o **processo isolado** usado pelo Terminal SDK (por exemplo pouca memória RAM, otimização de bateria ou outro motivo do sistema). O terminal de pagamento não chegou a ficar disponível. **Não** confundir com o código **2036** (mesmo tipo de falha na **ativação de sessão**) nem com o **2037** (falha de **atestação/dispositivo durante a transação**). |
| Orientação | Peça para fechar outros aplicativos, tentar de novo e, se necessário, reiniciar o app de pagamento ou o dispositivo. Garantir espaço livre de memória e evitar picos de uso de CPU/memória no momento da primeira criação do terminal. Se o problema persistir, tratar como incidente técnico (não como recusa de cartão). |
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. |
2041 - TAG NFC não suportada
Mensagem: Tag NFC não suportada detectada.
| Erro | TransactionErrorCause.UNSUPPORTED_NFC_TAG |
| Descrição | Unsupported NFC tag detected. |
| Causas | Foi aproximada no campo NFC uma tag/cartão que o kernel não suporta. Tente outro cartão |
| Orientação | Tente outro cartão. |
2042 — Terminal descartado (dispose)
Mensagem: Terminal dispose. Create a new terminal.
| Erro | TransactionCancelReason.TERMINAL_DISPOSED |
| Descrição | Terminal dispose. Create a new terminal. |
| Causas | O terminal foi descartado (dispose) durante a operação — tipicamente porque o processo isolado do kernel foi reiniciado pelo sistema operacional. |
| Orientação | Crie um novo terminal (nova inicialização) e inicie a transação novamente. |
2043 — Erro NFC na descoberta do cartão
Mensagem: O adaptador NFC não está pronto para aceitar cartões ou ocorreu falha na descoberta do cartão. Tente novamente.
| Erro | TransactionCancelReason.NFC_ERROR |
| Descrição | NFC adapter is not ready for accepting cards. |
| Causas | O Terminal SDK (MyPinPad) reportou falha NFC durante a descoberta do cartão: adaptador NFC indisponível ou não pronto, interferência na leitura, ou condição do dispositivo que impede o discovery (incluindo uso simultâneo do NFC por outra app, em alguns cenários). |
| Orientação | Confirme que o NFC está ligado, que não há outra app a monopolizar o leitor e que o cartão é aproximado de forma estável. Feche apps desnecessárias, reinicie o aplicativo e tente novamente. Se o erro persistir, registe o code e os logs do SDK e contacte o suporte Zoop. |
2037 - Falha na atestação do dispositivo
Mensagem: Falha na validação do seu dispositivo. Tente novamente. Para suporte, entre em contato conosco.
| Erro | TransactionErrorCause.DEVICE_STATE_FAILURE |
| Descrição | Device attestation has failed |
| 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 e se o sistema está atualizado. Tente novamente. |
2048 - Acesso à internet indisponível
Mensagem: Não foi possível prosseguir porque não há acesso à internet.
| Erro | TransactionErrorCause.NO_INTERNET_ACCESS |
| Descrição | Could not proceed because internet access is unavailable. |
| Causas | Dispositivo sem conexão com a internet durante o processamento da transação. |
| Orientação | Verifique a conexão de internet e tente novamente. |
2051 - Terminal não está pronto
Mensagem: Terminal não está pronto para transações. Prepare o terminal novamente.
| Erro | TransactionCancelReason.TERMINAL_NOT_READY |
| Descrição | Terminal is not ready for transactions. Prepare the terminal again. |
| Causas | O terminal não está pronto para processar transações no momento. |
| Orientação | Prepare o terminal novamente e tente uma nova transação. |
2052 - Leitor de cartão desconectado
Mensagem: Leitor de cartão desconectado durante o processamento da transação.
| Erro | TransactionCancelReason.CARD_READER_DISCONNECTED |
| Descrição | Card reader disconnected during transaction processing. |
| Causas | O leitor de cartão (NFC) foi desconectado durante a transação. |
| Orientação | Verifique o leitor de cartão e tente uma nova transação. |
2053 - Falha na leitura do cartão
Mensagem: Falha na leitura do cartão durante a transação (por exemplo, erro de comunicação NFC ou exceção de I/O).
| Erro | TransactionCancelReason.CARD_READ_FAILURE |
| Descrição | Card read failure (for example NFC communication error or I/O exception). |
| Causas | Cartão saiu do campo NFC durante a leitura, cartão danificado/incompatível ou interferência de sinal. |
| Orientação | Oriente o portador a manter o cartão parado sobre a antena até concluir a leitura. Se persistir, tente outro cartão. |
2054 - Falha no processo isolado
Mensagem: Falha no processo isolado durante o processamento da transação.
| Erro | TransactionCancelReason.ISOLATED_PROCESS_EXCEPTION |
| Descrição | Isolated process failed during transaction processing. |
| Causas | O processo isolado do kernel foi encerrado pelo sistema (memória insuficiente ou app em segundo plano). |
| Orientação | Feche outros aplicativos e tente uma nova transação. |
2055 - Terminal desativado
Mensagem: Terminal desativado durante o processamento da transação.
| Erro | TransactionErrorCause.DEACTIVATED |
| Descrição | Terminal was deactivated during transaction processing. |
| Causas | O terminal foi desativado durante o processamento da transação. |
| Orientação | Tente uma nova transação. Se persistir, reinicie o aplicativo. |
2056 - Leitor de cartão desconectado
Mensagem: Leitor de cartão desconectado durante o processamento da transação.
| Erro | TransactionErrorCause.CARD_READER_DISCONNECTED |
| Descrição | Card reader disconnected during transaction processing. |
| Causas | O leitor de cartão (NFC) foi desconectado durante a transação. |
| Orientação | Verifique o leitor de cartão e tente uma nova transação. |
2057 - Falha no processo isolado
Mensagem: Falha no processo isolado durante o processamento da transação.
| Erro | TransactionErrorCause.ISOLATED_PROCESS_EXCEPTION |
| Descrição | Isolated process failed during transaction processing. |
| Causas | O processo isolado do kernel foi encerrado pelo sistema durante a transação. |
| Orientação | Feche outros aplicativos e tente uma nova transação. |
2058 - Permissão de localização ausente
Mensagem: Permissão de localização é necessária antes de processar a transação.
| Erro | TransactionErrorCause.LOCATION_PERMISSION_MISSING |
| Descrição | Location permission is required before transaction processing. |
| Causas | O aplicativo não possui a permissão de localização necessária para processar a transação. |
| Orientação | Conceda a permissão de localização ao aplicativo e tente novamente. |
2059 - Localização desabilitada
Mensagem: A localização do dispositivo deve estar habilitada antes de processar a transação.
| Erro | TransactionErrorCause.LOCATION_DISABLED |
| Descrição | Device location must be enabled before transaction processing. |
| Causas | A localização do dispositivo está desabilitada nas configurações do sistema. |
| Orientação | Habilite a localização do dispositivo e tente novamente. |
2060 - App em segundo plano
Mensagem: Pagamento não pode ser processado com o aplicativo em segundo plano. Volte ao aplicativo e tente novamente.
| Erro | TransactionErrorCause.APP_IN_BACKGROUND |
| Descrição | App is in background. |
| Causas | O aplicativo foi colocado em segundo plano durante o processamento do pagamento. |
| Orientação | Volte ao aplicativo e tente novamente. |
2063 - Erro de autenticação interna
Mensagem: Erro de autenticação interna. Verifique o campo exception para mais detalhes.
| Erro | TransactionErrorCause.INTERNAL_AUTHENTICATION_ERROR |
| Descrição | Authentication error, see exception field for more details. |
| Causas | Falha de autenticação interna do kernel durante a transação. |
| Orientação | Verifique o campo exception para mais detalhes. Se persistir, colete os logs e entre em contato com o suporte Zoop. |
2064 - Entrada manual do cartão cancelada
Mensagem: Usuário cancelou a entrada manual do cartão (PAN).
| Erro | TransactionCancelReason.USER_CANCELLED_PAN_PAD |
| Descrição | User cancels manual PAN entry. |
| Causas | O usuário cancelou a entrada manual do cartão (PAN). |
| Orientação | Informe ao usuário que a entrada foi cancelada e permita iniciar uma nova transação. |
2065 - Configuração EMV indisponível
Mensagem: Nenhuma configuração EMV disponível para processar a transação.
| Erro | TransactionErrorCause.NO_EMV_CONFIG_AVAILABLE |
| Descrição | No EMV configuration available for transaction processing. |
| Causas | Nenhuma configuração EMV disponível para processar a transação. |
| Orientação | Tente novamente. Se persistir, colete os logs do SDK e entre em contato com o suporte Zoop. |
2066 - Limites de transação offline excedidos
Mensagem: Limites de transação offline excedidos.
| Erro | TransactionErrorCause.OFFLINE_LIMITS_EXCEEDED |
| Descrição | Offline transaction limits exceeded. |
| Causas | A transação excedeu os limites configurados para processamento offline. |
| Orientação | Tente novamente com conexão ativa ou solicite outro cartão. |
2067 - Erro de integridade do armazenamento offline
Mensagem: Erro de integridade do armazenamento de transações offline.
| Erro | TransactionErrorCause.OFFLINE_STORE_INTEGRITY_ERROR |
| Descrição | Offline transaction store integrity error. |
| Causas | Falha de integridade no armazenamento de transações offline. |
| Orientação | Tente novamente. Se persistir, colete os logs e entre em contato com o suporte Zoop. |
2068 - Reinicialização detectada (atestação offline)
Mensagem: Reinicialização do dispositivo detectada; atestação é necessária antes de transações offline.
| Erro | TransactionErrorCause.OFFLINE_REBOOT_ATTESTATION_REQUIRED |
| Descrição | Device reboot detected, attestation required before offline transactions. |
| Causas | O dispositivo foi reiniciado e requer nova atestação antes de transações offline. |
| Orientação | Conecte o dispositivo à internet e tente novamente para renovar a atestação. |
2073 - PIN incorreto
Mensagem: Transação não autorizada devido a entrada de PIN incorreta.
| Erro | TransactionNotAuthorisedReason.INCORRECT_PIN_DECLINED |
| Descrição | Transaction not authorised due to incorrect PIN entry. |
| Causas | O PIN informado pelo portador está incorreto. |
| Orientação | Solicite ao portador que tente novamente com o PIN correto. |
2074 - Tempo esgotado na entrada manual do cartão
Mensagem: Tempo esgotado na entrada manual do cartão (PAN).
| Erro | TransactionErrorCause.MANUAL_PAN_ENTRY_TIMEOUT |
| Descrição | Manual PAN entry timed out. |
| Causas | O tempo para entrada manual do cartão (PAN) foi excedido. |
| Orientação | Inicie uma nova transação e oriente o usuário a concluir a entrada mais rapidamente. |
2075 - Falha ao abrir o teclado de PIN
Mensagem: Falha ao abrir o teclado de PIN dentro do tempo esperado.
| Erro | TransactionErrorCause.PIN_PAD_LAUNCH_TIMEOUT |
| Descrição | PIN pad failed to launch within the expected time. |
| Causas | O teclado de PIN não abriu dentro do tempo esperado. |
| Orientação | Tente novamente. Se persistir, reinicie o aplicativo. |
2076 - Tempo limite do hook de leitura do cartão
Mensagem: Hook de pós-leitura do cartão excedeu o tempo limite após a leitura.
| Erro | TransactionErrorCause.ON_CARD_SCANNED_HOOK_TIMEOUT |
| Descrição | Card-scan hook timed out after the card was scanned. |
| Causas | O hook de pós-leitura do cartão excedeu o tempo limite após a leitura. |
| Orientação | Tente novamente. Se persistir, colete os logs e entre em contato com o suporte Zoop. |
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.
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 sobre a causa raiz. Esses códigos chegam no objeto error.kernel da resposta, consulte a tabela abaixo pelo valor de kernel.code.
📘 Onde esses códigos aparecem na resposta:os códigos das tabelas de Terminal Exception e Internal Exception não vêm no campo code do erro — eles chegam em error.kernel.code, com o nome em error.kernel.name e a descrição no formato [código:NOME] mensagem em error.kernel.description.
Exemplo: um 2019 (Erro interno na transação) pode vir acompanhado de kernel.code = 10007, kernel.name = SESSION_ALREADY_DISPOSED e kernel.description = "[10007:SESSION_ALREADY_DISPOSED] The terminal session is no longer available." — localize a linha pelo valor de kernel.code.
O campo kernel é null quando o erro não é originado no kernel (por exemplo, erros do backend ou da adquirente). Para erros 2xxx sem detalhe de kernel, kernel.code repete o próprio código 2xxx e kernel.name traz o nome da causa (ex.: INTERNAL_ERROR).
Nos erros de pagamento e de sessão o mesmo objeto traz ainda kernelRedactLog — trecho do log do kernel (redatado) para o suporte identificar a causa raiz.
Tabela completa de Terminal Exception (códigos 1–24)
| 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. |
| 22 | UNSUPPORTED_NFC_TAG | Unsupported NFC tag was detected. |
| 23 | CERTIFICATE_PINS_NOT_CONFIGURED | The SDK requires certificate pinning for this build but no pins were configured for the required service endpoints, so a secure connection cannot be established. |
| 24 | INVALID_RRN_LENGTH | The RRN supplied does not have the required length. |
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.
Tabela completa de Internal Exception (códigos 1110–52031)
| 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 |
| 10040 | INVALID_CLIENT_CREDENTIALS_GRANT |
| 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 |
| 10049 | TIMEOUT_ERROR_OUTCOME |
| 10050 | ILLEGAL_STATE_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 |
| 10079 | UNSUPPORTED_TRANSACTION_TYPE |
| 1110 | SESSION_ACTIVATION_DEVICE_STATE_FAILURE |
| 1111 | SESSION_ACTIVATION_NETWORK_FAILURE |
| 1113 | SESSION_ACTIVATION_CONFIGURATION_FAILURE |
| 1115 | START_CARD_READ_FAILED |
| 1119 | TRANSACTION_FAILED_NO_NETWORK |
| 1120 | TRANSACTION_FAILED_MICROPHONE_IN_USE |
| 1121 | TRANSACTION_FAILED_CAMERA_IN_USE |
| 1122 | TRANSACTION_FAILED_TOTAL_TIMEOUT |
| 1123 | TRANSACTION_FAILED_CARD_DISCOVERY_TIMEOUT |
| 1124 | TRANSACTION_FAILED_PIN_ENTRY_TIMEOUT |
| 1125 | TRANSACTION_FAILED_AUTHORISATION_TIMEOUT |
| 1126 | TRANSACTION_FAILED_CARD_SCANNED_HOOK_TIMEOUT |
| 1127 | TRANSACTION_FAILED_MANUAL_PAN_ENTRY_TIMEOUT |
| 1128 | TRANSACTION_FAILED_HOST_APP_CALLBACK_ERROR |
| 1129 | TRANSACTION_FAILED_PIN_PAD_OBSCURED |
| 1130 | TRANSACTION_FAILED_PIN_PAD_CLOSED |
| 1131 | TRANSACTION_FAILED_PIN_PAD_LAUNCH_TIMEOUT |
| 1132 | TRANSACTION_FAILED_NFC_ADAPTER_ERROR |
| 1133 | TRANSACTION_FAILED_APP_IN_BACKGROUND |
| 1134 | TRANSACTION_FAILED_UNSUPPORTED_NFC_TAG |
| 1135 | TRANSACTION_FAILED_INTERNAL_AUTHENTICATION_ERROR |
| 1136 | TRANSACTION_FAILED_CARD_READ_FAILURE |
| 1137 | TRANSACTION_FAILED_INTERNAL_ERROR |
| 1138 | TRANSACTION_START_NO_ACTIVE_SESSION |
| 1139 | TRANSACTION_START_UNEXPECTED_EXCEPTION |
| 1140 | TRANSACTION_FAILED_NO_INTERNET_ACCESS |
| 1141 | TRANSACTION_FAILED_PAYLOAD_MISSING |
| 1142 | TRANSACTION_FAILED_CARD_TAG_LOST |
| 1143 | TRANSACTION_FAILED_UNSUPPORTED_CARD_SCHEME |
| 1144 | TRANSACTION_FAILED_UNSUPPORTED_CURRENCY_EXPONENT |
| 1145 | TRANSACTION_FAILED_PIN_BYPASS_NOT_SUPPORTED |
| 1146 | TRANSACTION_FAILED_UNSUPPORTED_TRANSACTION_TYPE |
| 1147 | TRANSACTION_FAILED_AUTHORISATION_RESPONSE_ERROR |
| 1148 | TRANSACTION_FAILED_AUTHORISATION_PARSE_ERROR |
| 1149 | TRANSACTION_FAILED_EMV_ILLEGAL_STATE |
| 1150 | TRANSACTION_FAILED_PAN_CAPTURE_ERROR |
| 1151 | TRANSACTION_FAILED_PIN_PAD_LAUNCH_ERROR |
| 1152 | TRANSACTION_FAILED_ONLINE_PROCESSING_ERROR |
| 1308 | BER_TLV_BUFFER_UNDERFLOW |
| 14001 | HSM_OPERATION_FAILED |
| 20005 | ANDROID_NETWORK_TIME_MISSING |
| 20006 | NTP_ROOT_DELAY_EXCEEDED |
| 20007 | NTP_ROOT_DISPERSION_EXCEEDED |
| 20008 | NTP_UNTRUSTED_MODE |
| 20009 | NTP_UNTRUSTED_STRATUM |
| 20010 | NTP_SERVER_UNSYNCHRONISED |
| 20011 | NTP_SERVER_RESPONSE_DELAY_EXCEEDED |
| 20012 | NTP_REQUEST_TIMEOUT |
| 23001 | ATTESTATION_FAILURE_UNREGISTERED_VERSION |
| 23002 | ATTESTATION_FAILURE_STRONG_INTEGRITY |
| 23003 | ATTESTATION_TOKEN_SIGNING_KEY_GENERATION_FAILED |
| 23004 | ATTESTATION_TOKEN_SIGNING_KEY_LOOKUP_FAILED |
| 23005 | ATTESTATION_DATA_FRESHNESS_FAILURE |
| 23006 | USER_VISIBLE_ATTESTATION_FAILURE |
| 23007 | ATTESTATION_FAILURE |
| 30001 | INSTANCE_NOT_FOUND |
| 30113 | AUTH_TOKEN_RESPONSE_PARSE_FAILED |
| 40000 | OPERATION_TIMED_OUT |
| 40001 | HTTP_REQUEST_COULD_NOT_BE_COMPLETED |
| 40100 | HTTP_TIMEOUT |
| 40101 | HOST_UNREACHABLE |
| 40102 | CONNECTION_REFUSED |
| 40103 | SSL_TLS_HANDSHAKE_FAILED |
| 40104 | NETWORK_IO_ERROR |
| 40105 | TOKEN_FETCH_TRANSPORT_ERROR |
| 50000 | UNEXPECTED_SERVICE_ERROR |
| 50001 | EMPTY_ERROR_RESPONSE |
| 50002 | UNEXPECTED_RESPONSE |
| 50003 | FAILED_TO_PARSE_ERROR_RESPONSE |
| 50004 | MISSING_REQUIRED_SERVICE_CONFIGURATION |
| 50106 | ENTROPY_PARSE_ERROR |
| 50108 | INITIAL_AGREEMENT_PARSE_ERROR |
| 50110 | TOKEN_RESPONSE_PARSE_ERROR |
| 50113 | HANDLE_TRANSACTION_PARSE_ERROR |
| 51000 | TRANSACTION_GATEWAY_MODE_NOT_IMPLEMENTED |
| 51001 | INVALID_TOKEN |
| 51002 | INVALID_PAYLOAD_HASH |
| 51003 | PAYLOAD_REPLAY_DETECTED |
| 51004 | MISSING_ENVELOPE_ENCRYPTION_KEY |
| 51005 | ENVELOPE_ENCRYPTION_KEY_NOT_FOUND_OR_EXPIRED |
| 51006 | HEADER_COUNTER_MISSING_OR_INVALID |
| 51007 | MISSING_REQUIRED_TOKENS |
| 51008 | TOKEN_VALIDATOR_NOT_FOUND |
| 51009 | INVALID_DIGEST |
| 51010 | HEADER_VALUE_MISSING_OR_INVALID |
| 51012 | INVALID_GATEWAY_MODE_CONFIGURATION |
| 51013 | COULD_NOT_SET_NONCE |
| 51014 | BAD_REQUEST |
| 51015 | PEK_TRANSPORT_KEY_PROVISIONING_FAILED |
| 51016 | PEK_TRANSPORT_KEY_CACHE_EMPTY |
| 51017 | PEK_TRANSPORT_KEY_CACHE_OPERATION_FAILED |
| 51018 | KEY_CACHE_REFRESH_FAILURE |
| 51019 | MISSING_TLV_DATA |
| 51020 | GATEWAY_NOT_CONFIGURED_FOR_ORGANISATION |
| 51021 | MISSING_SERVICE_DEPENDENCY |
| 51022 | HTTP_SERVICE_CLIENT_OPERATION_FAILED |
| 51023 | MISSING_ISO4_PIN_BLOCK_PAYLOAD |
| 51024 | MISSING_KSN_DESCRIPTOR |
| 51025 | MISSING_OR_INVALID_EMV_PAN |
| 51026 | MISSING_REQUIRED_PIN |
| 51027 | PIN_BLOCK_MAP_FORMATTING_FAILURE |
| 51028 | PIN_EXTRACTION_FAILED |
| 51029 | PIN_OPERATION_NOT_SUPPORTED_BY_GATEWAY |
| 51030 | REQUEST_ENCRYPTION_FAILED |
| 51031 | REQUEST_ENCRYPTION_MISCONFIGURATION |
| 51032 | ACQUIRER_AUTHENTICATION_FAILED |
| 51033 | ACQUIRER_GATEWAY_CLIENT_ERROR |
| 51034 | ACQUIRER_GATEWAY_SERVER_ERROR |
| 51035 | ACQUIRER_GATEWAY_REQUEST_COULD_NOT_BE_COMPLETED |
| 51036 | ACQUIRER_GATEWAY_RESPONSE_PARSE_FAILED |
| 51037 | ACQUIRER_GATEWAY_TIMEOUT |
| 51038 | ACQUIRER_GATEWAY_UNHANDLED_ERROR |
| 51039 | PAD_MATERIAL_LOAD_FAILED |
| 51040 | OPIN_TRANSFORMATION_FAILED |
| 51041 | HTTP_COMMUNICATION_FAILURE |
| 51042 | MEMORY_CACHE_FAILURE |
| 51043 | REDIS_CACHE_FAILURE |
| 51044 | MISSING_DECRYPTION_IDENTIFIERS |
| 51045 | PIN_BLOCK_TRANSLATION_FAILED |
| 51046 | PIN_DECRYPTION_FAILED |
| 51047 | JSON_SERIALISATION_FAILED |
| 51048 | PAYLOAD_TIMESTAMP_WINDOW_EXCEEDED |
| 51049 | PAYLOAD_INTEGRITY_FAILURE |
| 51050 | PAYLOAD_INTEGRITY_FAILURE_DATA_ISSUE |
| 51051 | CACHE_ITEM_NULL_VALUE |
| 51052 | INVALID_EVENT_DATA |
| 51053 | INVALID_TLV_DATA |
| 51054 | INVALID_ADAL_ENCRYPTION_KEY_DATA |
| 51201 | TRANSACTION_ROUTE_NOT_SUPPORTED |
| 52007 | EMV_DATA_DECRYPTION_FAILURE |
| 52008 | ORGANISATION_FEATURE_NOT_ENABLED |
| 52010 | ORGANISATION_GATEWAY_CONFIGURATION_NOT_FOUND |
| 52011 | GATEWAY_ID_NOT_SET |
| 52012 | CACHE_RETRIEVAL_FAILURE |
| 52013 | CACHE_STORAGE_FAILURE |
| 52014 | HSM_DECRYPTION_OPERATION_FAILED |
| 52015 | TOKEN_VERIFICATION_FAILED |
| 52016 | ADAL_ENCRYPTION_PRIVATE_KEY_NOT_FOUND |
| 52017 | EMV_PAYLOAD_TLV_PARSING_FAILED |
| 52021 | KSN_DESCRIPTOR_PROCESSING_FAILED |
| 52022 | MISSING_REQUIRED_EMV_REQUEST_PAYLOAD |
| 52023 | BACKGROUND_SERVICE_HANDLER_REGISTRATION_FAILED |
| 52024 | BACKGROUND_SERVICE_FAILED_TO_START |
| 52025 | BACKGROUND_SERVICE_FAILED_TO_STOP |
| 52026 | BACKGROUND_SERVICE_HANDLER_UNREGISTRATION_FAILED |
| 52027 | EVENT_CONSUMER_CHECKPOINT_FAILED |
| 52028 | EVENT_CONSUMER_INFRASTRUCTURE_ERROR |
| 52029 | UNEXPECTED_EVENT_CONSUMER_FAILURE |
| 52030 | EVENT_MESSAGE_PROCESSING_FAILED |
| 52031 | EVENT_PUBLISHING_FAILED |
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. |
3011 — Erro na confirmação da transação
Mensagem: Transação não confirmada. Por favor, contate o suporte para assistência.
| Causas | Falha na confirmação da transação. |
| Orientação | Colete os logs do SDK e entre em contato com o suporte Zoop informando o código 3011 para análise. |
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. |
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 1 hour ago
Did this page help you?