Guide - Minizinha - Android

É um leitor de pagamento, sem fio, que aceita cartões de crédito e débito, e integrações com tecnologia Bluetooth. Permite fácil integração com os sistemas de automação comercial em várias plataformas.

Visão Geral

Se você tem um aplicativo Android e quer fazer vendas a partir dele usando a sua Minizinha, o PlugPag é a solução ideal. Com ele você consegue conectar o seu app à Minizinha e realizar cobranças através do PagSeguro.

📘

Observações

A biblioteca PlugPag possui suporte para API level 16 (4.1 Jelly Bean) à 26 (8.0 Oreo)
Não é possível fazer chamadas da biblioteca caso o usuário tenha permissões de root no aparelho por motivos de segurança.

Pareando a sua Minizinha

É muito simples. Tudo o que você precisa fazer para começar é parear via Bluetooth o seu dispositivo Android e a Minizinha. Estando os dois pareados, podemos começar a integração.

📘

Para tornar o bluetooth da Minizinha visível, basta apertar a tecla '0'.

Ainda não tem a sua Minizinha? Adquira a sua agora em https://loja.pagseguro.uol.com.br/

Importando a biblioteca

Todas as chamadas que você verá nos próximos passos são efetuadas utilizando uma biblioteca exclusiva para android, que deverá ser importada em seu projeto.

Primeiramente é necessário configurar o repositório da biblioteca no arquivo build.gradle localizado na raiz do projeto. Nele adicione as linhas destacadas abaixo:

repositories {
       ...
       maven {
            url 'https://github.com/pagseguromaster/plugpag/raw/master/3.x/android'
       }
       ...
}

Em seguida inclua a linha abaixo no arquivo build.gradle do módulo de seu projeto:

dependencies {
  ...
   implementation 'com.android.support:design:27.1.0'
   implementation 'br.com.uol.pagseguro:plugpag:3.0.0'
   ...
}

Permissões

Para integrar com a biblioteca PlugPag é necessário adicionar algumas permissões no arquivo AndroidManifest.xml:

Permissões obrigatórios

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

Permissões opcionais

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

Essas permissões permitem à biblioteca obter coordenadas no momento da transação. Essas coordenadas são enviadas aos servidores do PagSeguro e ajudam a melhorar nossos serviços.

Activity

Algumas funcionalidades da biblioteca PlugPag necessitam que uma Activity seja iniciada.

Para isso, é necessário incluir o trecho abaixo:

<application ...>
  ...
  <activity
    android:name="br.com.uol.pagseguro.plugpag.PlugPagActivity" />
 ...
</application>

Classes

A biblioteca PlugPag é composta de um conjunto de classes. A classe principal chama-se PlugPag, mas é necessário utilizar classes auxiliares para configurações e trocas de informações.

Segue abaixo uma lista com classes que compõe a biblioteca.

📘

• Para mais detalhes você pode baixar a documentação completa