3.1 – Setting up IAP for iOS

In order to set up IAPs for iOS, you’ll need:

  1. all your tax and banking information
  2. at least one application created with a unique bundle ID

First, log into itunes connect with your apple developer account (https://itunesconnect.apple.com/).

Next, select “Manage your applications”

Next, select the app you wish to add in-app purchases to.

Click the “Manage In-App Purchases” button in the App Dashboard

If this is your first time setting up IAP for your app, you’ll see an empty menu.  Click “Create New”.

Select an item type.  Apple offers multiple types, but at this time GameSalad only supports Consumables and Non-Consumable types.

  1. “Consumables” must be purchased every time the user downloads it.  One-time services, such as fish food in a fishing app, are usually implemented as consumables.
  2. “Non-Consumables” only need to be purchased once by the user.  Services that do not expire or decrease with use, such as a new race track for a racing game, are usually implemented as non-consumables.

Consumable Item setup

Choosing to create a “Consumable Item” will advance you to the item setup screen.  Give your item a Reference Name – this is not public facing, and used strictly for your reference.  Next, give your item a Product ID – this is very important, as it’s the value that GameSalad uses to link to the item.  

Next, select the “Add Language” button.  Choose a language from the dropdown.

Set your item’s “Display Name”.  This is the name that your players will see during the purchasing event.

Describe the item in the Display Description field.  Click “Save” when you’re finished.  This will bring up pricing.  By default, the item will be “Cleared for Sale”; this simply means that it will be active in the game and available for players to purchase immediately.  

Next, select a Price Tier.  Click “View Pricing Matrix” to reference the pricing structure of the various tiers.  For example, Tier 1 corresponds to $.99 in US Dollars.

Finally, “Submit a Screenshot for Review”.  This is an image that should help give Apple the context of the item in your app, so they can better determine if it meets their requirements.  Click “Save” to complete the Consumable Item Setup.

Non-Consumable Item Setup

The process for setting up non-consumable items is identical to that of consumable items.  We’ll repeat the instructions here for the sake of providing complete documentation.

Choosing to create a “Non-Consumable Item” will advance you to the item setup screen. Give your item a Reference Name – this is not public facing, and used strictly for your reference. Next, give your item a Product ID – this is very important, as it’s the value that GameSalad uses to link to the item.   

Next, select the “Add Language” button. Choose a language from the dropdown.

Set your item’s “Display Name”. This is the name that your players will see during the purchasing event.

Describe the item in the Display Description field. Click “Save” when you’re finished. This will bring up pricing. By default, the item will be “Cleared for Sale”; this simply means that it will be active in the game and available for players to purchase immediately.

Next, select a Price Tier. Click “View Pricing Matrix” to reference the pricing structure of the various tiers. For example, Tier 1 corresponds to $.99 in US Dollars.

Finally, “Submit a Screenshot for Review”. This is an image that should help give Apple the context of the item in your app, so they can better determine if it meets their requirements. Click “Save” to complete the Consumable Item Setup.

When you have finished setting up your In-App Purchase items, you will see them listed in the IAP home view.  

NOTE: before submitting your binary to Apple for review, you MUST be sure to Activate your IAP items for that version of the game through the App Details page.  Until then, you can test your purchased items in Sandbox Mode prior to app submission.

Setting up a Test User for Sandbox Testing on iOS Devices

    1. First, log into iTunes Connect (itunesconnect.gamesalad.com) with your Apple Developer Account.
    2. Select “Manage Users”.
    3. Select “Test User” if you have an existing test account, or to set up a new Test User. 
    4. Once you’ve set up a test user account, you can use it to test your ad-hoc app builds in the Apple Sandbox.