Import item catalog

You can import items and subscriptions from external platforms and synchronize user inventory.

Import catalog from PlayFab

PlayFab offers game developers ready-to-use server solutions to manage catalogs and monetization. After integration with PlayFab, you can import a catalog from PlayFab to In-Game Store for using Xsolla solutions.

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Catalog Management pane, click Configure.
4. In the Integration with external platforms pane, click Configure.
5. In the PlayFab pane, click Configure.
6. In the Item import tab specify:
   • Title ID — project ID in PlayFab.
   • Secret key — the key of the project in PlayFab.
7. Click Save.
8. Synchronize user inventory with PlayFab (optionally):
   1. Go to the Inventory synchronization and specify:
      • Title ID — project ID in PlayFab.
      • Secret key — the key of the project in PlayFab.
   2. Set the Synchronize user inventory with PlayFab toggle to On.
   3. Click Save.
9. Go to the Item import tab and click Start import. Catalog import will start automatically.
10. To sell virtual items in the web store created by Site Builder, configure item groups in Publisher Account and assign one or more of them to each item.
11. To display item images, upload them to your Publisher Account.

To check if the import completed successfully, go to the Store section in the side menu and make sure that items, currency, and bundles are enabled on the Virtual currency, Virtual items, and Bundles tabs.

Import catalog from App Store

1. Add the Xsolla user with the Marketing role.
2. Get Application ID.
3. Import catalog from the App Store.

Add the Xsolla user with the Marketing role

Before importing a catalog from the App Store, you need to add the Xsolla user with the Marketing role to your Apple account.

1. Log in to App Store Connect.
2. Go to the Users and Access section.

3. Click the + icon.
4. Set up parameters:
   • First name and Last name — This is arbitrary, enter anything you want.
   • Email — Enter igs@xsolla.com.
   • Roles — Select Marketing.
   • Apps — Specify the app you want to import the catalog for (optional).

5. Click Invite.

Get Application ID

To get your application ID in App Store Connect:

1. Go to App Store Connect.
2. Go to the My Apps section.

3. Open your app’s page.
4. Go to General > App information.
5. In the General Information block, copy application ID under Apple ID title.

6. Click Save.

Import catalog from App Store

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Catalog Management pane, click Configure.
4. In the Integration with external platforms pane, click Configure.
5. Specify:
   • Application ID — your app’s ID from App Store Connect.
   • Company name — your company name in App Store Connect.
6. Click Start import. Catalog import will begin immediately.
7. To sell virtual items in the web store created by Site Builder, configure item groups in Publisher Account and assign one or more of them to each item.
8. To display item images, upload them to your Publisher Account.

Import catalog from Google Play

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Catalog Management pane, click Configure.
4. In the Integration with external platforms pane, click Configure.
5. In the Google Play pane, click Configure.
6. Specify Application ID — your app’s ID from Google Play.

7. Upload JSON with a private key.

8. Go to the Google Play Console, in the side menu click Users and permissions and add service account as a new user.

9. Click Save.
10. Click Start import. Catalog import will begin immediately.

11. To sell virtual items in the web store created by Site Builder, configure item groups in Publisher Account and assign one or more of them to each item.
12. To display item images, upload them to your Publisher Account.

Reimport catalog

When reimporting the catalog, you need to consider that:

• Items that are already in the Store will be updated.
• Items that are not available in the Store will be added.
• Items that have already been removed from the source of import will remain in the Store. You can delete them in your Publisher Account or via API.

Next steps

1. Implement granting of purchases to the user.
2. Implement getting subscription information.

Useful links

• Integration flow
• Set up catalog manually

Rate this page

Is there anything we can improve? Send

Don’t want to answer

Thank you for your feedback!