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

Providers - Minizinha - iOS

Métodos

MétodosRetornoDescrição
getVersionLibcharRetorna uma String com a versão da biblioteca PlugPag.
setInitBTConnection:PlugPagTransactionResultConfigura a conexão bluetooth utilizando os dados de deviceInformation.
isAuthenticatedBOOLVerifica se há um usuário autenticado.
invalidateAuthenticationvoidInvalida uma autenticação. Equivalente a realizar um logout
requestAuthenticationvoidSolicita autenticação. Uma UIViewController é executada no device para autenticação na conta PagSeguro.
doPaymentPlugPagTransactionResultInicia a transação de venda. Em caso de sucesso, retorna os dados da transação no objeto PlugPagTransactionResult.
voidPaymentPlugPagTransactionResultInicia a transação de estorno. Em caso de sucesso, retorna os dados da transação no objeto PlugPagTransactionResult.
getLastApprovedTransactionPlugPagTransactionResultRecebe dados da última transação finalizada com sucesso pelo terminal.
abortPlugPagAbortResultSolicita o cancelamento da operação atual. O cancelamento da transação não ocorre instantaneamente, pois depende das ações que estão sendo executadas.
plugPagAppIdentification: withVersionintDefine o nome e a versão do aplicativo que está integrando com o PlugPag
startScanForPeripheralsvoidInicia o processo de scanner para encontrar maquinas PagSeguro que estejam próximas.
pairPeripheralvoidInicia o processo de pareamento com a máquina PagSeguro informada por parametro
setDelegateStringDefine o delegate do destinatário para um determinado objeto.
peripheralDiscovervoidDelegate disparado após a PlugPag encontrar uma nova máquina PagSeguro próxima durante o scanner
userEventsInterfacevoidDelegate disparado contendo os eventos durante uma transação com pinpad.
pairPeripheralStatusvoidDelegate disparado contendo o resultado do pareamento do device iOS com a máquina PagSeguro.

Efetuando uma Solicitação de Pagamento

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

PlugPagDevice *device = [PlugPagDevice new]; // configura a maquina que realizara a transação
device.mPeripheralName = @"PRO-68000001";

[[PlugPag sharedInstance] plugPagAppIdentification:@"MyApp" withVersion:@"R001"];
PlugPagTransactionResult *ret = [[PlugPag sharedInstance]
setInitBTConnection:device];

if (ret.mResult == RET_OK) {

  NSString *value = @"1234"; // Transação de R$ 12,34
  int numeroParcelas = 1; // Venda, Crédito, A Vista, R$ 12,34
  PlugPagPaymentData *data = [PlugPagPaymentData new];
  data.mType = CREDIT;
  data.mAmount = [value intValue];
  data.mInstallmentType = A_VISTA;
  data.mInstallment = numeroParcelas;
  data.mUserReference = @"CODIGVENDA";

  PlugPagTransactionResult *result = [[PlugPag sharedInstance] doPayment:data];

  if (result.mResult == RET_OK) {
    NSLog(@"%@", result.mMessage);
  }
}
PlugPagDevice *device = [PlugPagDevice new]; // configura a maquina que realizara a transação
device.mPeripheralName = @"PRO-68000001";

[[PlugPag sharedInstance] plugPagAppIdentification:@"MyApp" withVersion:@"R001"];
PlugPagTransactionResult *ret = [[PlugPag sharedInstance]
setInitBTConnection:device];

if (ret.mResult == RET_OK) {

  NSString *value = @"128034"; // Transação de R$ 1.208,34
  int numeroParcelas = 7; // Venda, Crédito, Parcelado Vendedor, 7 parcelas, R$ 1.208,34
  PlugPagPaymentData *data = [PlugPagPaymentData new];
  data.mType = CREDIT;
  data.mAmount = [value intValue];
  data.mInstallmentType = PARC_VENDEDOR;
  data.mInstallment = numeroParcelas;
  data.mUserReference = @"CODIGVENDA";

  PlugPagTransactionResult *result = [[PlugPag sharedInstance] doPayment:data];

  if (result.mResult == RET_OK) {
    NSLog(@"%@", result.mMessage);
  }
}

Estornando uma Transação

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

PlugPagDevice *device = [PlugPagDevice new]; // configura a maquina que realizara a transação
device.mPeripheralName = @"PRO-68000001";

[[PlugPag sharedInstance] plugPagAppIdentification:@"MyApp" withVersion:@"R001"];
PlugPagTransactionResult *ret = [[PlugPag sharedInstance]
setInitBTConnection:device];

if (ret.mResult == RET_OK) {

  PlugPagVoidData *voidData = [PlugPagVoidData new];
  voidData.mTransactionId = @"TRANSACTIONID";
  voidData.mTransactionCode = @"TRANSACTIONCODE";

  PlugPagTransactionResult *result = [[PlugPag sharedInstance]
voidPayment:voidData];
  if (result.mResult == RET_OK) {
    NSLog(@"%@", result.mMessage);
  }
}

Solicitar Autenticação

[[PlugPag sharedInstance] plugPagAppIdentification:@"MyApp" withVersion:@"R001"];
[[PlugPag sharedInstance] requestAuthentication:self];