Tap to Pay no Android
Transforme dispositivos Android compatíveis em terminais de pagamento por aproximação com o SDK Zoop.
Transforme dispositivos Android compatíveis em terminais de pagamento por aproximação com o SDK white-label da Zoop.
Hardware, software e dados da aplicação necessários.
Solicite credenciais e configure o acesso ao SDK.
Informações sobre o ambiente de testes.
Requisitos de hardware e software
| Requisito | Detalhes |
|---|---|
| 📡 NFC | O dispositivo deve possuir suporte a NFC (Near Field Communication). |
| 📱 Sistema Operacional | SDK até 2.4.x → Android 9.0 (API 28) ou superior |
| SDK 2.5.0 em diante → Android 10 (API 29) ou superior | |
| 🌐 Conectividade | Acesso à internet para comunicação com a Zoop e validação de segurança. |
Referências externas
Requisitos da aplicação
Utilize uma versão assinada da sua aplicação (Signed APK/Bundle) para funcionamento correto em produção e testes.
São necessários os seguintes dados do seu aplicativo para a integração com o SDK:
Dado | Onde encontrar | Exemplo |
|---|---|---|
|
|
|
|
|
|
|
|
|
Certificado SHA-256 | Keystore ( |
|
Como obter o certificado SHA-256
Via terminal — Execute o comando abaixo com o arquivo da sua keystore:
keytool -printcert -jarfile keystore.jksVia Google Play Console — Se a aplicação já está em teste interno, acesse Release > Setup > App signing > App signing key certificate:
Onboarding
Entre em contato com a Zoop para solicitar as credenciais de ativação do SDK, informando os dados da sua aplicação listados na seção Requisitos da aplicação.
Canais de atendimento
📞 Telefone (segunda a sexta, 9h às 19h)
- Capitais: 4003-3261
- Demais regiões: 0800 878 8161
✉️ E-mail
Credenciais recebidas
Após o contato, você receberá as seguintes credenciais:
| Credencial | Descrição |
|---|---|
clientId | Identificador do cliente |
clientSecret | Chave secreta do cliente |
marketplace | Identificador do marketplace |
seller | Identificador do vendedor |
accessKey | Chave de acesso ao SDK |
Tipos de credenciais por role
Você receberá 3 conjuntos de clientId e clientSecret, cada um com uma finalidade específica:
Uso geral do SDK Tap to Pay, Pagamento.
clientIdclientSecret
Configuração de version codes. Seção Liberar version codes para mais detalhes.
clientIdclientSecret
Acesso à API de attestation. Seção Attestation para mais detalhes.
clientIdclientSecret
Validade e renovação
As credenciais possuem validade de 1 ano ou 5 anos. A data de expiração consta no corpo de cada arquivo. Após o vencimento, entre em contato com o suporte da Zoop para solicitar novas credenciais. É responsabilidade do cliente acompanhar a data de expiração e solicitar a renovação dentro do período vigente.
Onde verificar a data de validade das suas credenciais
Ambiente de Testes (Sandbox)
O SDK Tap to Pay conta com um ambiente de sandbox que replica o comportamento de produção, permitindo simular transações de sucesso e erro sem processar valores reais.
Teste transações sem processar valores reais.
Simule erros retornados pela adquirente controlando o valor da transação.
Valide fluxos de sucesso e tratamento de erros da sua aplicação.
Utilize a dependência de sandbox no seu projeto para que o ambiente funcione corretamente:
debugImplementation('com.zoop.sdk:taponphone-sandbox-debug:$zoopSdkVersion')Não use o SDK de produção em ambiente de sandbox — as transações não serão simuladas corretamente.
Consulte o guia completo em Ambiente de Sandbox para instruções detalhadas sobre credenciais de teste, simulação de erros por valor de transação e o fluxo de testes ponta a ponta.
Updated 6 days ago