Create catalog

A catalog lists items that are available for purchase. You can use the Payments solution to sell virtual items — in-game content that a user can buy for real or virtual currency. Selling virtual items is one of the main ways to monetize games.

The item catalog must be stored on Xsolla’s side. You can implement it with one of the following ways:

  • Transfer the catalog you already have to Xsolla. You can import your catalog from PlayFab or Google Play.
  • Create a catalog on Xsolla’s side. To do that, follow the instructions.

Import catalog

Get items list

To get the list of items, call the Get virtual items list API method:

  • In the request header, pass the Xsolla Login JWT (Bearer token) used for authorization by default. To test calling this API method, you can use the following test token: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE5NjIyMzQwNDgsImlzcyI6Imh0dHBzOi8vbG9naW4ueHNvbGxhLmNvbSIsImlhdCI6MTU2MjE0NzY0OCwidXNlcm5hbWUiOiJ4c29sbGEiLCJ4c29sbGFfbG9naW5fYWNjZXNzX2tleSI6IjA2SWF2ZHpDeEVHbm5aMTlpLUc5TmMxVWFfTWFZOXhTR3ZEVEY4OFE3RnMiLCJzdWIiOiJkMzQyZGFkMi05ZDU5LTExZTktYTM4NC00MjAxMGFhODAwM2YiLCJlbWFpbCI6InN1cHBvcnRAeHNvbGxhLmNvbSIsInR5cGUiOiJ4c29sbGFfbG9naW4iLCJ4c29sbGFfbG9naW5fcHJvamVjdF9pZCI6ImU2ZGZhYWM2LTc4YTgtMTFlOS05MjQ0LTQyMDEwYWE4MDAwNCIsInB1Ymxpc2hlcl9pZCI6MTU5MjR9.GCrW42OguZbLZTaoixCZgAeNLGH2xCeJHxl8u8Xn2aI.
  • In the project_id path-parameter, pass the project ID that you can find in Publisher Account:

In the response, you will receive detailed information about virtual items created in your project. For the subsequent order creation, you need the item SKU that is passed in the items.sku parameter.

Your progress
Thank you for your feedback!
Last updated: February 9, 2024

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!