Starting a Transaction using Clearent's iOS Framework

To start a transaction using Clearent’s iOS framework:

1

Initialize the objects.

ClearentVP3300Config *config = [[ClearentVP3300Config alloc]init];
        [config setPublicKey:publicKey];
        [config setClearentBaseUrl:baseURL];
        config.contactAutoConfiguration = false;
        config.contactlessAutoConfiguration = false;
        config.contactless = true;
        clearentVP3300 = [[Clearent_VP3300 alloc]  initWithConnectionHandling:self clearentVP3300Configuration:config];
        clearentManualEntry = [[ClearentManualEntry alloc]  init];
        [clearentManualEntry setClearentBaseUrl:baseURL];
        [clearentManualEntry setPublicKey:publicKey];

Note: Visit Clearent Payment Gateway to test the sandbox and to go live.

2

Create an object that represents the payment request.

ClearentPayment *clearentPayment = [[ClearentPayment alloc] init];
    [clearentPayment setAmount:theAmount];
    clearentPayment.amtOther = 0;
    clearentPayment.type = 0;
    clearentPayment.timeout = 10;
    clearentPayment.tags = nil;
    clearentPayment.fallback = true;
    clearentPayment.forceOnline = false;

Note: Required to add the amount of payment in a transaction request for certain EMV checks.

3

Create an object that represents the Bluetooth connection.

ClearentConnection *clearentConnection = [[ClearentConnection alloc] initBluetoothWithFriendlyName:self.deviceFriendlyName];

4

Start a transaction.

Clearent’s iOS framework will connect to the reader, and messages will be received by the feedback delegate. When the iOS framework successfully secures the card data, it will call back to the successTransactionToken delegate.

ClearentResponse *response = [clearentVP3300 startTransaction:clearentPayment clearentConnection:clearentConnection];
         if (response.responseType != RESPONSE_SUCCESS) 
         {
             //Notify user the transaction could not be started.
         }

Note: Use POST method against our endpoint /rest/v2/mobile/transactions/sale to process the payment. For more information, see Mobile Gateway Documentation.