iOS

DocsIn-App Purchases › iOS

Last updated: 16 Aug 2019 / 12:48 PM / GMT

Our monetization platform features a fully developed integration for iOS in-app purchases.

If you are planning on using in-app purchases, make sure to let us know so we can enable the proper payment gateway on your account.


Creating the InPlayer app in App Store Connect

The first step in using our iOS in-app purchases feature is to create an InPlayer app in your App Store Connect account.

For a guide on creating the iOS app, check out the official Apple guide.

When creating the app, make sure to fill out the Subscription Status URL field of the app with the following URL:
https://services.inplayer.com/v2/hooks/apple-in-app/X

The X in the URL needs to be changed with your InPlayer Account UUID.

For example, if your Account UUID is c0fe41ca-3cbb-7pc1-5147-3m8157611d8d, the URL you would need to use in the App Store app would be:
https://services.inplayer.com/v2/hooks/apple-in-app/c0fe41ca-3cbb-7pc1-5147-3m8157611d8d

To get the Account UUID, log into your InPlayer dashboard, click on your account name in the top right corner, and go to Account Details.

Your Account UUID will be listed on the page.

Connecting your InPlayer account and App Store Connect app

First, log into your InPlayer dashboard.

Go to Settings, then to the Integrations tab, and click on In-App Integrations.

Click on App Store.

Enter the app-specific shared secret from your App Store Connect account, and click .

Your App Store app is now integrated with your InPlayer account.

How to find the app-specific shared secret

Log into your App Store Connect account.

Click on My Apps.

Click on the InPlayer app.

Go to the Features tab.

Click on  App Specific Shared Secret.

A pop-up window will appear. Click on Generate App-Specific Shared Secret.

Your secret will be displayed.

Creating your InPlayer asset

The next step is to create your InPlayer asset.

We offer several different types of assets, so make sure to look at this section for instructions on how to create the correct asset type, depending on your content.

Creating the in-app purchase

Next, you need to create the in-app purchase. The in-app purchase is going to be the App Store counterpart to the price option you have previously set up for your InPlayer asset.

Creating a PPV purchase

First, log into your App Store Connect account.

Click on My Apps.

Click on the InPlayer app.

Go to the Features tab.

In the In-App Purchases tab, create a new in-app purchase by clicking on .

In the pop-up window, select the Non-Consumable option.

Click .

Enter the Reference Name and Product ID.

Both fields need to be filled out with the same value.

The value needs to be in the following format:

item_id.X.access_fee_id.Y

The X part of the value should be the InPlayer asset’s Asset ID, and the Y part, it’s Access Fee ID.

To get these, go to the Assets tab of your InPlayer dashboard and open the asset you wish to use.  Go to Price Options, and click the  button next to the price option for which you are creating the in-app purchase.

Paste the text in a text editor.

The first number of the pasted text is the Asset ID (X), and the second is the Access Fee ID (Y).

Modify the Reference Name and Product ID value accordingly.

Ex. If the Product ID is 49736_6457, the value would be:
item_id.49736.access_fee_id.6457

Next, set the price. Note that the available prices in the App Store are all in decimal numbers (ex. $4.99 as opposed to $5), so make sure to either set up the same price in the InPlayer merchant panel, or pick the closest one in the App Store.

Next, add a localization and set up the Display Name and Description for the purchase.

Finally, under Review Information, add a screenshot along with your review notes.

The screenshots requirements are outlined below:
– iOS requires at least 640 x 920 pixels.
– tvOS requires 1920 x1080 pixels.
– macOS requires 1280 x 800 pixels.
When you finish with everything, review your work, and click .

And with that, you are done.

Creating a subscription purchase

First, log into your App Store Connect account.

Click on My Apps.

Click on the InPlayer app.

Go to the Features tab.

In the In-App Purchases tab, create a new in-app purchase by clicking on .

In the pop-up window, select the Auto-Renewable Subscription option.

Click .

Enter the Reference Name and Product ID.

Both fields need to be filled out with the same value.

Just like in the case with the Non-Consumable purchases, the value needs to be in the following format:

item_id.X.access_fee_id.Y

The X part of the value should be the InPlayer asset’s Asset ID, and the Y part, it’s Access Fee ID.

To get these, go to the Assets tab of your InPlayer dashboard and open the asset you wish to use.  Go to Price Options, and click the  button next to the price option for which you are creating the in-app purchase.

Paste the text in a text editor.

The first number of the text is the Asset ID (X), and the second one is the Access Fee ID (Y).

Modify the Reference Name and Product ID value accordingly.

Ex. If the Product ID is 49736_6457, the value would be:
item_id.49736.access_fee_id.6457
Click on .

On the next screen, scroll down, select Create New Subscription Group and enter the same Reference Name from the previous step. Then click .

You now need to set up the Subscription Group.

You can only have a single in-app purchase (i.e. price option) for each individual subscription group.

Note that you will be prompted to save your progress each time you move to set up a different part of the subscription group, so make sure you do so.

Start with the Subscription Duration option. Select the same access period as the one you’ve set up in the InPlayer merchant panel for the price option you are setting up.

Next, add a price by clicking on the  button next to Subscription Prices.

Select a price from the list. Note that the available prices in the App Store are all in decimal numbers (ex. $14.99 as opposed to $15), so make sure to either set up the same price in the InPlayer merchant panel, or pick the closest one in the App Store.

Note also that the prices will be automatically converted to the customer’s local currency. If you wish, you can also modify these converted prices as well.

Save the pricing and go back to setting up the subscription group by clicking on it.

Note that you can also enable voucher payments by adding an Introductory offer to the subscription. Read our voucher guide for more on this.

Next, add a localization and set up the Display Name and Description for the purchase.

Note that you will also need to add another localization by clicking Add localizations on the banner at the very top of the window.

Finally, under Review Information, add a screenshot and your review notes.

The screenshots requirements are outlined below:
– iOS requires at least 640 x 920 pixels.
– tvOS requires 1920 x1080 pixels.
– macOS requires 1280 x 800 pixels.
When you finish with everything, review your work, and click .

And with that, you are done.

If you have any questions in regards to any of this, don’t hesitate to contact us on support@inplayer.com.

You can also visit Apple’s In-app purchase information page for more information.

We use cookies to analyse our traffic. We also share information about your use of our site with our analytics partners. See details