--- title: "Tap to Pay para Terceiros" url: "https://devcenter.stone.com.br/tap-to-pay" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Tap+to+Pay+para+Terceiros,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii90YXAtdG8tcGF5Ig,s_WXWSQZHUOAoupUtR.png" --- # 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?](#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](#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](#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](#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](https://devcenter.stone.com.br/tap-to-pay-sdk-setup)). 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](https://devcenter.stone.com.br/tap-to-pay-ios). --- **Integração: [Tap to Pay para Terceiros](https://devcenter.stone.com.br/tap-to-pay)** Etapa 1 de 7 [**Próxima etapa**Consentimento e Ativação](https://devcenter.stone.com.br/tap-to-pay-consent-activation) Siga a Stone nas redes sociais [](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ) © Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57 Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.