Bundles
How it works
Bundle is a set of several items that are sold as a single unit.
Main features:
- Add items of different types to a bundle:
- virtual currency (including the platform-dependent currency)
- package of virtual currency
- game keys for preselected DRMs
- virtual items including time-limited items
- bundles
- Configure the bundle pricing in real and virtual currencies.
A bundle automatically unpacks after:
- successful purchase
- successful granting to the player inventory via inventory management methods
Items delivery method from an unpacked bundle depends on the item type:
- virtual currency packages, virtual items, time-limited items, and bundles are delivered to:
- inventory (default method)
PlayFab , if you configured the integration
- game keys are delivered to:
- email (default method)
PlayFab , if you configured the integration
When the buyer returns the bundle by canceling a transaction (for example), all granted items from the bundle are automatically withdrawn from the user. If they spent some of the items, the remaining items are still withdrawn.
Restrictions:
- You can’t add the following items to the bundle:
- the same bundle
- physical goods
- You can’t create an empty bundle.
- The bundle sales are paused after you run out of keys to sell and these keys are included in the bundle.
- The bundle price should be a fixed value of real and/or virtual currency.
- You can configure regional restrictions for a bundle only via API.
Who can use it
For partners who want to sell sets of items for a price lower than the initial total of all items in the bundle, which increases sales and helps to get new players, and who have integrated one of the following products (or both):
- In-Game Store with configured Virtual Items or Virtual Currency modules.
Buy Button with the configured Game Keys module.
How to get it
Integration flow
Set up bundle
Set up bundles in one of the following ways:
Set up via Publisher Account
- Go to Publisher Account > Store > Bundles and click Create bundle.
- Specify the following parameters for a bundle:
- Image
- Name
- Description
- Contents
- Price
- Display in Store
- Check the settings and click Save.
Set up via API methods
To set up bundles, you can use the methods from the
Add game key to bundle
To add a game key for a selected DRM to a bundle, pass an array with SKUs of needed DRMs to
- http
"content": [{
“sku”: “brilliant_game_sku_steam”,
“quantity”: 1
}
]
Set up regional restrictions
To set up regional restrictions for a bundle, pass an array with IDs of supported regions to
- http
"regions": [{
“id”: “123”
}, {
“id”: “456”
}
]
Set up regional prices
To set up regional prices for a bundle, pass an array of objects with price settings for regions to
- http
"regional_prices": [{
“region_id”: “123”,
“country_iso”: “CHN”,
“amount”: 40,
“currency_iso”: “CNY”,
“is_default”: true,
“is_enabled”: true
}
]
Get bundles in a catalog
To get a catalog of bundles, you can use the methods from the
Was this article helpful?
Rate this page
Don’t want to answer
Thank you for your feedback!
Found a typo or other text error? Select the text and press Ctrl+Enter.