Pré-requisitos¶
Essa documentação tem como referência a versão corrente como mínima do Pix API.
Warning
Para ter acesso as novas funcionalidades da Api Pix, recomenda-se a migração do SDK antigo para o novo. Veja o guia de migração aqui.
IDE¶
Android Studio¶
Recomendamos a utilização do Android Studio
Terminal físico¶
Chaves (Desenvolvimento/Produção)¶
Para iniciar o desenvolvimento, é necessário utilizar um terminal físico com chaves válidas de desenvolvimento ou produção.
Chaves de desenvolvimento (DEV): devem ser utilizadas quando o objetivo for desenvolver e testar novos aplicativos.
Chaves de produção (PROD): devem ser utilizadas quando o objetivo for capturar transações com aplicações já existentes em ambiente produtivo.
As chaves devem ser adquiridas diretamente com os fabricantes dos terminais.
Terminais homologados
Warning
Atualmente, a integração não é compatível com emuladores Android nem com smartphones. Essa solução foi desenvolvida exclusivamente para terminais POS Smart. (Point Of Service).
Portal da PayStore¶
Cadastros (Facilitador, Estabelecimento, Terminal)¶
É necessário acessar o Portal da PayStore ambiente de desenvolvimento para esse primeiro contato e realizar os cadastros necessários para inicializar o terminal pela primeira vez. Nesse processo entre em contato com a equipe de suporte.
APKs PayStore necessários¶
Sequência de Instalação¶
Os aplicativos PayStore devem estar instalados no terminal. A instalação deve ser feita na seguinte ordem:
| Aplicativos | Descrição |
|---|---|
| 1. payments (Pagamentos) | Operações de pagamento. |
| 2. App Pix | Aplicativo do Pix. |
| 3. platform (Terminal) | Gerenciar terminal |
| 4. acquirer (Adquirente) | Integração com as adquirentes |
| 5. client (Loja) | Loja PayStore |
Warning
Para garantir o funcionamento adequado, é essencial que a versão do aplicativo Pix instalado seja superior ou igual à versão 1.2.0.0.
Para mais informações sobre as aplicações da PayStore, veja Apks PayStore
Info
Com o ADB devidamente instalado e configurado na sua máquina, abra o prompt dentro do diretório com os arquivos, e execute o comando conforme ordem acima:
adb install -r [arquivo]
Se preferir utilize o programa PayDroid
Inicializar o terminal¶
Inicialização PayStore¶
Warning
Para continuar é importante que, nesse ponto, seu terminal já esteja inicializado com a PayStore. Caso tenha dúvidas sobre esse procedimento, entre em contato com a equipe de suporte
Tour pela documentação¶
Ler a documentação¶
Antes de iniciar de fato, é importante conhecer quais ferramentas estão disponíveis para o desenvolvimento. Por isso deve-se entender a arquitetura, os aplicativos envolvidos e como eles se comunicam. Veja as Referências API e explore todo o poder dessa integração.
Aplicações de Exemplo¶
App Pix Demo Android¶
Para facilitar sua integração, criamos um projeto demo desenvolvido em Android já integrado com app Pix. Explore esse projeto para visualizar a integração em ação.
Iniciar Integração¶
Parabéns!¶
Se você chegou até aqui, é porque já possui todas as informações necessárias para iniciar o desenvolvimento do seu aplicativo integrado à nossa solução de pix. Caso tenha dúvidas, entre em contato com a equipe de suporte.
