In-App Purchase Integration

Overview

In-app purchase integration enables you to track player purchases and sync entitlements from third-party platforms such as PlayStation or Xbox. That way, any in-app items that are sold and granted to the player from a third-party platform will also be transferred to our platform, as long as our platform has the proper ID for the item from the platform you’re using. Items that can be sold include coins, bundles, loot boxes, and in-game items, both consumable and durable.

Supported Platforms

Here’s a table showing the platforms we support, and the features they offer:

	3rd Party Login	In-App Purchases	Entitlements
Apple	Y	Y	N
Epic Online Services	Y	Y	Y
Google Play	Y	Y	N
PlayStation 4 + 5	Y	Y	Y
Stadia	Y	Y	Y
Steam	Y	Y	Y
Stadia	Y	Y	Y
Twitch	Y	Y	Y
Xbox Live	Y	Y	Y

Permissions

Permissions are used to grant access to specific resources within our services. Make sure your account has the following permissions before you attempt to manage In-App Purchase Integration in the Admin Portal. For a full list of permissions that impact in-app purchase management, see the Platform/Commerce tab of the permissions reference (opens new window).

To retrieve and update the configuration of the supported 3rd Party Platform, make sure you have the following permissions.

Usage	Permission Tag	Action	Platforms
Retrieve the 3rd Party Platform Configuration (all platforms)	ADMIN:NAMESPACE:{namespace}:IAP:CONFIG	READ	All platforms
Update the 3rd Party Platform Configuration	ADMIN:NAMESPACE:{namespace}:IAP:CONFIG	UPDATE	PSN, Xbox, Steam, Stadia, Epic, Twitch, Google Play, Apple

For other supporting permission such as Synchronizing Entitlement and Updating Business Partner Certificate Files, make sure you have the following permissions.

Usage	Permission Tag	Action	Platforms
Entitlement Synchronization	NAMESPACE:{namespace}:USER:{userId}:IAP	UPDATE	All pPlatforms
Update the Business Partner Certificate File	ADMIN:NAMESPACE:{namespace}:IAP:CONFIG	UPDATE	Xbox, Stadia and Google Play

Permissions work slightly differently depending on whether they are assigned to IAM Clients or Roles assigned to users. For more information, read the Authentication and Authorization documentation.

Managing In-App Purchase Integration in the Admin Portal

Add a New Configuration

Before starting the tutorial, make sure you have registered the PS4 Client to our IAM.

1. Before beginning, make sure you are in the namespace you want to configure. Go to the E-Commerce section of the main menu in the Admin Portal and select In-App Purchase > 3rd Party Store Integrations.

   NOTE

   Any configurations you make in the publisher namespace will be used as the default configuration for any unconfigured game namespaces.

   

2. Select the platform you wish to configure from the tabs and click Add Configuration.

   

   NOTE

   Each namespace can only have one configuration.

3. The Add Configuration popup will appear. This will be different for each platform.

   PSN

   

   • Input the PlayStation Client ID.
   • Input the PlayStation Secret.
   • Select the Environment, e.g. sp-int for Development, prod-qa for QA, or np for Live Environment.
   • Input the PlayStation Redirect URI. This field is optional, if you leave it empty the value will be orbis://.

   Make sure you have also created a service in PlayStation Store Delivered Content inside your AppServer.

   Xbox

   

   • Input the Relying Party Private Key (opens new window) in Base64 format.
   • Upload your Business Partner Certificate (opens new window) in .pfx format.
   • Input your Certificate Password. This field is optional. If your certificate requires a password, you must input the password to continue.

   Steam

   Make sure you’ve created an item with the same SKU in both the Steam Store (opens new window) and the AccelByte Platform namespace. Once completed, input the Publisher Authentication Key (opens new window).

   

   • Input the game App ID.
   • Input the game Steam Web API Key.

   You can find both of these values in the Steamworks (opens new window) portal.

   Stadia

   Upload your Stadia Configuration File in .json format.

   Epic

   Input the Sandbox ID (opens new window) of your Epic Developers account.

   

   Twitch

   Make sure you’ve completed the following the prerequisites before you begin:

   • Register your organization (opens new window) with Twitch Developer
   • Create a Twitch Application for Drops (opens new window) and configure the Drop settings
   • Create a Twitch Drops Reward (opens new window). Be sure to specify the Reward ID (opens new window) so that the drop reward can be matched with your AccelByte item. The Reward ID should follow this format: {accelbyte-namespace}-{accelbyte-itemSKU}, e.g., game001-weapon001.

   

   Google Play

   Make sure you’ve created your android app and set the Product ID (opens new window) to Publish (opens new window) your app in the Google Play store.

   

   • Input the Application Name you set in the Play Console (opens new window).
   • Input your Service Account ID (opens new window).
   • Upload your Business Certificate (opens new window) in .p12 format.

   Apple

   Make sure you’ve created an item in App Store Connect (opens new window). Use the SKU/Item ID of this item as a Product ID to sync with your App in your namespace’s store.

   

   • Input the Bundle ID (opens new window).
   • Input the Password with the App-Specific Shared Secret found in your item’s details in App Store Connect.

4. Once your configuration is complete, the information you have entered will be visible under the Configuration Details section of the relevant platform. You can also edit or remove configurations on this page.

   

Change Your Business Partner Certificate

1. In the Admin Portal, go to E-Commerce > In-App Purchase > 3rd Party Store Integrations and select the namespace where your certificate belongs. Under Configuration Details > Business Partner Certificate, click Edit.

   

2. A pop up will appear. Fill in the required fields:

   

   • Upload your Business Partner Certificate in .pkf format.
   • Input your Certificate Password.

Integrate In-app Purchase using SDK

Sync Durable Entitlement

Epic Games

Xbox

Related Concepts

• Learn how to Integrate items on the 3rd Party Store
• Read more about our Entitlement service.