Tap to Pay para Terceiros
Pagamentos por aproximação (contactless) em nome de lojistas, via SDK Android/iOS.
O Stone Tap to Pay para Terceiros permite que parceiros integradores ofereçam pagamentos por aproximação (contactless) em nome de lojistas, diretamente em apps Android e iOS, usando a infraestrutura de pagamentos da Stone.
Antes de transacionar em nome de um lojista, o parceiro precisa obter o consentimento desse lojista e, em seguida, ativar o produto Tap para a afiliação dele.
O que você precisa fazer?
Pedir o consentimento e ativar o Tap
Token Gerencial, Consentimento e CMA API — o fluxo completo do backend.
Configurar o SDK
Criação do SDK, setup com SetupData, sessão ativa e logout.
Integrar no Android
Configuração, venda e exemplo completo em Kotlin.
Integrar no iOS
Configuração, transação e exemplo completo em Swift.
Consultar a referência da API
Modelos de dados, eventos, status e erros do SDK.
Registrar os version codes
Registro de version codes para Play Integrity.Requisitos
- Ser um parceiro credenciado na Stone para Tap to Pay para Terceiros
- Seguir as orientações de segurança e compliance (PCI-DSS)
- Possuir os pares de credenciais válidas fornecidas pela Stone
- Consentimento aceito pelo lojista antes da ativação
| Item | Android | iOS |
|---|---|---|
| Sistema | Android 10 (API 29) ou mais novo | iOS 17 ou mais novo |
| Aparelho | NFC obrigatório; emulador não é suportado | iPhone compatível com Tap to Pay on iPhone; simulador não é suportado |
| Conta da plataforma | — | Conta Apple Developer de organização com o entitlement de Tap to Pay on iPhone (veja iOS) |
| Integridade do app | Version codes registrados na Stone (veja Version Codes) | — |
Credenciais
A Stone fornece dois pares de credenciais com propósitos distintos:
| Credencial | Propósito | Onde fica |
|---|---|---|
Credenciais Gerenciais (client_id + client_secret) | Gerar o Token Gerencial, usado para pedir consentimento ao lojista, ativar o produto Tap (CMA API) e registrar version codes | Backend do parceiro |
Credenciais Transacionais (client_id + client_secret) | Identificar o parceiro nas transações. O client_id é informado no consentimento e na ativação; o par completo é repassado ao SDK no setup() | App (dispositivo) |
Importante
As Credenciais Gerenciais ficam exclusivamente no backend do parceiro e nunca devem ser embarcadas no app. O uso de um BFF (Backend-for-Frontend) é o caminho mais recomendado.
Ambientes
| Serviço | Sandbox (SDX) | Path |
|---|---|---|
| Token Gerencial | https://sdx.api.stone.com.br | /auth/realms/payments/oauth2/token |
| Consentimento | https://sdx.api.stone.com.br | /v1/auth/consents |
| CMA API (Ativação) | https://sdx.api.stone.com.br | /v1/cma/partners/codes |
| Version Codes | https://tap-sdx.stone.com.br | /v1/partners/versions |
Dica
Para os endereços de produção, consulte a Stone. Configure a URL base como variável de ambiente para facilitar a troca entre ambientes.
No app, o ambiente é escolhido na criação do SDK (Environment.SDX ou Environment.PRODUCTION, veja Setup do SDK). O artefato do SDK também tem ambiente: a variante de testes funciona em SDX e a de produção só em produção. Usar a variante de um ambiente com o Environment do outro faz as vendas falharem.
iOS: comece pela Apple
No iOS, o parceiro também precisa do entitlement de Tap to Pay on iPhone na conta Apple dele. A aprovação da Apple é a etapa mais demorada da integração; comece por ela. Veja iOS.
Integração: Tap to Pay para Terceiros
Etapa 1 de 7