---
title: "Modelos de Integração: Deeplink vs. Provider"
url: "https://devcenter.stone.com.br/sdk-android-modelos-de-integracao-deeplink-vs-provider"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~TW9kZWxvcyBkZSBJbnRlZ3Jhw6fDo286IERlZXBsaW5rIHZzLiBQcm92aWRlcg,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9zZGstYW5kcm9pZC1tb2RlbG9zLWRlLWludGVncmFjYW8tZGVlcGxpbmstdnMtcHJvdmlkZXIi,s_L2kBrKontPu72Qv9.png"
---

# Modelos de Integração: Deeplink vs. Provider

Para se integrar ao ecossistema Stone, você pode optar por duas abordagens distintas, dependendo do cenário do seu negócio.

### [Deeplink (Recomendado)](#deeplink-recomendado)

O Deeplink utiliza o mecanismo de `Intents` do Android para realizar a comunicação entre o seu aplicativo e o aplicativo de pagamento da Stone instalado no mesmo dispositivo.

-   **Por que usar?** Você não precisa lidar com a complexidade de telas de pagamento, lógica de leitura de cartão ou fluxos de impressão. Basta enviar os dados básicos da transação e o app da Stone cuida de todo o resto, devolvendo o resultado para o seu app.
-   **Ideal para:** Integrações rápidas, seguras e que queiram utilizar a interface padrão da Stone.

Atenção

A funcionalidade de Deeplink está disponível apenas para os terminais POS Android disponibilizados pela Stone.

### [Provider](#provider)

O modelo de Provider baseia-se em um padrão de projeto que define um contrato direto entre a API do SDK e a camada de dados/lógica da sua aplicação.

-   **Como funciona?** Todos os providers estendem uma classe modelo que herda da AsyncTask do Android. Isso significa que a comunicação com o terminal e as chamadas de rede ocorrem em background (segundo plano).
-   **Retorno (Callbacks):** Ao final da execução, o provider aciona um Callback na sua aplicação informando o status (Sucesso, Erro ou Próximo Passo).
-   Feedback Visual: Como a execução ocorre em background, é **\_obrigatório \_**exibir um indicador de progresso (como um dialog ou spinner) para o usuário.

### [Recomendação de Arquitetura: Aplicação Híbrida](#recomendação-de-arquitetura-aplicação-híbrida)

Para garantir a melhor experiência de desenvolvimento e manutenção, nossa recomendação oficial é a Abordagem Híbrida:

1.  **Use o Deeplink como base:** Utilize o Deeplink para todas as operações padrão (Pagamento, Cancelamento, Impressão). Isso reduz drasticamente o seu tempo de desenvolvimento e o risco de bugs.
2.  **Use o Provider como exceção:** Caso o seu negócio exija alguma funcionalidade específica que esteja disponível apenas via Provider, implemente o Provider isoladamente para essa função.

Dessa forma, você cria uma aplicação robusta, aproveitando a simplicidade do Deeplink onde for possível e o poder do Provider onde for estritamente necessário.

---

**Jornada: [Entender a SDK Android](https://devcenter.stone.com.br/sdk-android-o-que-e-a-sdk-android)**  
Etapa 7 de 10

[**Etapa anterior**Introdução](https://devcenter.stone.com.br/sdk-android-bem-vindo-sdk-android)[**Próxima etapa**Dispositivos Suportados](https://devcenter.stone.com.br/sdk-android-dispositivos-suportados)

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.