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, 9 Pro, 9 Pro XL |
| Nokia | G22, G60, X10, X30 |
| Honor | 70, 90, 90 Lite, Magic5 Lite, Magic6 Pro, Magic6 Lite, X6a, X6b, X7, X7b, X8 |
| 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, Reno5, Reno 7, Reno8, Reno10 Pro, Reno12 Pro |
| Samsung Galaxy | A04s, A10, A12, A13, A14, A15, A20e, A21s, A22, A23, A24, A31, A32, A33, A34, A40, A51, A52, A52s, A53, A54, A55, A70, A71, F23, M52, Note9, Note10+, Note20, Note20 Ultra, S9, S9+, S10, S10+, S10e, S20, S20 FE, S20+, S20 Ultra, S21, S21+, S21+ Plus, S21 Ultra, S21 FE, S22, S22+, S22 Ultra, S23, S23+, S23 FE, S23 Ultra, S24, S24+, S24 Ultra |
| Xiaomi | Redmi 10, Redmi 12, Redmi 12C, Redmi 13C, Redmi Note 9 Pro, Note 10 Pro, Note 11, Note 11 Pro, Note 13 Pro, 11T Pro, 11 Lite, 12T, 13T 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: - Maven (Android) |
| 2 | Configure seu projeto | Observe as dicas no Link |
| 3 | Libere a versão do aplicativo | Via API Utilizando as Credenciais CSO enviados pelo nosso time. Siga os passos para que a versão do aplicativo na apples store esteja liberada para aceitar captura dos dados do cartão no NFC |
| 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 Será necessário o clientId, clientSecret e accessKey Sugerimos que essas informações seja mantidas no em seu backend. |
| 6 | Inicie uma transação | Via SDK |
| 7 | Confirme o pagamento | Via : - Webhook - SDK |
| 8 | Pós venda: Cancelar/estorno de pagamento | 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 2 days ago