API Reference

Example iOS Code

This code should be used when your App is responding to transaction statuses, specifically after the SKPaymentTransactionStatePurchased status. More information is available on Apple's In-App Purchase Programming Guide .

The lines marked with TODO indicate areas where you may want to add custom code to handle your specific situation.

// this code example checks a single app-wide receipt for all transactions

NSURL *receiptURL = [[NSBundle mainBundle] appStoreReceiptURL];
NSData *receipt = [NSData dataWithContentsOfURL:receiptURL];

if (!receipt) {
  // TODO: invalid receipt, ask the app to refresh itself, stop and do error handling
  [[[SKReceiptRefreshRequest alloc] initWithReceiptProperties:nil] start];
  return;
}


// build the post body with your account api key and app specific token
NSMutableData *postBody = [NSMutableData data];
[postBody appendData: [@"apikey=act_unIquEAccOuntAPIkeySamPle}" dataUsingEncoding:NSUTF8StringEncoding]];
[postBody appendData: [@"&token=app_SaMpLeAppToKen1" dataUsingEncoding:NSUTF8StringEncoding]];
[postBody appendData: [@"&receipt=" dataUsingEncoding:NSUTF8StringEncoding]];
[postBody appendData: [[receipt base64EncodedStringWithOptions:0] dataUsingEncoding:NSUTF8StringEncoding]];

NSString *bodyLength = [NSString stringWithFormat:@"%lu", (unsigned long)[postBody length]];

// setup the a POST request with the post body data
NSURL *apiURL = [NSURL URLWithString:@"https://receiptverify.ikonetics.com/api"];
NSMutableURLRequest *apiRequest = [NSMutableURLRequest requestWithURL:apiURL];
[apiRequest setHTTPMethod: @"POST"];
[apiRequest setValue: @"application/x-www-form-urlencoded" forHTTPHeaderField: @"Content-Type"];
[apiRequest setValue: bodyLength forHTTPHeaderField: @"Content-Length"];
[apiRequest setCachePolicy: NSURLRequestReloadIgnoringLocalCacheData];
[apiRequest setHTTPShouldHandleCookies: NO];
[apiRequest setHTTPBody: postBody];


// create a background session for connecting to the Receipt Verification service.
NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *datatask = [session dataTaskWithRequest: apiRequest 
                                            completionHandler: ^(NSData *apiData
                                                                 , NSURLResponse *apiResponse
                                                                 , NSError *conxErr) 
{
    // background datatask completion block
    
    NSError *parseErr;
    NSDictionary *json = [NSJSONSerialization JSONObjectWithData: apiData
                                                         options: 0
                                                           error: &parseErr];

    // TODO: add error handling for conxErr, json parsing, and invalid http response statuscode

    NSDictionary *receipt = [json objectForKey: @"receipt"];
    NSArray <NSDictionary*> *lineitems = [receipt objectForKey: @"latest_receipt_info"];
    if (nil == lineitems) {
        lineitems = [receipt objectForKey: @"in_app"];
    }
        
    /* TODO: Unlock the In App purchases ... 
     At this point the json dictionary will contain the verified receipt from Apple
     and each purchased item will be in the array of lineitems.
     */
 }];


// start the background session datatask
[datatask resume];

		

After you receive the JSON receipt your code should perform some simple checks to verify the JSON receipt from Apple matches your App and your In-App products. For example you may want to compare the transaction's productIdentifier to the product_id in the JSON receipt. Read the Apple documentation to learn other fields you might want to verify before unlocking features.

Assuming you have the productIdentifier from an SKPaymentTransaction and you have a method named unlockFeature, your code may look something like this:

NSDictionary *latest = [json objectForKey:@"latest_receipt_info"];

for (NSDictionary *lineitem in latest) {

  NSString *receiptItem = [lineitem objectForKey:@"product_id"];
  if ([productIdentifier isEqualToString:receiptItem]) {
  
    [self unlockFeature: lineitem ];
    
  }
  
}