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

Providers - Moderninha WIFI - Android

Métodos

MétodoRetornoDescrição
GetVersionLibStringRetorna uma string null terminated com a versão da biblioteca de integração.
SetVersionNameIntSeta o nome e versão da aplicação que está utilizando a PlugPag. É MANDATÓRIO que esta função seja chamada antes de se realizar qualquer transação.
InitBTConnectionNenhumInicializa a comunicação bluetooth utilizando o dispositivo padrão do aparelho Android.
SimplePaymentTransactionIntInicia a transação de venda. Em caso de sucesso, retorna os dados da transação numa estrutura.
CancelTransactionIntInicia a transação de estorno. Em caso de sucesso, retorna os dados da transação numa estrutura
GetLastApprovedTransactionStatusIntVerifica qual foi a última transação com sucesso feita pelo terminal.
getRawBufferByte[]Retorna o buffer recebido como resultado da última comunicação via bluetooth.
getMessageNenhumRetorna a mensagem resultante da transação (ISO-8859-1/Latin-1).
getTransactionCodeStringRetorna o transaction code obtido pela última chamada de SimplePaymentTransaction ou GetLastApprovedTransaction.
getDateStringRetorna a data da transação da última chamada de SimplePayment ou GetLastApprovedTransaction no formato “yyyy-mm-dd”.
getTimeStringRetorna a hora da transação da última chamada de SimplePayment ou GetLastApprovedTransaction no formato “hh:mm:ss”
getHostNsuStringRetorna o NSU do host obtido pela última chamada de SimplePaymentTransaction, GetLastApprovedTransaction ou CancelTransaction.
getCardBrandStringRetorna a bandeira do cartão da transação da última chamada de SimplePayment ou GetLastApprovedTransaction.
getBinStringRetorna os 6 primeiros dígitos do cartão da última transação de sucesso.
getHolderStringRetorna os 4 últimos dígitos do cartão da última transação de sucesso.
getTerminalSerialNumberStringRetorna o número de série da Moderninha que realizou a última transação.

📘

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

Efetuando uma Solicitação de Pagamento

Para efetuar uma chamada para a Moderninha, você deve utilizar o método SimplePaymentTransaction. Veja abaixo alguns exemplos de uma solicitação de venda:

int ret;

    //  Transação de 12,34
    String amount = "1234";

    //  A Vista, 7 Parcelas
    int installmentType = PlugPag.A_VISTA;
    int installment = 1;


    //  Transação crédito
    int method = PlugPag.CREDIT;

    //  Meu código de venda é “CODIGVENDA”
    String codigoVenda = ”CODIGVENDA”;


    PlugPag plugPag = new PlugPag();
    plugPag.InitBTConnection();
    pugPag.SetVersionName("MyApp", "R001");


    ret = plugPag.SimplePaymentTransaction(
            method,
            installmentType,
            installment,
            amount,
            codigoVenda);

    String date = plugPag.getDate();
    String time = plugPag.getTime();
    String cardBrand = plugPag.getCardBrand();
int ret;

    //  Transação de 1208,34
    String amount = "128034";

    //  A Vista, 7 Parcelas
    int installmentType = PlugPag.PARC_VENDEDOR;
    int installment = 7;


    //  Transação crédito
    int method = PlugPag.CREDIT;

    //  Meu código de venda é “CODIGVENDA”
    String codigoVenda = ”CODIGVENDA”;


    PlugPag plugPag = new PlugPag();
    plugPag.InitBTConnection();

    pugPag.SetVersionName("MyApp", "R001");

    ret = plugPag.SimplePaymentTransaction(
            method,
            installmentType,
            installment,
            amount,
            codigoVenda);

    String date = plugPag.getDate();
    String time = plugPag.getTime();
    String cardBrand = plugPag.getCardBrand();

Estornando uma Transação

Para iniciar uma transação de estorno na Moderninha, acompanhe o exemplo a seguir:

PlugPag plugPag = new PlugPag();

plugPag.InitBTConnection();

ret = plugPag.CancelTransaction();

Consultando a última transação

Para consultar a última transação na Moderninha, acompanhe o exemplo a seguir:

PlugPag plugPag = new PlugPag();

plugPag.InitBTConnection();

ret = plugPag.GetLastApprovedTransactionStatus ();

String date = plugPag.getDate();
String time = plugPag.getTime();
String cardBrand = plugPag.getCardBrand();
String hostNsu = plugPag.getHostNsu();

📘

Caso exista uma transação em andamento no momento da consulta, a função GetLastApprovedTransactionStatus() aguarda a finalização da transação e retorna os dados desta se aprovada (nessessário biblioteca 1.3.0+ e moderninha 3.12+).