Métodos
Método | Retorno | Descrição |
---|---|---|
GetVersionLib | const char* | Retorna uma const char com a versão da biblioteca de integração. |
SetVersionName: withVersion | 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 | Int | Inicializa a comunicação bluetooth utilizando o dispositivo padrão do aparelho iOS. |
SimplePaymentTransaction: withInstallmentType: endInstallments: endAmount | 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. |
SetModel | nenhum | Seta o modelo do terminal PagSeguro que a PlugPag vai parear e conectar via bluetooth. |
SetPeripheralName | nenhum | Seta o ID do terminal PagSeguro que a PlugPag vai parear e conectar via Bluetooth (O ID pode ser encontrado ao pressionar a tecla '0' no terminal). |
SetPeripheral:withName | nenhum | Seta o modelo do terminal e o ID do terminal PagSeguro que a PlugPag vai parear e conectar via Bluetooth. |
GetListModels | NSArray (NSArray de Strings) | Retorna uma lista de modelos de terminais PagSeguro disponível para pareamento via Bluetooth. |
GetListPeripheral | NSArray (NSArray de Strings) | Retorna uma lista de terminais PagSeguro disponíveis para pareamento via Bluetooth de acordo com o modelo selecionado. Limitação: Deve ser Chamado após ter informado o modelo desejado através do método SetModel |
GetPairPeripheralStatus | Int | Retorna o status do pareamento Bluetooth, sendo 3 status possíveis: PAIR_STATE_PROCESSING, PAIR_STATE_OK ou PAIR_STATE_FAIL. |
- 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:
[[PlugPag sharedInstance] SetVersionName:@"MyApp" withVersion:@"R001"];
int ret = [[PlugPag sharedInstance] InitBTConnection];
if (ret == RET_OK) {
// Transação de 12,34
NSString * value = @"1234";
// Venda, Crédito, A Vista, R$ 12,34
ret = [[PlugPag sharedInstance] SimplePaymentTransaction:CREDIT withInstallmentType:A_VISTA andInstallments:1 andAmount:value andUserReference:@"CODIGVENDA"];
if (ret == RET_OK) {
_txtResultado.text = @"Transação realizada com sucesso";
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
[[PlugPag sharedInstance] SetVersionName:@"MyApp" withVersion:@"R001"];
int ret = [[PlugPag sharedInstance] InitBTConnection];
if (ret == RET_OK) {
// Transação de 1208,34
NSString * value = @"128034";
// A vista, 7 parcelas
int numeroParcelas = 7;
// Venda, Crédito, Parcelado Vendedor, 7 parcelas, R$ 1.208,34
ret = [[PlugPag sharedInstance] SimplePaymentTransaction:CREDIT withInstallmentType:PARC_VENDEDOR andInstallments:numeroParcelas andAmount:value andUserReference:@"CODIGVENDA"];
if (ret == RET_OK) {
_txtResultado.text = @"Transação realizada com sucesso";
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
Estornando uma Transação
Para iniciar uma transação de estorno na Moderninha, acompanhe o exemplo a seguir:
int ret = [[PlugPag sharedInstance] InitBTConnection];
if (ret == RET_OK) {
// Estorno
ret = [[PlugPag sharedInstance] CancelTransaction];
if (ret == RET_OK) {
_txtResultado.text = @"Estorno realizado com sucesso";
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
Consultando a última transação aprovada
Para consultar a última transação aprovada na Moderninha, acompanhe o exemplo a seguir:
int ret = [[PlugPag sharedInstance] InitBTConnection];
if (ret == RET_OK) {
// Consulta a última transação
ret = [[PlugPag sharedInstance] GetLastApprovedTransactionStatus];
if (ret == RET_OK) {
NSString *txDate = [PlugPag sharedInstance].date;
NSString *txTime = [PlugPag sharedInstance].time;
NSString *txHost = [PlugPag sharedInstance].hostNsu;
NSString *txCardBrand = [PlugPag sharedInstance].cardBrand;
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
}else{
_txtResultado.text = [NSString stringWithFormat:@"Erro: %d", ret];
}
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+).