These docs are for v1.0. Click to read the latest docs for v4.1.

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.

ClasseDescrição
DeviceInfoInformações sobre o aparelho (smartphone/tablet) utilizado.
PlugPagClasse principal da biblioteca. Essa classe é responsável pela configuração de comunição com os dispositivos bluetooth e pelas transações.
PlugPagAbortResultResultado obtido ao solicitar um cancelamento de operação, enquanto a operação está em andamento.
PlugPagAppIdentificationIdentificação do aplicativo.
PlugPagDeviceIdentificação do terminal ou leitor que será utilizado para as transações.
PlugPagEventDataDados de eventos gerados durante transações para atualização de eventos no aplicativo.
PlugPagPaymentDataInformações de um pagamento a ser realizado.

📘