O Tap to Pay permite receber pagamentos por cartão de crédito ou débito por aproximação, direto pelo celular com o Sympla Express — sem precisar de maquininha.
Para funcionar corretamente, o celular precisa ter:
- NFC ativado
- Conexão com internet (Wi-Fi ou 4G/5G)
Quando devo consultar esta FAQ?
Use este guia quando:
- Aparecer uma mensagem de erro durante uma venda por aproximação
- O pagamento não for concluído após aproximar o cartão
- A venda “travar” ou não receber autorização
Boas práticas para evitar erros no Tap to Pay
Antes de tentar novamente uma venda, confira:
- O celular está com internet estável
- O NFC está ativado
- O app Sympla Express está atualizado
- Evite tentar várias vezes seguidas com o mesmo cartão
- Não mude de app durante o pagamento
Esses cuidados reduzem a maioria dos erros.
A venda foi recusada. O que isso significa?
Na maioria dos casos, a recusa não é um erro do Sympla Express.
Ela pode acontecer por:
- Limite do cartão
- Cartão não habilitado para aproximação
- Bloqueio do banco
- Tentativa acima do valor permitido
O que fazer:
Peça outro cartão ou ofereça outro meio de pagamento.
Apareceu erro de conexão ou tempo esgotado. O que fazer?
Esse tipo de erro normalmente indica instabilidade momentânea.
Tente:
- Aguardar alguns segundos
- Verificar a internet
- Fechar e abrir o app
- Repetir a operação
Se o erro continuar, use outro meio de pagamento.
O pagamento ficou “travado” ou sem resposta
Se o sistema não retornar nenhuma confirmação após cerca de 2 minutos:
- Não tente várias vezes seguidas
- Verifique se a venda apareceu na lista de pedidos
- Caso não tenha sido concluída, tente novamente ou use outro pagamento
Posso tentar o mesmo cartão várias vezes?
Não é recomendado.
Múltiplas tentativas consecutivas com o mesmo cartão aumentam a chance de bloqueio pelo banco do cliente.
Prefira:
- Aguardar alguns minutos
- Usar outro cartão
- Oferecer outro meio de pagamento
Quando devo acionar o suporte do Sympla Express?
Entre em contato com o suporte se:
- O mesmo erro acontecer 3 ou mais vezes seguidas
- O problema afetar mais de um celular ou operador
- Nenhuma venda por Tap to Pay funcionar no evento
Quais informações ajudam o suporte a resolver mais rápido?
Ao falar com o suporte, separe:
- ID do evento
- Nome do organizador
- Data e horário aproximado do erro
- Mensagem exibida na tela
- Login do operador
- Versão do app Sympla Express
- Modelo do celular (Android)
O erro significa que o dinheiro foi cobrado?
Não necessariamente.
Se a venda não aparecer como concluída na lista de pedidos, o valor não foi capturado.
Em caso de dúvida, confira sempre o histórico de vendas antes de refazer a cobrança.
Guia de erros e ocorrências e soluções
Use a tabela abaixo para listar mensagens de erro, causas e ações recomendadas.
Guia de erros na comunicação com Zoop
| Status Code | Tipo | Categoria | Descrição | Código de erro Bandeira |
| 500 | processing_error | server_api_error | Ocorreu um erro de processamento na Zoop. Se você receber esta mensagem, entre em contato com api@pagzoop.com | |
| 409 | invalid_request_error | duplicate_taxpayer_id | Customer with this taxpayer_id already exists. | |
| 409 | Conflict | split_rule_precondition_creation_failure | Split operation failed due to precondition rules. ERRO - REGRA DE CONSISTÊNCIA DA TRANSAÇÃO E RECEBÍVEIS | |
| 408 | invalid_request_error | service_request_timeout | Credit card process is temporarily unavailable at the specified location. | |
| 404 | invalid_request_error | endpoint_not_found | The requested URL was not found on the server | |
| 401 | invalid_request_error | authentication_failed | The API Key provided has expired or has been deleted. | |
| 401 | invalid_request_error | expired_security_key | This API call cannot be made with a publishable API key. | |
| 401 | invalid_request_error | invalid_key_for_api_call | The minimum amount is $0.50 (or equivalent in country currency). The amount must be a positive integer in cents representing how much to charge, e.g 1260 for $12.60. | |
| 400 | invalid_request_error | transaction_amount_error | The minimum amount is $0.50 (or equivalent in country currency). The amount must be a positive integer in cents representing how much to charge, e.g 1260 for $12.60. | |
| 400 | invalid_request_error | transfer_amount_error | The minimum transfer amount is $1.00 (or equivalent in country currency). The amount must be a positive integer in cents representing how much to charge, e.g 1260 for $12.60. | |
| 400 | invalid_request_error | missing_required_param | Missing required parameter(s). Please verify request parameters. | |
| 400 | invalid_request_error | unsupported_payment_type | Invalid request: unsupported payment type. | |
| 400 | invalid_request_error | invalid_payment_information | Invalid payment information. Please verify request parameters. | |
| 400 | invalid_request_error | invalid_parameter | Invalid parameter(s). Your parameter value is incorrect. Please verify request parameters. | |
| 402 | file_upload | file_size_too_large | ||
| 402 | invalid_request_error | insufficient_escrow_funds_error | Requested transfer exceeds remaining settled funds in escrow. | |
| 402 | invalid_request_error | capture_transaction_error | The capture request failed. Transaction could not be captured. | |
| 402 | invalid_request_error | no_action_taken | No action taken. Unable to back out prior transaction | |
| 402 | invalid_request_error | seller_authorization_refused | Seller has not been authorized to charge credit cards. Complete activation to start processing payments. | |
| 402 | invalid_request_error | void_transaction_error | The void request failed. Transaction could not be voided. | |
| 402 | card_error | invalid_expiry_month | Invalid expiry month value. Please verify request parameters. | |
| 402 | card_error | invalid_expiry_year | Invalid expiry year value. Please verify request parameters. | |
| 402 | card_error | card_customer_not_associated | Transaction denied. No active card. | |
| 402 | card_error | insufficient_funds_error | Requested credit exceeds remaining settled funds. | 51 |
| 402 | card_error | expired_card_error | The credit card has expired. | 33 |
| 402 | card_error | invalid_card_number | The card number is not a valid credit card number. | 15 |
| 402 | card_error | invalid_pin_code | Transaction denied. Invalid PIN code. | 55 |
| 402 | card_error | authorization_refused | Transação ilegal | 58 |
Guia de erros na comunicação terminal - Symbiotic
| Código | Description | Ação recomendada (passo a passo) |
| -1 | Temporary reading error, please try again | Erro temporário na leitura, tente novamente por favor |
| 0 | Succesful response | Resposta bem-sucedida |
| 1 | Timeout error | Erro de Timeout |
| 2 | Device verification failed | Falha na verificação do dispositivo |
| 3 | Device key generator failed | Falha na geração da chave do dispositivo |
| 4 | The SDK or Android version is not compatible | A versão SDK ou Android não é compatível |
| 5 | SafetyNet failure | Falha na SafetyNet |
| 6 | Attestation failure | Falha no Attestation |
| 7 | Deeplink communication failure | Falha na comunicação do deeplink |
| 30 | Transaction timeout. The Backend did not respond to the app on time. | Timeout na transação. O backend não respondeu ao aplicativo a tempo. |
| 31 | Developer mode active | Modo desenvolvedor ativo |
| 32 | TapOnPhone versioning failed | TapOnPhone versioning failed. |
| 33 | TEE unavailable, there's no secure hadware to store the keys on the device | TEE indisponível, nenhum hardware seguro para armazenar chaves no dispositivo. |
| 34 | Transaction key generation failed | Falha na geração da chave de transação. |
| 35 | Key generation expired (didn't arrive in time) | A geração de chaves expirou (não chegou a tempo). |
| 36 | Indicates that the app was not installed from Google Play, which may be a security issue | Indica que o aplicativo não foi instalado do Google Play, o que pode ser um problema de segurança. |
| 37 | Indicates that occured an error during the transaction result processing | Indica que ocorreu um erro durante o processamento do resultado da transação. |
| 38 | Indicates that the network changed during the app execution, which may affect the connectivity | Indica que a rede mudou durante a execução do aplicativo, o que pode afetar a conectividade. |
| 39 | Indicates that the app lost focus, probably because the user switched to another app | Indica que o aplicativo perdeu o foco, provavelmente porque o usuário mudou para outro aplicativo. |
| 40 | Indicates that a reading operation is being repated due to a previus failure | Indica que uma operação de leitura está sendo repetida devido a uma falha anterior. |
| 41 | Indicates that there was a problem accessing or using the camera | Indica que houve um problema ao acessar ou usar a câmera. |
| 42 | Indicates that the NFC is disable on the device, preventing its functionality | Indica que o NFC está desabilitado no dispositivo, impedindo sua funcionalidade. |
| 51 | Indicates that the transaction was made for an amount that exceeds the transaction limit | Indica que a transação foi feita por um valor que excede o limite da transação. |
| 53 | Indicates that the card reading time expired | Indica que o tempo limite para leitura do cartão expirou. |
| 54 | Indicates that the transaction was cancelled by the user | Indica que a transação foi cancelada pelo usuário. |
| 55 | Indicates tha the transaction failed. This is a generic error case | Indica que a transação falhou. Este é um caso de erro genérico. |
| 76 | Card Invalidated, the card was declined by the Kernel | Cartão Invalidado, card was declined by the kernel. "Cartão Invalidado, cartão recusado pelo kernel" |
| 77 | Card unsupported. Brand or app Id are not supported by enabled kernels. Error presented by Visa Kernel | Cartão não suportada. A marca ou o ID do aplicativo não são suportados pelos kernels habilitados. Erro apresentado pelo Kernel Visa. |
| 78 | Card aborted. Error presented by Visa Kernel | Cartão abortado. Erro apresentado pelo Kernel Visa. |
| 79 | Card with unrecognized AID. Error presented by Visa Kernel | Cartão com AID não reconhecido. Erro apresentado pelo Kernel Visa. |
| 80 | Kernel declined by transaction limit | Kernel recusou devido ao limite de transãçao |
| 81 | Card cancellation error. This occurs when a different card is used to cancel the transaction | Erro no cancelamento do cartão. Isso ocorre quando um cartão diferente é usado para cancelar a transação. |
| 82 | Cancelled transaction. This occurs when the transaction cancellation option is selected on the screen | Transação cancelada. Isso acontece quando a opção de cancelamento da transação é selecionada na tela. |
| 83 | Expired transaction. This occurs when the card reading time runs out without any card being successfully read | Transação expirada. Isso ocorre quando o tempo de leitura do cartão se esgota sem que nenhum cartão seja lido com sucesso. |
| 84 | Cryptographic key error | Erro de chave criptográfica. |
| 103 | No camera control | Sem controle da câmera |
| 104 | Camera is being used during transaction | A câmera está sendo usada durante a transação. |
| 108 | Camera permission not granted | Permissão para câmera não concedida. |
| 150 | Indicates that the transaction required a PIN, but none was entered | Indica que a transação exigiu um PIN, mas nenhum foi inserido. |
| 200 | Insecure device | Dispositivo inseguro |
| 201 | Debug mode | Modo Debug |
| 204 | DashO flagg that the phone is rooted | DashO sinalizou que o telefone está rootado |
| 500 | Activation failure | Falha na ativação |
| 10001 | Indicates that the terminal is not active, possibly because was not configurate or enable | Indica que o terminal não está ativo, possivelmente porque não foi configurado ou habilitado. |
| 10002 | Indicates that an error ocurred when checking if the terminal is active | Indica que ocorreu um erro ao verificar se o terminal está ativo. |
| 2501 | Terminal was not found in database | O terminal não foi encontrado no banco de dados |
| 2502 | Terminal is idle | Terminal está ocioso |
| 2503 | Terminal unassigned, it already exists as an activated terminal | O terminal não atribuído já existe como terminal ativado |
| 2504 | Incorrect terminal parameters | Parâmetros de terminal incorretos |
| 2505 | Database errror regarding the terminal | Erro com o banco de dados referente ao terminal |
| 2506 | No terminal associate with the token. Incorrect token | Não há terminal associado ao token. Token incorreto |
| 2507 | Invalid operating System | Sistema operacional inválido |
| 2508 | Invalid operating system version | Versão inválida do sistema operacional |
| 2509 | Invalid phone number | Número de telefone inválido |
| 2510 | Device id is not associate with a terminal | ID do dispositivo não associado ao terminal |
| 2514 | The token of a user associated with a terminal expired | O token de um usuário associado a um terminal expirou |
| 2515 | Terminal is not associated with a user | Terminal não associado a um usuário |
| 2517 | Activation token expired | O token de ativação expirou |
| 2518 | Terminal do not support the currency type | O terminal não suporta o tipo de moeda |
| 2519 | Another terminal exist with the same token | Existe outro terminal com o mesmo token |
| 2601 | Incorrect user password | Senha de usuário incorreta |
| 2602 | Email is not associated with the terminal | O e-mail não está associado ao terminal |
| 2603 | User does not exist | Usuário não existe |
| 2604 | You must wait for the next attempt to reset your password | Você deve aguardar a próxima tentativa de redefinir sua senha |
| 2605 | Incorrect password reset token | Token de redefinição de senha incorreto |
| 2606 | Expired password reset token | Token de redefinição de senha expirada |
| 2607 | Duplicate email in database | E-mail duplicado no banco de dados |
| 2608 | Email already registered, try with another | Este e-mail já está cadastrado, tente com outro |
| 2201 | Comunication Error | Erro de comunicação. |
| 2202 | Internal server timeout | Tempo limite no servidor interno |
| 2203 | Transaction not found | A transação não foi encontrada |
| 2205 | Transaction was denied | A transação foi negada |
| 2206 | Transaction key expired | Chave de transação expirada |
| 2207 | Transaction was reversed | A transação foi revertida |
| 2301 | Error sending an email | Erro ao enviar um e-mail |
| 2401 | Device is marked as unsafe | O dispositivo está marcado como inseguro |
| 2402 | Device not found | Dispositivo não encontrado |
| 2403 | Device Verification Expired | A verificação do dispositivo expirou |
| 2404 | Device is indeterminate | O dispositivo é indeterminado |
| 2405 | Failed to generate random number | Falha ao gerar número aleatório |
| 2406 | Device key expired | Chave do dispositivo expirada |
| 2407 | Device is not assigned to a terminal | O dispositivo não está atribuído ao terminal |
| 2408 | Device key was not generated | A chave do dispositivo não foi gerada |
| 2410 | Error decrypting keys in the backend | Erro ao descriptografar chaves no backend. |
| 2409 | Invalid status code | Código de status inválido |
| 2903 | Device verification expired | A verificação do dispositivo expirou. |
| 1001 | Request type error when invoking the method | Erro de tipo de solicitação ao invocar o método |
| 1002 | The content size in the header is not correct | O tamanho do conteúdo no header não está correto |
| 1003 | The content type in the header is not correct | O tipo de conteúdo no header não está correto |
| 1004 | Missing parameter to invoke the method | Faltam parâmetros para invocar o método |
| 1005 | A parameter type is incorrect | O tipo de um parâmetro está incorreto |
| 1006 | A parameter size is incorrect | O tamanho de algum parâmetro está incorreto |
| 1007 | Inactive terminal | Terminal inativo |
| 1009 | Device version not supported | Versão do dispositivo não suportada |
| 1101 | JWT error | Erro JWT |
| 1602 | JWT error | Erro JWT |
| 1102 | Decryption error occurred | Ocorreu um erro de descriptografia |
| 2001 | Terminal Not Found | Terminal não encontrado |
| 2002 | Terminal Inactive | Terminal inativo |
| 2005 | Terminal Database Error | Erro no banco de dados do terminal |
| 2006 | Terminal Wrong Token | Terminal com token errado |
| 2010 | Terminal Invalid Device Id | ID do dispositivo do terminal inválido |
| 2017 | Terminal Activate Expired | Ativação do terminal expirada |
| 2208 | PMS Connection Error Failed With Schema | Erro de conexão com o PMS: falha com o esquema |
| 2412 | Unhandled Backend Exception | Exceção não tratada no backend |
Guia de erros de Pagamento - Pagbank
| Código de Retorno=00 Transação Autorizada |
| Código de Retorno=01 Contactar Emissor |
| Código de Retorno=02 Tempo de operação excedido |
| Código de Retorno=03 Conexão recusada |
| Código de Retorno=04 Erro imprevisto |
| Código de Retorno=05 Contactar Emissor (elo - "erro genérico") |
| Código de Retorno=06 Erro Genérico |
| Código de Retorno=07 Erro imprevisto |
| Código de Retorno=08 Transação não encontrada Indisponível |
| Código de Retorno=09 Tempo de operação excedido |
| Código de Retorno=10 Erro imprevisto |
| Código de Retorno=11 Erro imprevisto |
| Código de Retorno=12 Erro imprevisto |
| Código de Retorno=13 Valor Transação Inválido |
| Código de Retorno=14 Cartão Inválido |
| Código de Retorno=15 Bin-Holder inválido |
| Código de Retorno=16 Transação já estornada |
| Código de Retorno=17 Erro imprevisto |
| Código de Retorno=18 TLV maior que esperado |
| Código de Retorno=19 Modo inválido |
| Código de Retorno=20 Transação duplicada |
| Código de Retorno=21 Operação não realizada |
| Código de Retorno=22 Use o chip |
| Código de Retorno=24 Erro no criptograma |
| Código de Retorno=25 Erro ao confirmar transação |
| Código de Retorno=26 Operação Duplicada |
| Código de Retorno=28 Produto não habilitado |
| Código de Retorno=30 Erro de formato |
| Código de Retorno=31 Instituição não pertence a rede |
| Código de Retorno=38 Excedeu tentativas senha |
| Código de Retorno=40 Serviço Indisponível |
| Código de Retorno=41 Cartão Extraviado |
| Código de Retorno=43 Cartão Roubado |
| Código de Retorno=46 Negada que a Pagseguro nem envia denovo para o Emissor para não baixar o score da adquirente |
| Código de Retorno=51 Saldo Insuficiente |
| Código de Retorno=53 Não Permitida [Cartão Poupança Inválido] (Alelo)dcsx |
| Código de Retorno=54 Cartão/Conta Vencida |
| Código de Retorno=55 Senha Inválida |
| Código de Retorno=57 Serviço Inválido para o Cliente |
| Código de Retorno=58 Transação não Permitida |
| Código de Retorno=59 Suspeita de fraude |
| Código de Retorno=61 Limite Excedido |
| Código de Retorno=62 Cartão Bloqueado |
| Código de Retorno=63 Verifique os dados do cartão |
| Código de Retorno=65 Excedido Freqüência de Operação |
| Código de Retorno=68 Time-Out no Destino |
| Código de Retorno=75 Problema com senha (ALELO) |
| Código de Retorno=76 Cartão ou Cheque Bloqueado |
| Código de Retorno=77 Dados Inválidos |
| Código de Retorno=78 Contactar Emissor |
| Código de Retorno=80 Data Inválida |
| Código de Retorno=81 Chave de Criptografia Inválida |
| Código de Retorno=82 Problema da switch_charge_visa_debito_efetivacao (Luana |
| Código de Retorno=82/83 |
| Código de Retorno=86 Parcela Inválida |
| Código de Retorno=87 Prazo Inválido |
| Código de Retorno=90 Ambiente Indisponível |
| Código de Retorno=91 Instituição Destino Indisponível |
| Código de Retorno=RNR Serviço bloqueado para o cliente |
| Código de Retorno=Q4 Código de Segurança Inválido |
| Código de Retorno=BK Saldo Insuficiente |
| Código de Retorno=BE Senha Inválida |
| Código de Retorno=BL LIM.DIA EXCEDIDO |
| Código de Retorno=BN CTA/CARTAO BLOQ |
| Código de Retorno=U3 MSG INVALIDA |
| Código de Retorno=KB Transação não autorizada |
| Código de Retorno=M0 Número Lógico Inválido |
| Código de Retorno=MA Problema de comunicação com o PagSeguro |
| Código de Retorno=M1 Problema de comunicação no PagSeguro |
| Código de Retorno=M2 Usuário bloqueado |
| Código de Retorno=M3 Transação de estorno não encontrada, a venda original foi realizada em outro dia. Estorno só pode ser realizado no mesmo dia da venda. |
| Código de Retorno=M4 Transação não pode ser estornada, status da venda não permiti estorno |
| Código de Retorno=M5 Rejeitado na análise de fraude |
| Código de Retorno=M6 BIN na Blacklist |
| Código de Retorno=M7 Usuário inativo, ocorre quando a conta não foi ativada |
| Código de Retorno=M9 Erro imprevisto |