Skip to main content

CHANGELOG

News

Documentation updates and release notes for the Xsolla SDK.

This page contains information about any additions or updates to the Xsolla SDK documentation.

[3.1.11] - 2026-07-16​

  • Renamed the Integration Articles category (formerly "Technical Articles").
  • Refreshed the SDK 3 integration guides.
  • Added a Video Guides section with integration walkthrough videos.

[3.1.10] - 2026-07-07​

  • (iOS, Unity) Expanded iOS external-payment compliance guidance to cover Brazil alongside the United States across the iOS and Unity docs, and consolidated the iOS SDK's regional configuration into a single, market-based section.
  • (iOS) Clarified in the purchase validation docs that the SDK's transaction callbacks still fire during server-side validation but are for UI only — the backend awards entitlements from the webhook.

[3.1.9] - 2026-07-06​

  • (iOS) Added a Troubleshooting page covering empty catalogs, purchase restoration, URL scheme setup, login errors, main-thread warnings, and the hosts to allowlist for firewalls.
  • (iOS) Clarified in configuration and purchase docs that restoreCompletedTransactions() is a no-op and transactions must be finished to avoid re-delivery on the next launch.
  • (iOS) Documented that useSandbox defaults to true and must be turned off before going live.

[3.1.8] - 2026-06-02​

  • (Android, iOS, Unity, Windows) Clarified in the initialization docs that the SDK loads Virtual Items only.

[3.1.7] - 2026-05-08​

  • Fixed the integration widget layout to remove forced horizontal padding, preventing visual overflow when the browser window is narrow.

[3.1.6] - 2026-04-02​

[3.1.5] - 2026-04-01​

  • Added a Download SDK button to the navigation bar.
  • (Android) Expanded the consumption section with updated purchase flow diagrams.
  • (Android) Updated the client-side validation diagram to include the consume request to Xsolla services.
  • (Android) Added an event listeners API reference to configuration docs.
  • Updated the integration widget with a correct How to Install link for Android GitHub Maven.

[3.1.4] - 2026-03-18​

[3.1.3] - 2026-03-05​

  • Added interactive SDK integration widget.
  • (Android, Unity) Updated configuration API references and method names.
  • (iOS) Added SPM installation instructions.
  • Reworked landing and Publisher Account pages with new layouts.
  • Reworked quick-start guides with timeline layouts.
  • Standardized terminology and proper noun capitalization across documentation.

[3.1.2] - 2025-12-22​

  • (Unity) Updated Configuration around mobile purchase settings, purchase restoration, and deep link overrides.
  • (iOS, Unity) Added “purchase cancelled” handling examples to purchase flow docs.
  • (iOS, Unity) Clarified iOS Storefront behavior for alternative distribution installs.
  • (iOS) Added an advanced guide for Universal Links and linked it from deep link configuration docs.

[3.1.1] - 2025-10-16​

[3.1.0] - 2025-10-07​

ℹ️ANDROID

Following the Supreme Court's refusal to pause the ruling, effective October 29, 2025, Google must permit U.S. Google Play apps to guide users to external payment methods via link-outs and allow the use of alternative billing solutions. This change enables developers to avoid Google's fees and inform users about lower-cost options outside Google Play—fostering more competitive pricing and greater revenue control.

Read more on the Xsolla Blog: New platform rules for Android—what developers need to know ↗ (https://xsolla.com/blog/new-platform-rules-for-android-and-what-developers-need-to-know)

Learn more about the Buy Button: Xsolla Buy Button ↗ (https://xsolla.com/mobile-buy-button)

[3.0.4] - 2025-09-23​

[3.0.3] - 2025-09-02​

[3.0.2] - 2025-08-21​

[3.0.1] - 2025-08-18​

  • Documented default Pay Station payment method configuration on iOS.

[3.0.0] - 2025-08-12​

  • Major documentation rework around the new Xsolla SDK, which supersedes the legacy Xsolla Mobile SDK.
  • Unity is now a dedicated top-level section with guides for all supported platforms (Mobile, PC, Web).
  • Mobile documentation is split into platform-specific pages: separate Android and iOS guides across quick start, installation, initialization, configuration, purchase, testing, validation, and advanced topics.
  • Added information on authentication using third-party social provider access tokens.

[1.1.4] – 2025-08-06​

  • Events API: introduced full documentation for the Xsolla Events API in Publisher Account webhooks and in Android & Unity SDK configuration guides, including setup steps, code samples, and caution notes.
  • Trusted Web Activity: added Android and Unity sections covering TWA configuration, splash-screen options, fallback behavior, and accompanying assets.
  • iOS configuration: expanded with purchase restoration settings, automatic vs. manual deep-link handling (incl. URL-scheme setup), and orientation management examples.
  • Quick-start & overview pages: updated top-level README and quick-start guides with concise notes on DMA compliance, global payment methods, and rapid onboarding.

[1.1.3] - 2025-07-16​

  • Enhanced iOS Configuration with improved organization and structure, deep link handling guidance, Web Shop link-outs and Buy Button Solution documentation, and Purchase Restoration Settings configuration.

2025-06-26​

On 26th of June, Apple has released the following changes for apps distributed on the App Store in the EU. Developers can now communicate and promote offers for digital goods or services, including steering to external payment options through the StoreKit External Purchase Link Entitlement.

While you can use Xsolla Mobile SDK to serve external payments and comply with these new EU requirements through Apple's Alternative Terms Addendum for Apps in the EU or StoreKit External Purchase Link Entitlement (EU) Addendum (contact your account manager for access and implementation guidance), we recommend using Web Shops as a more viable and streamlined alternative for maximum flexibility and reduced complexity in the current regulatory landscape.

Read more about Apple's EU payment rules ↗

[1.1.2] - 2025-06-25​

  • Unity now has its own subsection (Unity)
  • Aggregated mobile platforms (Android/iOS) under their own section (Mobile)
  • Added diagrams and flow mapping comparison tables to Purchase Validation (Android)
  • Added links to virtual items external documentation in Publisher Account -> Virtual Items
  • Moved iOS US & EU compliance into a separate page (Unity -> SDK -> Configuration -> iOS)

[1.1.1] - 2025-06-09​

  • Improved Quick Start Guide with better organization and clearer structure
  • Added Storefront Detection documentation for Unity integration
  • Enhanced Installation Guide with iOS version support details
  • Updated Webshop Integration documentation with Buy Button information
  • Updated Configuration with custom login token configuration example for iOS
  • Added cross-platform compatibility information to Unity Integration examples
  • Improved navigation and external links throughout the documentation
  • Added information about Buy Button and alternative billing options to the landing page

[1.1.0] - 2025-05-07​

  • Updated to ensure compliance with Apple's revised App Store guidelines.
  • The Xsolla Mobile SDK is now stable and ready for production use.
  • Added an article on how to detect iOS Storefront.
  • Improved an article on how to detect store installation for iOS.

[1.0.1] - 2024-07-26​

[1.0.0]​

  • Initial revision.