Repository navigation
Document deep links to payment apps on Android - #534
Merged
Merged
Conversation
Coverage Report
|
kieran-osgood-shopify
marked this pull request as ready for review
October 1, 2026 10:14
markmur
approved these changes
Oct 2, 2026
Explain that deep links are dropped when no installed app handles a declared scheme, link to the <queries> element docs, and cover both causes in troubleshooting.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changes are you making?
Adds a Deep links to payment apps - Android subsection under Offsite Payments. It explains how to support payment providers that open another app through a custom-scheme deep link, such as BankID (
bankid://) for Klarna in Sweden, or UPI apps (upi://) in India.On Android, the React Native module uses the native
DefaultCheckoutEventProcessor, which only opens a deep link whenqueryIntentActivitiesreturns a matching app. Since Android 11 (API 30), package visibility hides other apps unless the host app declares them in<queries>. Deep links for undeclared schemes are silently dropped. The buyer taps the payment button, nothing opens, and the payment times out.This README said nothing about the requirement, so React Native and Expo apps had no way to discover it (see #571 in
checkout-sheet-kit-android). The new subsection covers:Related: Shopify/checkout-sheet-kit-android#571
PR Checklist
Important