Set up and sell DLCs

Last updated on February 12, 2024

Overview

In-app Purchase integration enables you to sync player purchases from third-party platforms such as PlayStation or Xbox to AccelByte Gaming Services (AGS). In order to achieve this, items sold on a third-party platform need to be correctly mapped to items created in AGS. This guide focuses on how to map durable items in AGS to items defined on third-party platforms.

Goals

• Explain and guide users to configure DLCs in AGS manually or using JSON file
• Guide user to add DLC mappings for third-party platforms manually or using JSON file

Prerequisites

• Items are properly configured on a third-party platform
• Corresponding items are created in the AGS Store

Configure DLCs in AGS

Add DLC

If you would like to sell DLCs on a third-party platform (Epic, Steam, Xbox, PlayStation), after creating the DLCs on a third-party platform, you will also need to add DLCs on the Admin Portal.

1. Go to E-Commerce section, find the In-App Purchase section and click DLC Settings. Under ‘DLC Configuration’ tab, click ‘Add DLC’ button and a pop-up window will be displayed.

2. On the pop-up window:
   1. Fill in ‘DLC ID’
   2. Choose a ‘Reward Type’ (Item/Currency)
   3. Choose an ‘Item Identity’ (SKU/ID) and search an item by using an item name,
   4. Input ‘Item Type’ (COINS, INGAMEITEM, BUNDLE, CODE, SEASON, MEDIA)
   5. Input Quantity
   6. Click ‘Add’ button to save

Add DLC (JSON format)

3. If you would like to add JSON file instead of adding items manually each by each, you can click ‘Add JSON’ button. A JSON template will be displayed in the next screen and you can follow the template to configure your JSON file

4. If there is an existing DLC configured already, you may also Edit/Delete the JSON file.

Map DLCs in AGS to third-party platforms

Add DLC Mapping

5. After DLC Configuration is completed, you can move to the DLC Mapping tab to map the DLC you created on AccelByte to the corresponding DLCs on each of the third-party platforms.

6. Click ‘Add Mapping’ button under a desired third-party platform.

7. Fill in the required fields 8. third-party Platform Item ID 9. DLC ID - This is the ID you created in the 2nd Step

Add DLC Mapping (JSON format)

8. Click ‘Add JSON’ to add a JSON file instead of adding DLC mapping manually. Follow the templates in the next screen to configure your JSON file