10 - Tabela de Erros

Consulte os códigos de erro retornados pelo SDK Tap to Pay no iPhone, com suas possíveis causas e orientações de resolução.

Os erros estão organizados em três categorias:

Categoria	Origem	Descrição
API	`api`	Erros gerados pela `ZoopAPI`, backend do SDK.
Apple	`apple`	Erros gerados pelo `ProximityReader`, SDK da Apple.
SDK	`sdk`	Erros gerados pelo `TapOnPhoneSDK`.

Como interpretar um erro

A estrutura TapOnPhoneError representa um erro retornado pelo SDK. Ela inclui o código do erro, a origem, uma mensagem principal, uma descrição opcional com mais detalhes, o identificador do leitor ativo e o momento em que a falha foi detectada.

public struct TapOnPhoneError: Equatable, Error, Hashable {
    public let code: TapOnPhoneErrorCode // Código do erro
    public let source: TapOnPhoneErrorSource // Origem do erro
    public let message: String // Mensagem principal do erro
    public let description: String? // Descrição do erro com detalhes extras
    public let readerIdentifier: String? // Identificador do leitor ativo durante o erro
    public let timestamp: Double // Momento em que o erro foi detectado
}

Ao tratar um erro, siga esta ordem:

Leia source para identificar se a falha veio da API, da Apple ou do SDK.
Consulte code para localizar o item correspondente nesta página.
Use message como texto principal para exibição ou log.
Use description quando precisar de detalhes adicionais para diagnóstico.

Se message ou description trouxerem detalhes adicionais do sistema, registre esses valores no log antes de retentar a operação.

Erros de API

Estes erros são retornados pela ZoopAPI durante a comunicação com o backend do SDK.

Fluxo	Códigos
Comunicação com backend	6010, 6069, 6092

6010 — Falha de autenticação na API

Nome: apiAuthenticationError


Descrição	A API da Zoop falhou ao autenticar.
Causas	As credenciais usadas na integração podem estar inválidas, expiradas ou configuradas para o ambiente incorreto.
Orientação	Valide as credenciais usadas pelo SDK, confira o ambiente configurado e tente novamente. Se o erro persistir, revise a autenticação.

6069 — Falha de rede na API

Nome: apiNetworkError


Descrição	Falha na chamada da API da Zoop. Verifique `description` para mais detalhes.
Causas	Pode ter ocorrido perda de conectividade, timeout de rede ou falha temporária de comunicação com o backend.
Orientação	Verifique a conexão do dispositivo, registre o conteúdo de `description` no log e tente novamente quando a comunicação com a API for restabelecida.

6092 — Timeout na API

Nome: apiRequestTimedOut


Descrição	A API da Zoop demorou para responder e não retornou.
Causas	A requisição excedeu o tempo limite por instabilidade de rede ou lentidão temporária do serviço.
Orientação	Tente novamente após confirmar a conectividade. Se o erro ocorrer com frequência, monitore o tempo de resposta da integração.

Erros Apple

Estes erros são retornados pelo ProximityReader, SDK da Apple, e estão organizados por fluxo.

Fluxo	Códigos
Conta Apple e vínculo	6011, 6012, 6017–6021, 6039–6041, 6103, 6104
Dispositivo, leitor e preparação	6022–6038
Sessão e leitura de pagamento	6044, 6046–6062
PIN, estado final e erros gerais	6063–6067, 6072, 6083, 6090, 6096, 6097, 6101, 6105, 6106

Conta Apple e vínculo

6011 — Conta Apple não vinculada

Nome: appleAccountNotLinked


Descrição	A conta Apple iCloud não está vinculada e a operação falhou.
Causas	O comerciante ainda não concluiu o vínculo com a conta Apple iCloud exigida para operar o Tap to Pay on iPhone.
Orientação	Confirme que a conta Apple iCloud exigida para o comerciante está ativa e validada antes de tentar a operação novamente.

6012 — Falha ao vincular conta Apple

Nome: appleAccountLinkError


Descrição	Falha ao vincular a conta Apple iCloud.
Causas	O processo de vínculo não foi concluído com sucesso pela Apple ou pelo fluxo de onboarding.
Orientação	Confirme a conectividade do dispositivo, registre o erro e valide o estado da conta Apple iCloud antes de tentar novamente.

6017 — Conta Apple já vinculada

Nome: appleAccountAlreadyLinked


Descrição	Uma conta Apple iCloud já foi vinculada anteriormente com o comerciante atual.
Causas	O fluxo de vínculo foi iniciado para um comerciante que já possui associação ativa com uma conta Apple iCloud.
Orientação	Não tente criar um novo vínculo para o mesmo comerciante sem necessidade. Reutilize a conta já associada ou revise o fluxo adotado pela aplicação.

6018 — Falha ao vincular ou revincular comerciante

Nome: appleAccountLinkingFailed


Descrição	Não foi possível vincular ou revincular o comerciante com a Apple ID fornecida. Certifique-se de que a Apple ID esteja ativa e tente novamente.
Causas	A Apple ID informada pode estar inativa, indisponível ou inválida para o fluxo de vínculo do comerciante.
Orientação	Confirme que a Apple ID está ativa, válida e apta para uso. Se o erro persistir, valide os dados do comerciante e da conta Apple antes de prosseguir.

6019 — Vínculo cancelado

Nome: appleAccountLinkingCancelled


Descrição	O vínculo da conta Apple iCloud foi cancelado.
Causas	O fluxo de vínculo foi interrompido antes da conclusão, geralmente por ação do usuário ou encerramento do processo.
Orientação	Confirme por que o fluxo foi interrompido e oriente o usuário a concluir todas as etapas sem fechar a tela antes de tentar novamente.

6020 — Falha ao verificar status do comerciante

Nome: appleAccountLinkingCheckFailed


Descrição	O sistema não conseguiu verificar o status da conta do comerciante. Disponível apenas no iOS 16.4+.
Causas	A Apple não conseguiu validar o estado do comerciante durante o processo de vínculo ou verificação da conta.
Orientação	Tente novamente no iOS 16.4 ou superior e repita a verificação quando a conectividade estiver estável.

6021 — Login no iCloud obrigatório

Nome: appleAccountLinkRequiresiCloudSignIn


Descrição	O dispositivo atual não possui uma conta iCloud configurada, mas foi requisitado o vínculo com a conta Apple iCloud.
Causas	O dispositivo não está autenticado no iCloud e o fluxo exige uma conta Apple conectada para prosseguir.
Orientação	Faça login em uma conta iCloud no dispositivo antes de tentar a operação novamente.

6039 — Comerciante bloqueado

Nome: merchantBlocked


Descrição	O comerciante atual está bloqueado.
Causas	O comerciante não está autorizado a operar com o Tap to Pay on iPhone no momento.
Orientação	Interrompa novas tentativas e valide a situação do comerciante antes de repetir o fluxo.

6040 — Conta Apple desativada

Nome: accountDeactivated


Descrição	Indica que a conta Apple ID vinculada foi desativada pelo comerciante. Disponível apenas no iOS 17.0+.
Causas	A conta Apple associada ao comerciante foi explicitamente desativada e não pode mais ser usada no fluxo atual.
Orientação	Reative a conta Apple vinculada ou valide uma conta ativa para o comerciante antes de tentar novamente.

6041 — Comerciante inválido

Nome: invalidMerchant


Descrição	O comerciante atual é inválido.
Causas	Os dados do comerciante informados para o fluxo Apple não correspondem a um comerciante válido ou elegível.
Orientação	Revise a identificação do comerciante usada pela integração e repita a operação com os dados corretos.

6103 / 6104 — Falha no conteúdo de onboarding Apple

Nomes: contentNotFound, contentDisplayFailed


Descrição	O conteúdo do onboarding Apple não foi encontrado ou não pôde ser exibido.
Causas	O material de onboarding não foi carregado corretamente ou houve falha ao renderizar a etapa exigida pela Apple.
Orientação	Reabra o fluxo de onboarding, confirme a conectividade do dispositivo e tente novamente. Se a falha persistir, registre o erro no log.

Dispositivo, leitor e preparação

6022 — Proximity Reader não permitido no dispositivo

Nome: readerErrorNotAllowed


Descrição	O Proximity Reader não é permitido no dispositivo atual.
Causas	O dispositivo não atende aos requisitos operacionais do leitor ou não está apto para executar o Tap to Pay on iPhone.
Orientação	Valide se o dispositivo é elegível para o recurso e repita o fluxo apenas em um aparelho compatível.

6023 — Proximity Reader em segundo plano não permitido

Nome: readerBackgroundRequestNotAllowed


Descrição	O uso do Proximity Reader em segundo plano não é permitido.
Causas	A operação foi iniciada quando o aplicativo não estava em primeiro plano.
Orientação	Traga o aplicativo para o primeiro plano antes de preparar o leitor ou iniciar a leitura.

6024 / 6025 / 6026 — Dispositivo, modelo ou iOS não suportados

Nomes: readerUnsupported, readerOsVersionNotSupported, readerModelNotSupported


Descrição	O hardware, o firmware, a versão do iOS ou o modelo atual não são suportados pelo leitor.
Causas	O dispositivo está fora dos requisitos mínimos do Tap to Pay on iPhone ou executa uma versão de iOS incompatível.
Orientação	Use um iPhone compatível e atualizado para uma versão de iOS suportada antes de repetir a operação.

6027 — Senha do dispositivo desativada

Nome: readerPasscodeDisabled


Descrição	O dispositivo não possui senha configurada.
Causas	O Tap to Pay on iPhone exige proteção por senha no dispositivo para habilitar o leitor.
Orientação	Configure uma senha no iPhone e tente novamente após concluir essa configuração.

6028 / 6029 / 6030 — Falha de rede, autenticação ou serviço do leitor

Nomes: readerNetworkError, readerNetworkAuthenticationError, readerServiceConnectionError


Descrição	O Proximity Reader falhou por problema de rede, autenticação com os servidores da Apple ou comunicação com o serviço.
Causas	O dispositivo pode estar sem internet, com sessão iCloud inválida ou sem conseguir alcançar os serviços da Apple.
Orientação	Verifique a conectividade, confirme que há uma conta iCloud válida no dispositivo e refaça a operação quando a comunicação com a Apple estiver estável.

6031 / 6032 / 6035 — Token do leitor vazio, inválido ou expirado

Nomes: emptyReaderToken, invalidReaderToken, readerTokenExpired


Descrição	O token fornecido pela API da Zoop está vazio, inválido ou expirado. Em `invalidReaderToken`, `message` pode conter uma descrição da Apple ou `empty`.
Causas	O token do leitor não foi emitido corretamente, perdeu a validade ou foi usado fora da janela esperada.
Orientação	Gere um novo token do leitor antes de preparar novamente o Proximity Reader. Registre o valor de `message` quando ele trouxer detalhes adicionais.

6033 / 6034 — Falha ou expiração na preparação do leitor

Nomes: readerPrepareFailed, readerPrepareExpired


Descrição	Não foi possível preparar o Proximity Reader ou a preparação expirou por demora. Em `readerPrepareFailed`, `message` pode conter uma descrição da Apple ou `empty`.
Causas	A preparação não foi concluída dentro do tempo esperado ou foi interrompida por falha temporária do leitor.
Orientação	Refaça a preparação do leitor logo após obter um token válido e registre `message` quando houver detalhes úteis para diagnóstico.

6036 — Dispositivo banido

Nome: deviceBanned


Descrição	O dispositivo atual foi banido pelo comerciante. `message` pode conter a data fornecida pela Apple ou `empty`. O formato segue `yyyy-MM-dd'T'HH:mm:ss'Z'`, `Locale(identifier: "en_US_POSIX")` e `GMT-3`.
Causas	O aparelho foi bloqueado para uso com o comerciante atual e não pode operar o Tap to Pay on iPhone.
Orientação	Não tente reutilizar esse dispositivo até revisar a restrição aplicada. Registre o conteúdo de `message` se ele informar a data relacionada ao bloqueio.

6037 — Memória do leitor cheia

Nome: readerMemoryFull


Descrição	A memória do Proximity Reader está cheia.
Causas	O leitor não conseguiu prosseguir porque o estado interno atingiu um limite de memória ou recursos temporários.
Orientação	Encerre a operação atual, aguarde a liberação dos recursos e tente novamente. Se o erro persistir, reinicie o fluxo.

6038 — Leitor ocupado

Nome: readerBusy


Descrição	O Proximity Reader está ocupado e não pode executar outra operação.
Causas	Já existe uma ação em andamento no leitor, como preparação, atualização de sessão ou leitura.
Orientação	Aguarde a conclusão da operação atual antes de iniciar uma nova tentativa.

Sessão e leitura de pagamento

6044 — Leitura cancelada ou sessão encerrada

Nome: readNotCompletedOrSessionEnded


Descrição	O resultado do leitor não pôde ser obtido porque foi cancelado ou a sessão terminou.
Causas	A leitura foi interrompida antes da conclusão ou a sessão ativa foi encerrada durante o processo.
Orientação	Ative uma nova sessão, reinicie a leitura e confirme que o fluxo não seja cancelado antes do resultado final.

6046 — Leitura não permitida

Nome: readNotAllowed


Descrição	Operação de leitura não permitida, geralmente por problema de entitlement.
Causas	A aplicação não está autorizada pela configuração exigida para executar o Tap to Pay on iPhone.
Orientação	Revise a configuração de entitlement e execute a leitura apenas com a app e o ambiente corretamente habilitados.

6047 — Leitura em segundo plano não permitida

Nome: readFromBackgroundError


Descrição	Operações de leitura não são permitidas em segundo plano.
Causas	A captura do cartão foi iniciada enquanto a aplicação estava em background.
Orientação	Garanta que o aplicativo esteja em primeiro plano durante toda a leitura do pagamento.

6048 — Sessão do leitor indisponível

Nome: noReaderSession


Descrição	Nenhuma sessão de leitor está disponível ou a sessão não está pronta.
Causas	A leitura foi iniciada antes da criação da sessão ou antes de o leitor ficar pronto.
Orientação	Crie ou atualize a sessão do leitor e só inicie a leitura quando o fluxo de preparação estiver concluído.

6049 — Sessão do leitor expirada

Nome: readerSessionExpired


Descrição	A sessão do leitor expirou e não pôde ser atualizada devido a outras mudanças de estado.
Causas	A sessão perdeu a validade durante o fluxo e não conseguiu ser renovada no estado atual do leitor.
Orientação	Inicie uma nova sessão do leitor antes de repetir a operação.

6050 — Falha de rede na atualização da sessão

Nome: readerSessionNetworkError


Descrição	Um erro de rede impediu a atualização da sessão do leitor.
Causas	A sessão não pôde ser renovada por perda de conectividade ou instabilidade na comunicação com a Apple.
Orientação	Verifique a conexão de internet e tente atualizar a sessão novamente quando a rede estiver estável.

6051 — Falha de autenticação na atualização da sessão

Nome: readerSessionAuthenticationError


Descrição	Ocorreu um erro de autenticação ao atualizar a sessão do leitor.
Causas	A sessão do leitor não conseguiu se autenticar junto aos serviços da Apple durante a atualização.
Orientação	Revise o estado de autenticação do dispositivo e tente recriar a sessão do leitor.

6052 — Sessão do leitor ocupada

Nome: readerSessionBusy


Descrição	O leitor está em outra sessão. O Tap to Pay on iPhone já está sendo exibido.
Causas	Já existe uma sessão ativa em uso e uma nova operação tentou reutilizar o leitor ao mesmo tempo.
Orientação	Aguarde o encerramento da sessão atual antes de iniciar outra leitura.

6053 — Leitura cancelada

Nome: readCancelled


Descrição	A leitura atual foi cancelada.
Causas	O usuário ou o fluxo de leitura interrompeu a operação antes da conclusão.
Orientação	Inicie uma nova leitura e oriente o usuário a manter o fluxo até o fim da captura do cartão.

6054 — Valor inválido

Nome: invalidAmount


Descrição	Valor inválido na solicitação. Todos os valores devem ser positivos e conter menos de 10 dígitos.
Causas	O valor enviado para a operação está zerado, negativo ou fora do limite aceito pelo leitor.
Orientação	Valide o valor antes de iniciar a leitura e envie apenas valores positivos com menos de 10 dígitos.

6055 — Código de moeda inválido

Nome: invalidCurrencyCode


Descrição	Código de moeda inválido. Deve seguir o padrão ISO 4217.
Causas	A requisição informou uma moeda fora do padrão aceito pelo sistema.
Orientação	Envie somente códigos de moeda compatíveis com ISO 4217 antes de tentar novamente.

6056 — AID preferencial inválida

Nome: invalidPreferredAID


Descrição	AID preferencial inválida (iOS 16.4+). AIDs ou RIDs estão fora de 5 a 16 bytes ou há itens em excesso na lista.
Causas	A configuração de AIDs preferenciais enviada para a leitura não respeita os limites definidos pela Apple.
Orientação	Revise a lista enviada, garanta que cada AID ou RID tenha entre 5 e 16 bytes e remova itens excedentes antes de iniciar nova leitura.

6057 — NFC desativado

Nome: nfcDisabled


Descrição	O NFC está desativado. O Tap to Pay on iPhone exibiu um erro pedindo para habilitar o NFC.
Causas	O iPhone não está com o recurso necessário para leitura por aproximação disponível no momento.
Orientação	Habilite o NFC ou ajuste a configuração solicitada pelo sistema antes de repetir a operação.

6058 — Leitura não permitida durante chamada

Nome: readNotAllowedDuringCall


Descrição	Operações de leitura não são permitidas durante uma chamada telefônica. O usuário deve encerrar a chamada antes de usar o Tap to Pay.
Causas	O dispositivo estava em chamada ativa no momento em que a leitura foi iniciada.
Orientação	Encerre a chamada telefônica e tente novamente após liberar o dispositivo para leitura.

6059 — Senha do dispositivo desativada na leitura

Nome: passcodeDisabled


Descrição	A leitura não é permitida com a senha do dispositivo desativada. É preciso pedir ao usuário para definir uma senha.
Causas	O dispositivo não atende ao requisito de segurança mínimo para processar a leitura.
Orientação	Configure uma senha no dispositivo e reinicie o fluxo de leitura depois dessa etapa.

6060 — Falha na leitura do cartão

Nome: cardReadFailed


Descrição	Erro ao ler o cartão. A folha do Tap to Pay on iPhone exibiu uma mensagem indicando a falha.
Causas	O cartão não foi capturado corretamente pelo leitor ou houve falha durante a aproximação.
Orientação	Inicie uma nova leitura e peça ao portador para aproximar novamente o cartão na posição correta até a conclusão.

6061 — Falha interna na leitura do pagamento

Nome: paymentReadFailed


Descrição	Falha interna na leitura. O Tap to Pay on iPhone exibiu uma mensagem indicando a falha.
Causas	O processo interno de captura do pagamento falhou durante a etapa de leitura.
Orientação	Refaça a operação desde o início. Se o erro ocorrer de forma recorrente, registre os detalhes do fluxo e investigue o ambiente.

6062 — Cartão recusado

Nome: paymentCardDeclined


Descrição	O cartão de pagamento recusou a transação.
Causas	O emissor ou o próprio cartão rejeitou a tentativa de pagamento.
Orientação	Solicite outro cartão ou oriente o portador a validar a situação com o emissor antes de tentar novamente.

PIN, estado final e erros gerais

6063 — Falha ao capturar PIN

Nome: pinEntryFailed


Descrição	Erro ao capturar o PIN. Disponível no iOS 16.0+.
Causas	O fluxo de captura de senha não conseguiu ser concluído corretamente.
Orientação	Reinicie a operação e peça ao portador para digitar o PIN novamente quando a tela for exibida.

6064 — Token de PIN inválido

Nome: pinTokenInvalid


Descrição	Token de PIN inválido. Disponível no iOS 16.0+.
Causas	O token usado na etapa de PIN não corresponde a um valor válido para a operação atual.
Orientação	Gere novamente o fluxo de leitura para obter um contexto válido de captura do PIN antes de repetir a operação.

6065 — Timeout na captura do PIN

Nome: pinEntryTimeout


Descrição	O PIN não foi informado no tempo permitido. Disponível no iOS 16.0+.
Causas	O portador demorou mais do que o limite aceito para preencher a senha.
Orientação	Inicie uma nova operação e oriente o portador a digitar o PIN assim que o teclado for exibido.

6066 — Captura de PIN cancelada

Nome: pinCancelled


Descrição	A captura atual do PIN foi cancelada no iOS 16.0+, cancelando também a leitura em andamento.
Causas	O fluxo de senha foi interrompido antes da confirmação do PIN.
Orientação	Recomece a leitura desde o início e confirme com o portador que ele concluirá a etapa de PIN sem cancelar.

6067 — Janela para PIN expirada

Nome: pinNotAllowed


Descrição	A janela de tempo para capturar o PIN após a leitura expirou. Disponível no iOS 16.0+.
Causas	A senha não foi iniciada logo após a leitura, e o sistema encerrou a possibilidade de captura.
Orientação	Inicie uma nova operação e avance para a etapa de PIN sem atrasos entre a leitura do cartão e a digitação.

6072 — Leitor não está pronto

Nome: readerNotReady


Descrição	O leitor não está pronto para transações.
Causas	O fluxo tentou iniciar uma operação antes de a preparação do leitor ou da sessão ter sido concluída.
Orientação	Finalize a preparação do leitor e só depois inicie a transação.

6083 — Erro desconhecido do leitor

Nome: readerUnknown


Descrição	Erro desconhecido com o leitor, não identificado pelo SDK.
Causas	O leitor retornou uma falha que não pôde ser mapeada para um código mais específico.
Orientação	Registre `message`, `description` e o contexto da operação antes de tentar novamente.

6090 — Erro interno no serviço do leitor

Nome: readerServiceError


Descrição	Ocorreu um problema interno no serviço do leitor.
Causas	O serviço da Apple responsável pelo leitor encontrou uma falha interna temporária.
Orientação	Aguarde alguns instantes e tente novamente. Se o erro persistir, registre os detalhes retornados pelo SDK.

6096 / 6097 / 6101 — Cartão expirado, inválido ou inativo

Nomes: expiredCard, invalidCard, inactiveCard


Descrição	O cartão utilizado está expirado, é inválido ou está desabilitado.
Causas	O meio de pagamento não atende às condições mínimas para autorização da transação.
Orientação	Solicite outro cartão ao portador e não repita a cobrança com o mesmo cartão até validar a situação com o emissor.

6105 — Sistema ocupado

Nome: systemBusy


Descrição	O sistema está ocupado.
Causas	Já existe outra atividade relevante em andamento no sistema ou no leitor, impedindo a nova operação.
Orientação	Aguarde a conclusão da operação atual antes de tentar novamente.

6106 — Erro Apple desconhecido

Nome: unknown


Descrição	Erro Apple não conhecido.
Causas	A Apple retornou uma falha que não foi identificada com um código mais específico pelo SDK.
Orientação	Registre `message`, `description`, `code` e o momento da falha (`timestamp`) para apoiar o diagnóstico antes de repetir o fluxo.

Erros do SDK

Estes erros são retornados diretamente pelo TapOnPhoneSDK durante configuração, inicialização e pagamento.

Fluxo	Códigos
Configuração e inicialização	6008, 6009, 6016, 6099, 6108, 6109
Pagamento e operação	6015, 6042, 6043, 6091, 6093, 6095, 6098, 6100, 6102

6008 — Dispositivo não suportado

Nome: unsupportedDeviceError


Descrição	Dispositivo não suportado, seja pelo modelo ou pela versão do iOS.
Causas	O aparelho não atende aos requisitos mínimos de hardware ou sistema operacional do SDK.
Orientação	Use um dispositivo compatível com a versão do SDK instalada antes de repetir a operação.

6009 — SDK não inicializado

Nome: deviceNotReadyError


Descrição	A sessão do dispositivo não pode ser iniciada. O SDK não foi inicializado antes.
Causas	A aplicação tentou usar o SDK antes de concluir a inicialização obrigatória.
Orientação	Chame o fluxo de inicialização do SDK antes de iniciar qualquer operação de leitura ou pagamento.

6015 — Falha na transação

Nome: transactionError


Descrição	A transação de pagamento falhou.
Causas	O SDK não conseguiu concluir o fluxo de pagamento por uma falha genérica durante a transação.
Orientação	Valide o contexto da operação, registre os detalhes retornados pelo SDK e reinicie o fluxo de pagamento se necessário.

6016 — Dispositivo jailbroken ou em modo incompatível

Nome: jailbrokenDeviceError


Descrição	Não é possível usar o SDK em `Production` com um dispositivo jailbroken ou em modo debug.
Causas	O ambiente atual não atende aos requisitos de segurança exigidos para execução em produção.
Orientação	Execute o SDK apenas em um dispositivo íntegro e em um modo compatível com o ambiente configurado.

6042 — Sem conexão com a internet

Nome: networkNotConnected


Descrição	O dispositivo não tem conexão com a internet.
Causas	O aparelho está sem acesso à rede no momento da operação.
Orientação	Restabeleça a conexão com a internet antes de inicializar ou repetir o fluxo de pagamento.

6043 — Valor ou parcelamento inválidos

Nome: invalidAmountOrInstallments


Descrição	Valor ou parcelamento inválidos para a transação.
Causas	Os parâmetros enviados para a cobrança não respeitam as regras aceitas pelo SDK.
Orientação	Valide valor e parcelamento antes de chamar a operação de pagamento.

6091 — Tipo de pagamento inválido

Nome: invalidPaymentType


Descrição	Tipo de pagamento não suportado para este cartão, como usar cartão de débito em pagamento de crédito.
Causas	O tipo de pagamento escolhido não é compatível com o cartão aproximado ou com a forma de cobrança iniciada.
Orientação	Ajuste o tipo de pagamento para uma opção compatível ou solicite outro cartão ao portador.

6093 — Token de pagamento inválido

Nome: invalidPaymentToken


Descrição	O token de pagamento está vazio ou é inválido.
Causas	O token informado para a transação não foi gerado corretamente ou já não é válido para uso.
Orientação	Gere um novo token de pagamento antes de reiniciar a operação.

6095 — Falha ao extrair dados do cartão

Nome: cardReadExtractionFailed


Descrição	Erro ao extrair dados da leitura do cartão.
Causas	O SDK não conseguiu processar corretamente os dados capturados durante a leitura.
Orientação	Refaça a leitura do cartão. Se o erro continuar, registre os detalhes do fluxo para análise.

6098 — Dados de externalSeller inválidos

Nome: invalidExternalSellerData


Descrição	Dados de `externalSeller` são inválidos.
Causas	Os dados enviados para identificar o vendedor externo não respeitam o formato ou as regras esperadas pelo SDK.
Orientação	Revise o payload de `externalSeller` antes de chamar novamente a operação.

6099 — setConfig não chamado

Nome: setConfigNotCalled


Descrição	O método `setConfig` não foi chamado previamente.
Causas	O SDK não recebeu a configuração obrigatória antes do uso.
Orientação	Execute `setConfig` antes de inicializar ou processar transações.

6100 — Operação em andamento

Nome: operationInProgress


Descrição	Já existe uma operação em andamento.
Causas	A aplicação tentou iniciar uma nova ação enquanto outra ainda não havia sido concluída.
Orientação	Aguarde a finalização da operação atual antes de disparar um novo comando.

6102 — Erro interno do SDK

Nome: internalError


Descrição	Erro interno do SDK.
Causas	O SDK encontrou uma falha interna não detalhada durante a execução do fluxo.
Orientação	Registre `message`, `description` e o contexto da operação antes de tentar novamente.

6108 — Seller obrigatório na inicialização em multiseller

Nome: sellerNotProvidedOnInit


Descrição	Em modo multiseller, com `setConfig` usando `seller` `nil` ou vazio, o `sellerId` é obrigatório em `TapOnPhone.initialize(sellerId:)`.
Causas	A inicialização foi chamada sem informar o `sellerId` exigido para o modo multiseller.
Orientação	Informe `sellerId` em `TapOnPhone.initialize(sellerId:)` sempre que a configuração estiver operando em modo multiseller.

6109 — Seller não pode ser alterado no initialize

Nome: sellerNotAllowedOnInitialize


Descrição	Em modo single-seller, com `setConfig` usando `seller` preenchido, o `sellerId` do `initialize` não pode ser diferente do seller da configuração.
Causas	O fluxo tentou inicializar o SDK com um `sellerId` diferente do definido previamente em `setConfig`.
Orientação	Não altere o `sellerId` no `initialize` quando o SDK estiver configurado em single-seller. Use o mesmo seller definido em `setConfig`.

Precisa de ajuda?

Se o erro persistir após seguir as orientações acima, entre em contato com o suporte Zoop:

📞 Telefone (segunda a sexta, 9h às 19h)

Capitais: 4003-3261
Demais regiões: 0800 878 8161

✉️ E-mail

[email protected]