---
title: "Pré-requisitos"
url: "https://devcenter.stone.com.br/sdk-android-android-sdk-pre-requisitos"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~UHLDqS1yZXF1aXNpdG9z,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9zZGstYW5kcm9pZC1hbmRyb2lkLXNkay1wcmUtcmVxdWlzaXRvcyI,s_CvKdLV4g7RB7g6QZ.png"
---

# Pré-requisitos

Para que você consiga integrar com o SDK Android da Stone é necessário seguir alguns requisitos técnicos.

-   Nosso SDK é desenvolvido nativamente no sistema Android, por isso sua aplicação precisa ser Android também ou, caso ela seja desenvolvida com uma plataforma híbrida, é necessário uma interface ou plugin que permita essa comunicação.

Sua aplicação precisa **ter a versão do 6.0+ do Android (API 23), ou superior**.

**Versão S.O Android**  
Os hardwares utilizados pela Stone possuem diferentes versões do sistema operacional, definição aplicada pela respectiva fabricante:

-   GPOS 700X - v8.1
-   Positivo L400 - v11
-   Positivo L300 - v7.1
-   Sunmi P2-B - v7.1

Muito importante basear seu desenvolvimento pensando em uma retro compatibilidade com a menor versão (6.0), assim você garante a utilização em todos os modelos.

**Tamanho do APK**  
O app pode ter no máximo 70MB, por conta de boas práticas de gerenciamento de espaço e banda larga (3G/4G) dos terminais SmartPOS.

Caso você queira utilizar mais de um dispositivos, aconselhamos a usar o mecanismo de [Flavors](https://developer.android.com/studio/build/build-variants?hl=pt-br) do Android.

Atenção!

A comunicação de URLs externas com Stone só é possível com protocolo de segurança, ou seja, qualquer URL, domínios ou site externo a Stone deve conter **HTTPS**.  
Protocolo de segurança mínimo aceito é o **TLS 1.2**

Fique atento ao fim de sua integração, o time de integrações solicitara a relação de URLs para inserção na whitelist.

## [Requisito Mandatórios!](#requisito-mandatórios)

1.  Suporte mínimo à versão **6.0 + do Android (API 23)**, ou superior.
    1.  Caso utilize uma versão mais atual, lembre-se de sempre desenvolver pensando na **retrocompatibilidade** da aplicação.
2.  O desenvolvimento do aplicativo pode ser nativo ou híbrido, mas em caso de híbrido é necessário que sua linguagem ou framework consiga fazer o download das bibliotecas da SDK utilizando o [Gradle](https://gradle.org/), ou ferramenta que acesse nosso repositório no [PackageCloud](https://packagecloud.io/).
3.  O aplicativo deve possuir uma seção de "**Fale Conosco**" informando ao cliente os contatos necessários para atendimento em caso de problemas ou dúvidas. Essa seção deve estar bem visível e de fácil acesso.
4.  Utilizar layout dinâmico/responsivos considerando que no futuro o aplicativo pode ser instalado em outros hardwares com resoluções e densidades diferentes.
5.  O aplicativo deve estar utilizando o SDK Android Stone.
6.  Deve ser possível navegar por todas as telas sem o aplicativo "quebrar".
7.  Caso você queira utilizar mais de um dispositivo, aconselhamos a usar o mecanismo de [Flavors](https://developer.android.com/studio/build/build-variants?hl=pt-br) do Android.
8.  Sua aplicação precisa estar assinada digitalmente antes de ser instalada em um dispositivo ou atualizada. Conforme o fluxo de [Assinatura do Google](https://developer.android.com/studio/publish/app-signing?hl=pt-br).
9.  O packageName deve ter o seguinte padrão:  
    **“br.com.NomeEmpresaParceira.NomeApp.Campolivre”**
    1.  **Nome da sua empresa**
    2.  **Nome do seu app**
    3.  **Livre**
        1.  Não deve conter referência a concorrentes do Grupo Stone.
        2.  Não deve conter o nome Stone;
        3.  Não deve conter nome de fabricantes de terminais ou modelos do terminal.
10.  Dados como VersionName, VersionCode devem seguir o padrão google de utilização e os seguintes requisitos:
     1.  versionCode: O valor deverá ser um número inteiro positivo.
     2.  versionName: nesta configuração, só aceita números e o caractere "ponto". O tamanho máximo para esse campo é 12 caracteres.
11.  Suporte mínimo:
     1.  Kotlin: **2.0.0** ou superior.
     2.  Koin: **4.0.0** ou superior.

Guia do Desenvolvedor SDK Android

Para maiores informações acessar o doc: [Guia do Desenvolvedor SDK Android](https://docs.google.com/document/d/1imAavwSGi_Y6onLMqlZlr9LX1cSb7XrDAhhCa6kVkQM/edit?usp=sharing)

---

**Jornada: [Começar a integrar](https://devcenter.stone.com.br/sdk-android-evolua-ao-nosso-lado)**  
Etapa 6 de 14

[**Etapa anterior**Pré requisitos](https://devcenter.stone.com.br/sdk-android-sdk-android-pre-requisitos)[**Próxima etapa**App Demo SDK Providers](https://devcenter.stone.com.br/sdk-android-faq-duvidas-frequentes)

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.