Set up subscription sales

Web Shop supports selling subscriptions directly via the web interface, without needing to set them up in app stores. This allows you to gain control over the subscription terms, integrate regional payment systems, and reduce costs related to third-party platform restrictions and fees.

Xsolla provides all the tools you need to configure and manage subscriptions — both for you and your users:

• On your side, subscription management is available in Publisher Account. You can create and configure plans for each currency, set trial periods, configure grace periods, view subscribed users, and change subscription statuses for specific users, and more.
• Users can manage their subscriptions in Web Shop. If a user is signed in, the Manage plan button appears for their active subscriptions. Clicking on the button opens a subscription management interface where the user can, for example, view subscription details, renew or cancel subscription.

How to get it

To add subscription sales to the Web Shop:

1. Set up a subscription plan in Publisher Account.

2. Set up subscription sales on your site.
3. Implement retrieving information about subscriptions purchased by the user in your application.

Set up subscription sales on your site

To add subscription sales, you need to add a button to your site and configure the Purchase subscription action for it. You can use customizable buttons in the Header, Card grid, and Game editions blocks.

We recommend using the Cards grid block for subscription sales — it offers extensive customization options for both the cards themselves and their layout.

To make subscriptions available for purchase in Web Shop:

1. Open your project in Publisher Account and go to the Storefronts > Websites section.
2. Select your site and click Open Site Builder.
3. In the main area of the builder, choose a place where you want to add a new block and click Add block.
4. Add the Card grid block and set it up. For example, specify a title, set a background, and add texts.
5. In the main area of the builder, configure the card grid:

1. 1. To split any grid area vertically or horizontally, click the icon with a vertical or horizontal line in the upper-left corner of the area.

1. 2. To set the height or width of an area, drag the ║ or ═ icon.

6. Go to the card settings. To do this, click the ⚙ icon.

7. Add a subscription purchase button to the card:

1. 1. Click Add button.

1. 2. In the Action drop-down list, select Purchase subscription.
   3. In the Subscription plan drop-down list, select the plan you created earlier.

1. 4. Change the button style (optional).

8. Customize the subscription purchase button text (optional):

1. 1. In the main area of the builder, click on the button text.
   2. Enter the desired text. By default, the button displays the subscription price or the number of trial days if a trial period is set in the selected subscription plan. When editing the text, you can also include the subscription price or trial period using the following variables:

1. 1. • {priceDefault} — base price. If there's a discount, this value will be struck through.
      1. Example of text display on the site:
         • $0.09 per month — if the subscription is not discounted.
         • $0.09 per month — if the subscription is discounted.
      • {pricePromo} — final subscription price with discount.
      • {trial} — number of trial days.

9. Configure other card settings. For example, add text, images, and background.
10. Configure other cards in the grid.

11. To apply changes, click Publish.

Useful links