CONFIGURATION
Configuration - iOS
Redirecting players to external web payments (US, Japan, Brazil)
In the United States, Japan, and Brazil, Apple lets developers direct players to external web payments. Use WebViewType.External:
settings = XsollaClientSettings.Builder.Update(settings)
.SetWebViewType(XsollaClientSettings.WebViewType.External)
.Build();
In-app payment compliance in Europe under the DMA
In the EU either works: keep the flow in the app, or send the player to the web with WebViewType.External. Apple charges a different commission for each, and from October 1, 2026 you have to keep whichever you pick for 12 months.
To keep the flow in the app, use WebViewType.Auto:
settings = XsollaClientSettings.Builder.Update(settings)
.SetWebViewType(XsollaClientSettings.WebViewType.Auto)
.Build();
For more advanced compliance scenarios, you can programmatically detect the user's region and distribution channel to automatically configure the appropriate settings. Learn how to detect iOS storefront to enable external payments for the regions that permit them, or detect alternative app distribution status for enabling EU-specific compliance flows based on the app's installation source.