Understand the UPI Collect flow, its deprecation timeline, and how to migrate to compliant UPI payment methods on Cashfree in line with NPCI guidelines.
The National Payments Corporation of India (NPCI) has mandated a phased deprecation of the UPI Collect flow for P2M (Person-to-Merchant) transactions to enhance security and reduce fraud. This change impacts all merchants using UPI Collect for payments.
Applies to: Mobile web and native SDK integrations using standard Cashfree Hosted CheckoutAction required: No action neededImpact: Cashfree has removed the Collect option from hosted checkout on Android and desktop. Alternate flows (Intent and QR) are already supported, so customers won’t experience disruptions. iOS still allows Collect until further notice.
Non-seamless merchants using WebView
Applies to: Android or iOS mobile WebView integrations using Cashfree CheckoutAction required: The following scenarios determine your required actions:
Scenario A (Not using standard Checkout): No action required.
Scenario B (Using standard Checkout in WebView): Implement specific code changes to ensure UPI Intent displays correctly. Refer to the Android Custom Checkout documentation for WebView integration details.
Seamless merchants (Custom checkout or API-based integration)
Cashfree requires visibility into the customer’s device to enforce NPCI rules. You must pass the following headers in your Order Pay API and Get Eligible Payment Methods request:
Header
Example value
Requirement
x-client-device
mobile
Required
x-client-os
ios
Required
x-client-rendering-type
mweb
Required (when device=mobile)
x-client-browser
safari
Required
Header values:
Header
Accepted values
Description
x-client-device
mobile, desktop, tablet
Type of device used by customer
x-client-os
android, ios, windows, macos, linux, others
Operating system of customer’s device
x-client-rendering-type
mweb, webview, native
How the checkout is being rendered
x-client-browser
safari, chrome, firefox, edge, others
Browser used by customer
Merchant type and rendering type details:
Merchant type
Rendering type
What does it mean
Impact or required changes
Non-seamless merchants using Cashfree checkout
Native
Payment rendered natively within the merchant’s mobile app using Android and iOS SDKs
Cashfree has removed UPI Collect from hosted checkout on Android and desktop. Alternate flows (UPI Intent and QR) are already supported. iOS still allows Collect until further notice, with no customer disruption.
Non-seamless merchants using Cashfree checkout
MWeb
Payment rendered in a mobile browser using JS SDK (browser on a mobile device)
Cashfree has removed UPI Collect from hosted checkout on Android and desktop. Alternate flows (UPI Intent and QR) are already supported. iOS still allows Collect until further notice, with no customer disruption.
Non-seamless merchants using Cashfree checkout
WebView
Payment rendered inside an in-app browser using JS SDK (WebView within a merchant app)
Using standard Checkout in WebView requires code changes to ensure UPI Intent displays correctly. Refer to the WebView integration documentation for required changes.
Seamless merchants using custom checkout or API-based integration
Not applicable
Mobile and Desktop flows
Mobile: Enable and prioritise UPI Intent. Remove UPI Collect as a payment option based on device rules. Desktop: Use UPI QR. Remove UPI Collect.
Cashfree requires visibility into the customer’s device to enforce NPCI rules. You must pass the required headers in your Order Pay API request as detailed in the header values table above.
If headers aren’t passed, Cashfree assumes full migration to Intent or QR flows. UPI Collect is allowed only in permitted environments (iOS and exempt transaction categories).
Have you updated the Order Pay API with client environment headers (seamless merchants only)?
Seamless merchants must pass client environment headers to allow Cashfree to enforce NPCI device-specific rules correctly.
Review the API documentation section above to see required and optional headers, or consult the Order Pay API documentation for implementation details.
Are you monitoring Cashfree updates for final NPCI enforcement dates?
NPCI enforcement timelines are subject to change. Stay updated to ensure your implementation remains compliant with the latest regulatory requirements.
Review the Timeline and compliance section above, or contact your Account manager for the latest enforcement date information.
The following questions cover UPI Collect behaviour on Cashfree mobile SDKs.
Does UPI Collect work on Android devices using the Cashfree SDK?
UPI Collect is deprecated and no longer in use on Android. Use UPI Intent on Android, and UPI QR on desktop.iOS still allows UPI Collect until NPCI gives further notice. Some transaction categories remain exempt on Android, including IPO, UPI mandates, eRupi vouchers, and PACB flows. See Device-specific UPI rules.If you use Cashfree Hosted Checkout, Cashfree has removed Collect from checkout on Android and desktop. If you use a custom checkout or the Order Pay API, remove Collect for non-exempt Android and desktop traffic and upgrade to the latest SDK so UPI Intent is available.
Does the UPI Collect deprecation apply in Sandbox as well?
Yes. The same UPI Collect deprecation rules apply in both the sandbox and production environments. This is a regulatory change and is not specific to individual accounts.To test UPI in sandbox, use UPI QR Code (scan with a mobile device) or UPI Intent (test on a mobile device or emulated WebView). For device-specific exceptions, see Does UPI Collect work on Android devices using the Cashfree SDK?.
Why is the option to send a UPI payment collect request to a customer's VPA no longer available?
The ability to send a payment collect request to a customer’s UPI ID (where the customer enters their VPA and receives a request on their UPI app) is discontinued for merchant payments (P2M) in line with NPCI and RBI guidelines. This regulatory change applies to all payment gateways in India, and Cashfree can’t re-enable it. The discontinuation covers both customers entering their UPI ID on the checkout page and merchants sending collect requests from the Merchant Dashboard.For alternatives, use UPI QR on desktop and UPI Intent on mobile. See Device-specific UPI rules.
Why do customers only see a QR code and not UPI app icons on mobile?
If customers only see a QR code instead of UPI app icons (UPI Intent), the cause is usually the integration environment. For mobile apps using a WebView, UPI Intent requires specific handling to intercept UPI scheme URLs (such as upi://, gpay://, or phonepe://) to launch the respective apps. If your WebView doesn’t implement this handling, only the QR code appears.For Cashfree Hosted Checkout on mobile browsers, UPI app icons appear automatically. See UPI Intent in WebView for implementation details.