Presentation Options
Learn the three ways to present Stash Pay in your iOS and Android games - system browser, in-game browser overlays (Safari View Controller and Chrome Custom Tabs), or fully integrated Stash Dialog. Understand the recommended approaches for different regions and platforms.
You can present Stash Pay in your iOS and Android games in three ways: open the checkout in the system browser, use an in-game browser overlay (Safari View Controller for iOS or Chrome Custom Tabs for Android), or fully integrate with the Stash Dialog from the Stash SDK.
As of Q3 2025, use Safari View Controller (iOS) or Chrome Custom Tabs (Android) for users in the United States and a standard browser linkout for other regions.
iOS Presentation Options
Web browser
When the player requests a purchase, the game client opens the default system browser with a Stash Pay checkout page.
After the player completes the purchase, the game client returns the player to the game through a deep link. This option does not require an SDK. The browser handles checkout before gameplay resumes.
Safari View Controller
Recommended: This is the recommended solution for iOS.
Use the native iOS SFSafariViewController to present Stash Pay in a popup overlay. Players stay in the game while the payment process runs in an isolated browser environment.
This option ensures compliance with App Store rules. The Stash SDK supports and wraps this integration.
Stash Pay Dialog
You can use Stash Pay Dialog as a fully integrated replacement for Apple In-App Purchase (IAP).
It runs in a native WKWebView and provides direct callbacks to your game for successful or failed purchases. The dialog matches your game's style.
Android Presentation Options
Web browser
When the player requests a purchase, the game client opens the default system browser with a Stash Pay checkout page.
After the player completes the purchase, the game client returns the player to the game through a deep link. This option does not require an SDK. The browser handles checkout before gameplay resumes.
Chrome Custom Tabs
Recommended: This is the recommended solution for Android.
Use the Chrome Custom Tabs from Android androidx.browser.customtabs.CustomTabsIntent to present Stash Pay in a customizable browser overlay. Players stay in the game while the payment process runs in an isolated browser environment.
This option ensures compliance with Google Play Store rules. The Stash SDK supports and wraps this integration.
Stash Pay Dialog
You can use Stash Pay Dialog as a fully integrated replacement for Google Play In-App Purchase (IAP).
It runs in a native WKWebView and provides direct callbacks to your game for successful or failed purchases. The dialog matches your game's style.
How is this guide?