Offerwall

How it works

Offerwall is a page featuring various paid ads and offers that reward users with free virtual currency for completing certain tasks (e.g., earn 1000 coins for reaching level 11). The Offerwall functions as a marketplace connecting advertisers, game publishers, and their users.

The quests or offers are paid placements from advertisers — both gaming and non-gaming — who pay based on performance or engagement. Gaming advertisers typically use these quests for user acquisition, while non-gaming advertisers run cost-per-acquisition (CPA) campaigns and pay for actions such as app downloads, account sign-ups, or other purchases.

When you agree to integrate the Offerwall into your game (either in-app or via your Web Shop), you set the currency exchange rate through a webhook integration (X USD = Y units of game-specific currency). Once a quest is completed, the advertiser pays Xsolla the gross amount, which is then shared with the game publisher according to a revenue-sharing model.

How to get it

1. Complete the prerequisites.
2. Attract users to your Offerwall page:
   • By providing them with a link to the Offerwall in your website/app.
   • By adding an Offerwall block to your Web Shop. An Offerwall block in Web Shop allows you to attract users to your Offerwall page by displaying call-to-action banners, informing your community that the Offerwall is live, and highlighting personalized rewards.

Prerequisites

1. Create virtual currency.

2. Set up webhooks to validate users and reward them with virtual currency:
   1. Configure handling for the following webhooks:
      • User validation. Xsolla sends this webhook to verify that a user is registered in the game. The request is sent multiple times as part of the rewarding/payment process.

 1{
 2  "notification_type": "user_validation",
 3  "settings": {
 4    "project_id": 123456,
 5    "merchant_id": 789012
 6  },
 7  "user": {
 8    "id": "11111111-1111-1111-1111-111111111111"
 9  }
10}

1. 1. • Successful payment for order (with payment and transaction details). Xsolla sends this webhook when a user completes an offer. In the example response below, the user is rewarded with 100 gold coins. The player ID is passed as a query parameter in the URL of the Offerwall page.

 1{
 2  "user": {
 3    "email": "noreply+offewall@xsolla.com",
 4    "country": "US",
 5    "external_id": "11111111-1111-1111-1111-111111111111"
 6  },
 7  "items": [
 8    {
 9      "sku": "GOLD_COINS",
10      "type": "virtual_currency",
11      "amount": "0.01",
12      "quantity": 100,
13      "promotions": [],
14      "is_pre_order": false
15    }
16  ]
17}

1. 2. Test your webhooks.

How to add block to site built with Xsolla site builder

To add an Offerwall block:

1. Open the project in Publisher Account and go to the Storefronts > Websites section.
2. In the Sites section, select your site and click Open Site Builder.
3. Click Add block.
4. Select the Offerwall block.

5. Customize the block (optional):
   • Configure the block layout.
   • Select the background color and image.

5. • Configure a button.
   • Configure a header.

How to provide users with Offerwall link

You can provide users with a direct link to the Offerwall, for example:

• An upsell image in the in-app purchase shop.
• A marketing message in the app feed or main menu (e.g., “Earn Free Coins!”).
• A push notification (with user consent) leading to an in-app Offerwall page.
Note
If you plan to use the Offerwall independently of your site built with Xsolla site builder, please contact the Offerwall team at offerwall_publishers@xsolla.com.
Offerwall URL address has the format given below, where:
• GAMER_ID is the in-game user ID unique to your app, Xsolla supports any simple alphanumeric string. We recommend using the UUID format.
• PLACEMENT_ID is the placement ID driving the traffic, which also indicates the app from which the user is coming.
Copy

Full screen

Small screen

1http://quests.xsolla.com/offerwall/<PLACEMENT_ID>?gamer_id=<GAMER_ID>  

Was this article helpful?
Yes
No
Thank you!
Is there anything we can improve? Message Send
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message Send
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Last updated: January 26, 2026

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