Presentation Options (Android)
Learn the three ways to present Stash Pay in your Android games - system browser, Chrome Custom Tabs, or fully integrated Stash Dialog. Understand the recommended approaches for different regions.
You can present Stash Pay in your Android games in three ways: open the checkout in the system browser, use Chrome Custom Tabs as an in-game browser overlay, or fully integrate with the Stash Dialog from the Stash SDK.
As of Q3 2025, use Chrome Custom Tabs for users in the United States and a standard browser linkout for other regions.
Chrome Custom Tabs / Browser
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.
Choosing the Right Flow
Selecting the appropriate presentation method depends on your integration requirements, compliance needs, and user experience goals.
Decision Guide
| Requirement | Recommended Flow | Why |
|---|---|---|
| Compliance in United States | Chrome Custom Tabs | Meets Google Play's external payment requirements while keeping users in-app |
| Compliance outside United States | Web Browser | Simple, compliant solution that works globally |
| Native callbacks needed | Stash Pay Dialog | Provides direct success/failure callbacks to your game code |
| Deep link handling only | Chrome Custom Tabs or Web Browser | Both support deep link returns after purchase completion |
| Maximum customization | Stash Pay Dialog | Full control over appearance and styling to match your game |
| Simplest integration | Web Browser | No SDK required, works with basic deep link setup |
| Best user experience | Chrome Custom Tabs or Stash Pay Dialog | Keeps users in-app with seamless transitions |
Flow Comparison
| Feature | Stash Pay Dialog | Chrome Custom Tabs | Web Browser |
|---|---|---|---|
| SDK Required | Yes | Yes | No |
| In-App Experience | ✅ Fully integrated | ✅ Overlay | ❌ External |
| Callbacks Available | ✅ Success/Failure/Dismiss | ❌ Dismiss only | ❌ None |
| Deep Link Required | Optional | Optional | ✅ Required |
| Customization | ✅ Full styling control | ⚠️ Limited | ❌ None |
| Compliance (US) | ✅ Compliant | ✅ Compliant | ✅ Compliant |
| Compliance (Global) | ✅ Compliant | ✅ Compliant | ✅ Compliant |
| User Stays In-App | ✅ Yes | ✅ Yes | ❌ No |
Recommendation: For most games, Chrome Custom Tabs provides the best balance of compliance, user experience, and simplicity. Use Stash Pay Dialog when you need native callbacks or extensive customization.
How is this guide?