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 |
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. |
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 — SDK não inicializado
Mensagem: A SDK não foi inicializada.
| 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: Tentativa de transação com o valor acima do 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: O identificador do plano de cobrança é inválido. Verifique os dados e tente novamente.
| 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: O valor informado para cobrança é inválido. Ajuste o valor e tente novamente.
| 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: O Tap to Pay ainda não está pronto. Aguarde a tela de pagamento 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. |
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 |
| 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. |
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. |
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. |
| 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. |
2043 — Erro NFC na descoberta do cartão
Mensagem: NFC adapter is not ready for accepting cards.
| 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. |
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. 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.
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. |
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 15 days ago
Did this page help you?