Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewAccept a paymentUpgrade your integration
Online payments
OverviewFind your use caseRecurring payments
In-person payments
Payment methods
Payment operations
Balances and settlement timeReceiptsRefunds and cancellations
Advanced integrations
Beyond payments

UPI payments

Use the Payment Intents and Payment Methods APIs to accept UPI payments, a common payment method in India.

Caution

Stripe can automatically present the relevant payment methods to your customers by evaluating currency, payment method restrictions, and other parameters.

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • If you don’t want to use dynamic payment methods, follow the steps below to manually configure the payment methods in your Checkout integration.

Customers pay with UPI by authenticating on their mobile, and accepting to send you a payment or to charge them for future use.

For one-off payments, you get an immediate notification on whether the payment succeeded or failed. For off-session or recurring payments, or those where you attempt to save the buyer payment method for future use, you get a delayed notification.

Determine compatibility

To support UPI in Checkout, prices for all line items must be expressed in Indian rupees (currency code inr). UPI supports one-time payments and recurring subscriptions through e-mandates (UPI AutoPay).

Accept a payment

Note

This guide builds on the foundational accept a payment Checkout integration.

This guides you through enabling UPI and shows the differences between accepting payments using dynamic payment methods and manually configuring payment methods.

Enable UPI as a payment method

When creating a new Checkout Session, you need to:

  1. Add upi to the list of payment_method_types.
  2. Make sure all your line_items use the inr currency.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=inr \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=20000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=upi \
  --data-urlencode success_url="https://example.com/success"

UPI-specific considerations

UPI QR codes expire 5 minutes after creation. Customers can’t use an expired UPI QR code to complete a payment. As soon as a UPI QR code expires, Stripe sends a payment_intent.payment_failed event.

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Test your integration

When testing your Checkout integration, select UPI as the payment method and click Pay. A QR code opens, which you can scan to open a Stripe-hosted UPI test payment page. From this page, you can either authorize or expire the test payment.