The viewer experience of purchasing an InPlayer asset via your app is exactly the same as the experience of making a regular In-app payment.
There are no extra steps to follow. The viewer just follows your app’s regular payment flow.
Note that the viewers always need to log into the app where they watch the content with the same account as the one they used to purchase the content originally.
If you have any questions, don’t hesitate to contact us at clients@inplayer.com.
This guide describes how to set up InPlayer in-app payments for your iOS app. When setting things up, please make sure to take your time and follow each step in the below instructions carefully.
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.
When creating the app, in the App Store section, under App Information, and then under App Store Server Notifications make sure to fill out the Production Server URL field of the app with the following URL:
In case you do not see the App Store Server Notifications section in the App Information page (possible if importing the app from another OTT platform), create one in-app purchase in the app. Once you do, come back to the App Information page and the App Store Server Notifications section should become available. You can then proceed with the setup as described below.
In addition to this, make sure that under Notification version for the Production Server URL, you’ve selected Version 1 Notification. This can be accessed by clicking Edit next to the Production Server URL field label.
As for the URL, you will notice that it needs to be completed 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:
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 wishes.
After you’ve created your asset, the next step is to create 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.
Click on the app you are using for InPlayer purchases.
In the left-hand menu, under Features, click on In-App purchases.
In the In-App Purchases section, create a new in-app purchase by clicking on .
In the pop-up window, select the Non-Consumable option.
Enter the Reference Name and Product ID.
Both fields need to be filled out with the same value.
To get the Product ID, go to the Assetstab of your InPlayer dashboard and open the asset you wish to use. Go to Price Options, open the price option for which you are creating the in-app purchase, and click the Copy in-app product ID button. That value is both the Product ID and Reference number.
Click Create.
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 Dashboard, or pick the closest one in the App Store.
Next, click on Add Localization and then 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 Save.
Click on the app you are using for InPlayer purchases.
In the left-hand menu, under Features, click on Subscriptions. We will first be creating the Subscription Group.
In the Subscription Groups section, create a new group purchase by clicking on .
Next, in the pop-up window that appears, enter the Reference Name.
Click Create.
Next, in the Subscriptions section, click on Create.
Do note that you can only have a single in-app purchase (i.e. price option) for each individual subscription group.
The reason for having only a single in-app purchase for each individual subscription group is to avoid viewers upgrading and downgrading their plan within the same subscription group, since this functionality is not yet supported for iOS.
In the pop-up window that appears, enter the same Reference Name from the previous step and the Product ID.
Both fields need to be filled out with the same value.
To get the Product ID, go to the Assetstab of your InPlayer dashboard and open the asset you wish to use. Go to Price Options, open the price option for which you are creating the in-app purchase, and click the Copy in-app product ID button. That value is both the Product ID and Reference number.
Click Create.
Next, we will fill in the Subscription Duration option. Select the same access period as the one you’ve set up in the InPlayer Dashboard for the price option you are setting up.
Next, add a price by clicking on Add Subscription Price.
To add a free trial, you can create an introductory offer as explained in this guide. If you set up an introductory offer in the Apple dashboard, make sure to also enable the “Free trial” option in the “Additional info” of the price option of your InPlayer asset. Creating the InPlayer asset is explained further down this article. Note that if you have created an introductory offer with an expiry date, on the date of expiry, you will need to uncheck the “Free trial” option in your InPlayer Dashboard manually. This will not happen automatically. Having this option checked in your InPlayer asset will not grant a free trial if there is not a valid introductory offer in your Apple dashboard, but is highly recommended that the two options mirror each other, in order to avoid viewer confusion.
Select a price from the list and click Next. 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 Dashboard, or pick the closest one in the App Store.
You will then see a pop-up window showing all the regional prices converted to the viewer’s local currency. If you wish, you can also modify these converted prices as well. Once you make the adjustments if any, click Next and then Confirm.
Next, in the App Store Localization section, click on Create and Save the changes.
In the pop-up window that appears, add localization and set up the Display Name and Description for the purchase, and click Add.
Note that you can also enable voucher payments by adding an Introductory offer to the subscription. Read our In-app introductory offers guide for more on this.
Note that you will also need to add another localization by clicking Add localizations on the banner at the 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 Save.
If you are using an existing Apple PPV purchase or subscription, before you proceed with the steps below, always make sure that all the pricing and access type and duration details are the same in both the Apple PPV purchase or subscription and the InPlayer asset. Once you do this, proceed with the step below.
.
