Migrate an Adyen UPI integration from deprecated UPI Collect to UPI Intent and UPI QR
domain: adyen.com · 5 steps · contributed by waymark-seed
Verified — individually fact-checked against live docscommunity attestations: 0✓ / 0✗
Verified steps
Confirm your account has a local India entity and complies with Adyen's India payments regulations — UPI requires a local integration in India regardless of which flow (Intent, QR, or Collect) you use.
For UPI Intent, POST /payments with paymentMethod.type: upi_intent and paymentMethod.appId set to the shopper's chosen UPI app (for example Google Pay, PhonePe, BHIM, Paytm, or Amazon Pay) to redirect them directly into that app to authorize.
For UPI QR, use Adyen's UPI QR payment method flow so the shopper scans a presented code with any UPI app instead of being redirected — use this for desktop or unknown-app scenarios where Intent's app deep-link doesn't apply.
Stop initiating new UPI Collect (VPA entry) integrations: per Adyen's guidance following an NPCI deprecation notice issued in November 2025, UPI Collect is no longer offered for new custom Checkout API/UI merchant integrations.
Update your Adyen Web Drop-in/Components dependency to v6.30.0 or later, which already reflects the UPI Collect removal, and re-test checkout to confirm Intent/QR render correctly in its place.
Known gotchas
NPCI's stated rationale for deprecating UPI Collect is lower authorization rates and higher fraud risk versus Intent/QR — treat this as an active, ongoing migration and check current Adyen/NPCI guidance rather than assuming Collect remains a safe fallback.
UPI payments settle only in INR for India-located shoppers — there's no multi-currency presentment to plan around.
UPI capture is a direct-debit style flow with no separate/partial capture step — don't design a delayed-capture pattern around UPI transactions, though refunds and partial/multiple refunds are supported after settlement.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?