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+).