PlugPagService Wrapper

O PlugPagServiceWrapper é uma biblioteca para integrar aplicativos Android com o terminal Moderninha Smart do PagSeguro, permitindo o uso das soluções embarcadas no POS.

Sua utilização simplifica o desenvolvimento ao oferecer funcionalidades como formas de pagamento, impressão livre e uso do NFC, sem que seja necessário desenvolver essas funcionalidades do zero. Basta realizar as chamadas da API de forma simplificada.

Para acessar as funcionalidades de pagamento do PagBank ao desenvolver sua aplicação, você utilizará uma API. Todas as funcionalidades dessa API disponibilizada pelo PagBank estão concentradas na biblioteca PlugPagServiceWrapper. Portanto, é necessário importar essa biblioteca ao desenvolver sua aplicação Android.

Além disso, para que a integração com o SDK funcione corretamente, os seguintes aplicativos/serviços devem estar instalados no terminal Smart:

• PlugPagService: Esse serviço é composto por um conjunto de classes que permite realizar:
  • Ativação e desativação do terminal
  • Transações e estornos
• TerminalLib Service: Esse serviço é composto por um conjunto de classes que permite realizar:
  • Impressão livre
  • Leitura e escrita em cartões MIFARE (também conhecido como cashless)
  • Reboot do dispositivo

Importação da biblioteca PlugPagServiceWrapper

Os passos para importar a biblioteca PlugPagServiceWrapper são apresentados a seguir:

1. Inserir no arquivo build.gradle do projeto a URL do repositório Maven do PlugPag:
   JavaScript

   allprojects {  
    repositories {  
     ...  
     maven {  
      url 'https://github.com/pagseguro/PlugPagServiceWrapper/raw/master' 
     }  
     ...  
    }  
   }
   

2. Inserir as dependências no arquivo build.gradle da aplicação:
   JavaScript

   dependencies {  
       ...  
       implementation 'com.android.support:design:28.0.0'
    		implementation 'br.com.uol.pagseguro.plugpagservice.wrapper:wrapper:1.27.2'
   		...
   }
   

3. Garantir que a versão da dependência com.android.support:design seja a mesma utilizada para as demais dependências com.android.support. A versão 28.0.0 é a mais recente no momento da edição deste documento.

Para mais informações sobre as funcionalidades da biblioteca PlugPagServiceWrapper, acesse a página de Providers. Também disponibilizamos uma página com exemplos de implementação, contendo várias rotinas que podem ser utilizadas na integração com a SmartPOS.

<intent-filter>
      <action android:name="br.com.uol.pagseguro.PAYMENT"/>
      <category android:name="android.intent.category.DEFAULT"/>
</intent-filter>

Adicionando permissões ao AndroidManifest.xml

Para integrar a biblioteca PlugPagService em aplicativos Android, é necessário adicionar a permissão ao AndroidManifest.xml. Essa permissão permite que a biblioteca realize o bind ao PlugPagService, serviço embarcado da SmartPOS responsável por gerenciar todas as transações de pagamento.

<uses-permission android:name="br.com.uol.pagseguro.permission.MANAGE_PAYMENTS"/>

Para que seu aplicativo possa ser escolhido como aplicativo padrão de pagamento e receber Intents de inserção de cartão, é necessário adicionar o seguinte código no AndroidManifest.xml, dentro da Activity principal, conforme apresentado abaixo.

<intent-filter>
      <action android:name="br.com.uol.pagseguro.PAYMENT"/>
      <category android:name="android.intent.category.DEFAULT"/>
</intent-filter>

Demo SmartPOS

Para melhorar a compreensão de integração de um aplicativo na SmartPOS, o PagBank disponibiliza uma aplicação demo que você pode baixar e explorar. Nessa aplicação você encontra as principais chamadas a biblioteca PlugPagService Wrapper existentes hoje.
Para maiores informações relacionadas as funcionalidades da PlugPagService, acessa a página de Providers, onde todas as classes são disponibilizadas. Você também pode explorar mais informações relacionadas ao SDK do PagBank acessando o seu repositório no GitHub.