SDK Android
Biblioteca white-label que transforma dispositivos Android compatíveis em terminais de pagamento por aproximação. Pode ser embarcada em qualquer aplicação, com total controle sobre a jornada do usuário.
Vamos Começar
Para utilizar o Tap to Pay no Android, é necessário integrar a versão mais recente do SDK Zoop para Android.
Antes de iniciar, recomendamos se familiarizar com a biblioteca e realizar a configuração inicial do seu projeto.
Você de entrar em contato com a Zoop para solicitar as credenciais de ativação do SDK. Para isso, é necessário informar os seguintes dados da sua aplicação.
- versionName
- versionCode
- packageName
- Certificado SHA-256 da sua chave de assinatura (keystore.jks)
Consulte este link para acessar as instruções completas.
Dispositivos compatíveis com Android
O Tap to Pay no Android é compatível com uma gama de dispositivos, incluindo smartphones, tablets, quiosques e terminais portáteis. No entanto, para garantir a segurança e o funcionamento adequado, apenas dispositivos que atendam todos os criterios abaixo podem ser utilizados:
- Possuir sensor NFC integrado e funcional
- Não estar com root ativo e ter o bootloader bloqueado
- Executar Android 9 ou superior
- Ter os Google Mobile Services (GSM) habilitado e o app Google Play Store instalado
- Contar com keystore com suporte de hardware
- Suportar a geração de chaves RSA e AES via Android Keystore
- Ter conexão de internet estável
- Executar o sistema operacional oficial do fabricante, sem modificações ou ROM's customizadas
Emuladores de Android não são suportados.
Dispositivos suportados
A seguir, listamos alguns dos dispositivos Android atualmente compatíveis com o SDK Tap to Pay. Essa lista não é definitiva, e outros modelos que atendam aos requisitos técnicos também podem ser utilizados.
IU da Zona de toque NFC específica do dispositivo
O SDK Tap to Pay no Android suporta uma experiência de usuário específica do dispositivo. Ele indica dinamicamente ao usuário final a localização da zona de toque no aparelho.
Celulares Compatíveis
Fabricante | Modelos |
|---|---|
Asus | Zenfone 9 |
Google Pixel | 2 XL, 3, 3 XL, 3a, 4, 4a, 5, 5a, 6, 6 Pro, 6a, 7, 7a, 7 Pro, 8, 8 Pro, 8a, |
Nokia | G22, G60, X10, X30 |
Honor | 70, 90, 90 Lite, Magic5 Lite, Magic6 Pro, Magic6 Lite, X6a, X6b, X7, |
Huawei | P30 Pro |
Infinix | Hot 40 Pro |
LG | V60 ThinQ |
Motorola | Edge 5G UW, G, G Stylus 5G, G9 Play, G34, G54, G84 |
OnePlus | Nord N200, Nord CE, Nord N30, 12R, 6T |
Oppo | A60, A98, Find X2 Pro, Find X2 Lite, Find X3 Pro, Find X5 Pro, |
Samsung Galaxy | A04s, A10, A12, A13, A14, A15, A20e, A21s, A22, A23, A24, A31, |
Xiaomi | Redmi 10, Redmi 12, Redmi 12C, Redmi 13C, Redmi Note 9 Pro, Note 10 Pro, |
Tablets Compatíveis
| Fabricante | Modelos |
|---|---|
| Samsung | Galaxy Tab Active Pro, Active3, Active4 Pro, Active5 |
| HMD Global | HDM T21 |
| Hosoton | H101 |
| Oukitel | RT3 |
| Ulefone | Armor Pad Pro |
UX
O SDK do Android permite personalizar a experiência do usuário (UX) padrão da tela "Tap to Pay". Isso inclui a modificação das cores da área de toque, mensagens de erro, animações de sucesso e a posição do indicador da área de toque.
Para aplicar essas personalizações, chame o método durante a inicialização.
Para um exemplo de personalização de UX, consulte o exemplo fornecido.
Como integrar
Item | Passos | Descrição |
|---|---|---|
1 | Baixe o SDK | Disponível via: |
2 | Configure seu projeto | Observe as dicas no Link |
3 | Libere a versão do aplicativo | Via API |
4 | Configure o terminal | Via SDK, configure a tela de aproximação do cartão, veja parâmetros aqui |
5 | Inicialize o terminal | Via SDk Sugerimos que essas informações seja mantidas no em seu backend. |
6 | Inicie uma transação | Via SDK |
7 | Confirme o pagamento | Via : |
8 | Pós venda: Cancelar/estorno | Via APIs |
Atualizações do SDK Tap to Pay
A Zoop lança atualizações periodicamente, que podem incluir novas funcionalidades, correções de bugs e atualizações de segurança. Atualize seu SDK assim que uma nova versão estiver disponível. Os SDKs atualmente disponíveis são:
Ambiente de Testes (Sandbox)
- Não há sandbox público.
- As credenciais são provisionadas sob demanda.
Updated 26 days ago