How to automate catalog updates

You can automate catalog updates with In-Game Store API methods. With automation, you can keep your catalog up to date without spending a lot of time on it. Catalog automate allows you to create and update items and promotions and import data from external systems.

This reduces the time it takes to maintain and update:

• catalogs that contain a lot of items
• promotions of any type
• country-based prices

Basic authorization is used for API calls to create and update items and promotions. Pass the Authorization:Basic <your_authorization_basic_key>, where <your_authorization_basic_key> is the merchant ID:API key pair encoded according to the Base64 standard. Go to Publisher Account to find these parameters:

• Merchant ID is shown:
  • In the Project settings > Webhooks section.
  • In the Company settings > Company section.
  • In the URL in the browser address bar on any Publisher Account page. The URL has the following format: https://publisher.xsolla.com/​merchant ID/Publisher Account section.

• API key is shown in Publisher Account only once when it is created and must be stored on your side. You can create a new key in the following section:
  • Company settings > API keys
  • Project settings > API keys

Create and update items

Virtual items

To update the catalog:

1. Get data from the catalog with the Get virtual item or Get all virtual items list API methods.
2. Pass new parameter values with the Update virtual item API method.

To create virtual items, use the Create virtual item API method.

Virtual currency

To update the catalog:

1. Get data from the catalog with the Get virtual currency list API method.
2. Pass new parameter values with the Update virtual currency API method.

To create virtual currency, use the Create virtual currency API method.

Virtual currency packages

To update the catalog:

1. Get data from the catalog with the Get virtual currency package list API method.
2. Pass new parameter values with the Update virtual currency package API method.

To create a virtual currency pack, use the Create virtual currency package API method.

Bundles

To update the catalog:

1. Get data from the catalog with the Get list of bundles API method.
2. Pass new parameter values with the Update bundle API method.

To create a bundle, use the Create bundle API method.
If you want to add game keys, country restrictions or prices to bundles, use the instructions.

Create and update promotions

Coupons

To update the promotion:

1. Get data from the catalog with Get coupon promotion or Get list of coupon promotions API methods.
2. Pass new parameter values with the Update coupon promotion API method.
3. Activate the promotion with the Activate coupon promotion API method.

To create a promotion, use the Create coupon promotion API methods, and then Create coupon code to create custom coupons codes or Generate coupon codes to generate random coupon codes.
To deactivate a promotion, use the Deactivate coupon promotion API method.

Promo codes

To update the promotion:

1. Get data from the catalog with Get promo codes promotion or Get list of promo codes promotions API methods.
2. Pass new parameter values with the Update promo codes promotion API method.
3. Activate the promotion with the Activate promo code promotion API method.

To create a promotion, use the Create promo code promotion API methods, and then Create code for promo code promotion to create custom promo codes or Generate codes for promo code promotion to generate random promo codes.
To deactivate a promotion, use the Deactivate promo code promotion API method.

Discounts

To update the promotion:

1. Get data from the catalog with Get item promotion or Get list of item promotions API methods.
2. Pass new parameter values with the Update item promotion API method.
3. Activate the promotion with the Activate promotion API method.

To create a promotion, use the Create discount promotion for item API method.
To deactivate a promotion, use the Deactivate promotion API method.

Bonuses

To update the promotion:

1. Get data from the catalog with Get bonus promotion or Get list of bonus promotions API methods.
2. Pass new parameter values with the Update bonus promotion API method.
3. Activate the promotion with the Activate promotion API method.

To create a promotion, use the Create bonus promotion API method.
To deactivate a promotion, use the Deactivate promotion API method.

Updating by importing from external systems

Follow the instructions to import data from external systems like PlayFab or Google Play.

Rate this page

Is there anything we can improve? Send

Don’t want to answer

Thank you for your feedback!