Tokenization

You can store the data during a payment. Just set the property isTokenizationEnabled to YES for the created payment parameters. It is available for the OPPCardPaymentParams and OPPBankAccountPaymentParams. Then create and submit a transaction as usual.

OPPCardPaymentParams *params = [OPPCardPaymentParams cardPaymentParamsWithCheckoutID:self.checkoutID paymentBrand:@"VISA" holder:holderName number:cardNumber expiryMonth:month expiryYear:year CVV:CVV error:&error];
params.tokenizationEnabled = YES;
// create and submit a transaction

let params = try? OPPCardPaymentParams(checkoutID: checkoutID, paymentBrand: "VISA", holder: holderName, number: cardNumber, expiryMonth: month, expiryYear: year, cvv: CVV)
params.isTokenizationEnabled = true
// create and submit a transaction

2. Create and register a transaction

Create a transaction with the collected valid payment parameters. Then register it using OPPPaymentProvider method and implement the callback.

[self.provider registerTransaction:transaction completionHandler:^(OPPTransaction * _Nonnull transaction, NSError * _Nullable error) {
    if (error) {
        // Executed in case of failure of the transaction for any reason.
    } else {
        // Send request to your server to obtain the status of the registration.
    }
}];

provider.register(transaction, completionHandler: { (transaction, error) in
    if error != nil {
        // Executed in case of failure of the transaction for any reason.
    } else {
        // Send request to your server to obtain the status of the registration.
    }             
})

1. Prepare checkout with tokens

Add token parameter to the prepared checkout request (step 1). Your server should send shopper' tokens along with other configuration data such as amount, currency, order type and etc.

Tokens should be sent in the registrations[n].id parameter, where n is a sequence number from zero, incrementing for each shopper's token. For example, if the shopper has two tokens, you would send registrations[0].id = {first tokenID} and registrations[1].id = {second tokenID}.

You can test this request in the COPYandPAY guide.

2. Submit a transaction with token

Charging a token is quite similar to working with cards. You just need to create OPPTokenPaymentParams instead of OPPCardPaymentParams.

NSError *error = nil;
OPPTokenPaymentParams *params = [OPPTokenPaymentParams tokenPaymentParamsWithCheckoutID:checkoutID tokenID:tokenID paymentBrand:@"VISA" error:&error];
if (error) {
    // See error.code (OPPErrorCode) and error.localizedDescription to identify the reason of failure.
}

do {
    let params = try OPPTokenPaymentParams(checkoutID: checkoutID, tokenID: tokenID, paymentBrand: "VISA")
} catch let error as NSError {
    //See error.code (OPPErrorCode) and error.localizedDescription to identify the reason of failure.
}

To pass CVV value use another initializer for OPPTokenPaymentParams class:

NSError *error = nil;
OPPTokenPaymentParams *params = [OPPTokenPaymentParams tokenPaymentParamsWithCheckoutID:checkoutID tokenID:tokenID cardPaymentBrand:@"VISA" CVV:@"123" error:&error];
if (error) {
    // See error.code (OPPErrorCode) and error.localizedDescription to identify the reason of failure.
}

do {
    let params = try OPPTokenPaymentParams(checkoutID: checkoutID, tokenID: tokenID, cardPaymentBrand: "VISA", cvv: "123")
} catch let error as NSError {
    //See error.code (OPPErrorCode) and error.localizedDescription to identify the reason of failure.
}

Then create and submit a transaction with token payment parameters as usual.

[self.provider requestCheckoutInfoWithCheckoutID:checkoutId completionHandler:^(OPPCheckoutInfo * _Nullable checkoutInfo, NSError * _Nullable error) {
    if (error) {
        // Handle error.
    } else {
        // See checkoutInfo.tokens to get payment data.
    }
}];

self.provider.requestCheckoutInfo(withCheckoutID: checkoutId, completionHandler: { (checkoutInfo, error) in
    if error != nil {
        // Handle error.
    } else {
        // See checkoutInfo.tokens to get payment data.
    }
})