One of the new framework in firmware 3.0 is the Store Kit. It can be very usefull to get a new business model in iPhone applications. For example, you can create a subscription magazine app where you ask for payment on a monthly, yearly or periodic basis of your choice. Sell extra levels to extend the experience of your game,…

The main steps to use this framework are:

• - Create “In App Purchase Test User” in iTunes Connect Portal.
• - Have create App ID in the Developer Portal and enabled in-App purchases for that.
• - Create the new App on in iTunes Connect Portal, and Register a product for this App.
• - Develop the store in your App.

1.- Create “In App Purchase Test User” in iTunes Connect Portal.

Go to iTunes Connect Portal, (https://itunesconnect.apple.com), and click the option “Manage Users”, once on there, choose “In App Purchase Test User” option, and add a new User. The email that they requiere must be different of your iTunes Connect mail, it can be a dummy mail.

iTunesConnect->Manage Users-> In App Purchase Test User-> Add New User.

2.- Have create App ID in the Developer Program Portal and enabled in-App purchases for that.

Go to Developer Program Portal (http://developer.apple.com) and select “App IDs” section. The next step will be create a new App ID. Select the top right button “New App ID”. In bundle identifier I recomend to use a string like this, “com.yourcompany.appname”.

Developer Program Portal -> App IDs -> New App ID.

3.- Create the new App on in iTunes Connect Portal, and Register a product for this App.

Now we create the app on iTunes Connect. Again go to iTunes Connect Portal and select “manage your applications”. On left top you can see the “add new application” button, click it, and follow the steps. On Pricing step, it’s very important that you select a payment application (Not free), cause the app purchases are only available on this kind of App.

iTunes Connect -> Manage your Applications -> Add new Application

Once the App has been created, you can see it on “Manage your applications”. To add In-app purchase, select the button “Manage in-app purchase”. In this page, you can create your app purchases using the top left button, “Create New”.

iTunes Connect -> Manage your Applications -> Manage in-app purchase.

* If your application is free, you can’t see this option

4.- Develop the store in your App.

This is the final step to use store kit. First of all it’s very important decide your application store model. Depending on how many items your store offers and how often you add new items, you may want to use one of two basic models: self-contained or downloadable content. In this tutorial we use a self-contained model.

In XCode, when you set up the project, make sure to link to StoreKit.framework.

Store Kit does not allow your application to patch itself or download additional code. For this the new feature must already exist in your application waiting to be unlocked

4.1.- Get the in-app purchase.

If you want to check the in-app purchase on your iphone app.

DummyView.h

#import <UIKit/UIKit.h>
#import <StoreKit/StoreKit.h>

@interface DummyView : UIView <SKProductsRequestDelegate> {
}

- (void) requestProductData;
@end


DummyView.m

#import “DummyView.h”

@implementation DummyView

- (id)initWithFrame:(CGRect)frame {
if (self = [super initWithFrame:frame]) {
[self requestProductData];
}
return self;
}

- (void)dealloc {
[super dealloc];
}

- (void) requestProductData
{
SKProductsRequest *request= [[SKProductsRequest alloc] initWithProductIdentifiers: [NSSet setWithObject: @"com.yourcompany.product "]];
request.delegate = self;
[request start];
}

//***************************************
// PRAGMA_MARK: Delegate Methods
//***************************************
- (void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response
{
NSArray *myProduct = response.products;
// populate UI
for(int i=0;i<[myProduct count];i++)
{
SKProduct *product = [myProduct objectAtIndex:i];
NSLog(@”Name: %@ - Price: %f”,[product localizedTitle],[[product price] doubleValue]);
NSLog(@”Product identifier: %@”, [product productIdentifier]);
}
}

@end

4.2.- Buy a in-app purchase.

First of all you need register a transaction observer with the payment queue. For this you must create a instance class like this.

CustomStoreObserver.h

#import <Foundation/Foundation.h>
#import <StoreKit/StoreKit.h>

@interface CustomStoreObserver : NSObject<SKPaymentTransactionObserver> {
}

- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions;
- (void) failedTransaction: (SKPaymentTransaction *)transaction;
- (void) restoreTransaction: (SKPaymentTransaction *)transaction;
- (void) completeTransaction: (SKPaymentTransaction *)transaction;

@end

CustomStoreObserver.m

#import “CustomStoreObserver.h”

@implementation CustomStoreObserver

- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions
{
for (SKPaymentTransaction *transaction in transactions)
{
switch (transaction.transactionState)
{
case SKPaymentTransactionStatePurchased:
[self completeTransaction:transaction];
break;
case SKPaymentTransactionStateFailed:
[self failedTransaction:transaction];
break;
case SKPaymentTransactionStateRestored:
[self restoreTransaction:transaction];
default:
break;
}
}
}

- (void) failedTransaction: (SKPaymentTransaction *)transaction
{
if (transaction.error.code != SKErrorPaymentCancelled)
{
// Optionally, display an error here.
}
[[SKPaymentQueue defaultQueue] finishTransaction: transaction];
}

- (void) restoreTransaction: (SKPaymentTransaction *)transaction
{
//If you want to save the transaction
// [self recordTransaction: transaction];

//Provide the new content
// [self provideContent: transaction.originalTransaction.payment.productIdentifier];

//Finish the transaction
[[SKPaymentQueue defaultQueue] finishTransaction: transaction];

}

- (void) completeTransaction: (SKPaymentTransaction *)transaction
{
//If you want to save the transaction
// [self recordTransaction: transaction];

//Provide the new content
//[self provideContent: transaction.payment.productIdentifier];

[[SKPaymentQueue defaultQueue] finishTransaction: transaction];

}

@end

And in DummyView.m you can add a button with this Event Method to buy in-app purchase.

-(void) subscribe:(id) sender{
SKPayment *payment = [SKPayment paymentWithProductIdentifier:productIdentifier];
[[SKPaymentQueue defaultQueue] addPayment:payment];
}


This is a simple tutorial to take a first look to Store Kit. I hope that it will be usefull for you.