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

Providers - Moderninha Pro - iOS

Métodos

MétodoRetornoDescrição
GetVersionLibconst char*Retorna uma const char com a versão da biblioteca de integração.
SetVersionName: withVersionIntSeta 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.
InitBTConnectionIntInicializa a comunicação blutooth utilizando o dispositivo padrão do aparelho iOS.
SimplePaymentTransaction: withInstallmentType: endInstallments: endAmountIntInicia 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.
SetModelnenhumSeta o modelo do terminal PagSeguro que a PlugPag vai parear e conectar via bluetooth
SetPeripheralNamenenhumSeta 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:withNamenenhumSeta o modelo do terminal e o ID do terminal PagSeguro que a PlugPag vai parear e conectar via Bluetooth.
GetListModelsNSArray (NSArray de Strings)Retorna uma lista de modelos de terminais PagSeguro disponível para pareamento via Bluetooth.
GetListPeripheralNSArray (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
GetPairPeripheralStatusIntRetorna 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 PRO, 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];
    }

Estornando uma Transação

Para iniciar uma transação de estorno na Moderninha PRO, 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 PRO, 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+).