Unity IAP: How to configure your webshop

A Unity Webshop is a browser-based storefront that lets players buy items from your game's in-app purchase catalog on the web instead of through an in-game store, routing transactions outside the game and offering more flexibility and margin for your studio. Unity Webshops are created in the Unity Cloud Dashboard, connected to a payment provider such as Stripe or Coda Payments, and opened from inside the game through a link.

Note: This article uses guidance relevant in August 2026 for Unity IAP 5.4. Later releases may include new features or updated UI.

This is the final article in Unity's three-part IAP 5.4 series, alongside Upgrading from IAP 4 to IAP 5 and Implementing Payment Providers.

1. Create the webshop

In the Unity Cloud Dashboard, open In-App Purchasing in the left sidebar and select Go to Webshop, then Create Webshop. If you are setting this up for the first time, you will be greeted by an onboarding tour. Click Create Webshop to get started.

Two fields are required:

• Project: Name the project the storefront belongs to. A dedicated test project is recommended for a first setup.
• Studio name: Enter your official studio name. Note that this name applies globally to all webshops in your organization, so keep it consistent across your brand.

Once created, you will enter the Webshop Editor panel, which features a General Panel to configure your unique Shop URL, a production environment switcher, and an interactive Preview Window on the right side to track your progress in real-time.

2. Test the layout with the mock catalog

Enable Preview Only / Mock Catalog to populate the storefront with mock placeholder items such as gems, battle passes, and starter packs. No live financial data is processed in this mode. Click the preview URL to open the mock catalog in a new browser tab.

3. Theme the storefront

Unity makes branding your webshop incredibly intuitive through automated theme generation, automatically using an uploaded image. In the Customize Theme panel, upload key art or a thumbnail and select Generate Theme; the system extracts a color palette and applies it across the shop.

For specific adjustments, use the Refine with AI chat tool above the preview window. A plain-language instruction such as "change the font type to Inter" updates the underlying theme JSON and applies the change to item descriptions, prices, and buttons.

4. Add the production catalog and payment provider

Once you’re happy with the design, disable the mock catalog and select Manage Catalog. Switch the environment dropdown from Development to Production, then choose Add Catalog Listing.

Each listing requires:

• Item metadata
• Base price
• Localized prices
• An image URL served from a CDN

For hosting item icons, you can link your image URLs to a Content Delivery Network (CDN), such as Google Cloud Storage, Cloudflare, or Unity’s own Cloud Content Delivery.

In the Catalog & Payment Provider card, select a primary payment provider (Unity integrates well with platforms like Stripe and Coda Payments) and designate a fallback provider so checkout still completes if the primary provider is unavailable in a player's region.

5. Run a test transaction

Select Save Draft and open the Dev Preview URL in a browser.

Select Buy Now on a test item to launch the provider's secure checkout modal.

Enter an email address, a provider test card number, and a valid test address, then pay.

For repeat purchases on the same credentials, enter all zeros when prompted for the mock verification code.

A successful purchase confirmation means the webhooks and payment gateway are communicating correctly.

6. Connect the webshop to your game

Unity opens the webshop through an authorized deep link from the StoreController tied to your active payment provider. The deep link packages the player's authenticated session token and hands off to the device's external browser.

CSharp:

// Open the front page

UnityIAPServices.StoreController(PaymentProvider.Name)

.PaymentProvidersExtendedPurchaseService.RedirectToWebshop();

// Open a specific product page

UnityIAPServices.StoreController(PaymentProvider.Name)

.PaymentProvidersExtendedPurchaseService.RedirectToWebshop(catalogListingId: "your-listing-id");

This method securely packages the player's authenticated user session token and deep-links them straight out of the game application into their external browser to complete the transaction smoothly. You can read more about it in the documentation.

For an overview of all the options to integrate your in-app purchases, including webshops, review the following infographic and download the high-resolution PDF here.