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

Guide - Moderninha Pro - Android

É um terminal de pagamento GPRS/3G, sem fio, que aceita cartões de crédito e débito, e integrações com tecnologia com Wi-Fi, Bluetooth e NFC. Permite fácil integração com os sistemas de automação comercial em várias plataformas.

Visão Geral

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

Versão

Antes de iniciar, entre no Menu e verifique a versão do firmware conforme as imagens abaixo:

980

Caso sua Moderninha PRO não esteja na versão 3.11.x (ou superior), basta iniciar a atualização manual através da opção menu > configurações gerais > atualização.

Pareando a sua Moderninha Pro

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

É importante destacar que a sua aplicação precisa identificar o MacAddress Bluetooth da Moderninha Pro com a qual se deseja comunicar, pois esta informação será utilizada durante o processo.

📘

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

Não é necessário qualquer forma de autenticação (login). A identificação de usuário é feita diretamente na Moderninha Pro.

Ainda não tem a sua Moderninha Pro? 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 {
       jcenter()
       maven {
            url 'https://github.com/pagseguromaster/plugpag/raw/master/android'
       }
}

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

dependencies {
    ...
    compile 'br.uol.pagseguro.client:btserial:1.1.0'
    compile 'br.uol.pagseguro.client:plugpag:1.1.0'
    ...
}

Também é importante informar que esta biblioteca não necessita de nenhum tipo de autenticação com login e senha pois a Moderninha já está autenticada e vinculada a uma conta PagSeguro.

Dados

public class PlugPag {

   public static final int RET_OK;
   public static final int BUFF_SIZE;
   public static final int NULL_PTR;
   public static final int POS_NOT_READY;
   public static final int TRANS_DENIED;
   public static final int DATA_INV_RESULT_MESSAGE;
   public static final int INV_AMOUNT_PARAM;
   public static final int INV_TOT_AMOUNT_PARAM;
   public static final int INV_USER_REF_PARAM;
   public static final int INV_TRS_RESULT_PARAM;
   public static final int DRIVER_NOT_FOUND;
   public static final int DRIVER_FUNCTION_ERROR;
   public static final int JNI_EXIT_EXCEPTION;

   public static final int CREDIT = 1;
   public static final int DEBIT = 2;
   public static final int VOUCHER = 3;

   public static final int A_VISTA = 1;
   public static final int PARC_VENDEDOR = 2;
}