Providers - Moderninha WIFI - Android

Métodos

Método	Retorno	Descrição
`GetVersionLib`	String	Retorna uma string null terminated com a versão da biblioteca de integração.
`SetVersionName`	Int	Seta 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.
`InitBTConnection`	Nenhum	Inicializa a comunicação bluetooth utilizando o dispositivo padrão do aparelho Android.
`SimplePaymentTransaction`	Int	Inicia a transação de venda. Em caso de sucesso, retorna os dados da transação numa estrutura.
`CancelTransaction`	Int	Inicia a transação de estorno. Em caso de sucesso, retorna os dados da transação numa estrutura
`GetLastApprovedTransactionStatus`	Int	Verifica qual foi a última transação com sucesso feita pelo terminal.
`getRawBuffer`	Byte[]	Retorna o buffer recebido como resultado da última comunicação via bluetooth.
`getMessage`	Nenhum	Retorna a mensagem resultante da transação (ISO-8859-1/Latin-1).
`getTransactionCode`	String	Retorna o transaction code obtido pela última chamada de SimplePaymentTransaction ou GetLastApprovedTransaction.
`getDate`	String	Retorna a data da transação da última chamada de SimplePayment ou GetLastApprovedTransaction no formato “yyyy-mm-dd”.
`getTime`	String	Retorna a hora da transação da última chamada de SimplePayment ou GetLastApprovedTransaction no formato “hh:mm:ss”
`getHostNsu`	String	Retorna o NSU do host obtido pela última chamada de SimplePaymentTransaction, GetLastApprovedTransaction ou CancelTransaction.
`getCardBrand`	String	Retorna a bandeira do cartão da transação da última chamada de SimplePayment ou GetLastApprovedTransaction.
`getBin`	String	Retorna os 6 primeiros dígitos do cartão da última transação de sucesso.
`getHolder`	String	Retorna os 4 últimos dígitos do cartão da última transação de sucesso.
`getTerminalSerialNumber`	String	Retorna 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+).