Body
UPI Collect Payment
Create a collect transaction for given VPA. In UPI collect transaction, payment collect request is sent to the UPI app.
Note
Please use the relevant parameters received from the Payment Method API in UPI for payment_method_type and payment_method fields.
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/txns
Production Link
POST
https://api.juspay.in/txns
Headers
Content-Type
*
String
Mandatory
application/x-www-form-urlencoded
x-routing-id
*
String
Required
We recommend passing the customer_id as the x-routing-id. If the customer is checking out as a guest, you can pass an alternative ID that helps track the payment session lifecycle. For example, this could be an Order ID or Cart ID.
Warning
This ID is associated with the customer. It plays a key role in ensuring consistency and maintaining connections across different systems. If you fail to pass the same x-routing-id for the same customer in all related API calls, it could lead to issues with API functionality. Therefore, it’s crucial that you use the same x-routing-id for all requests tied to the same customer.
Example:- customer_1122
Parameters
order_id
*
string
Mandatory
order\_id pertaining to the order for which the payment is started.
merchant_id
*
string
Mandatory
ID of the merchant_account that you hold with us.
payment_method_type
*
string
Mandatory
Must be UPI.
payment_method
*
string
Mandatory
Please use the relevant value received from the Payment Method API in the payment_method field.
payment_channel
String
Optional
The platform from which the transaction is initiated. This is used to share the payment channel with Juspay. Accepted values: ANDROID_APP, ANDROID_WEB, IOS_APP, IOS_WEB, DESKTOP.
Note
NPCI has mandated the removal of UPI Collect for most transactions by January 31st, 2026. While iOS and PACB flows are currently exempt, merchants must update their integration to pass the payment_channel in the Transaction API to Juspay. This ensures that valid, exempted transactions are correctly identified and processed.
txn_type
*
string
Mandatory
Must be UPI_COLLECT for Old UPI Collect Request. This field is obsolete for New UPI Collect Request
upi_vpa
*
string
Mandatory
VPA to which the collect request must be sent.
redirect_after_payment
*
boolean
Mandatory
This is a boolean variable and accepts true/false. We recommend that you set this to true and use the redirection flow. If set to true, then the user is redirected to the return\_url configured for the order. If set to false, then the user will be stopped at the response page from the gateway. Your client should be able to read the page/title to infer that the user has completed the transaction.
format
*
string
Mandatory
If it is set to json, then the response will be HTTP 200 with a JSON formatted text. Otherwise, the response is HTTP 302 with the Location attribute having the destination URL.
offers
array of strings
The key offers should be passed only when juspay offers are being used. The value for this key can set as the offerID which is received from /v1/offers/list api
200 : Success
Response Body
order_id
string
:order_id
txn_id
string
:txn_id
status
string
PENDING_VBV
payment
object
authentication.method
String
authentication.url
String
400 : Invalid Input data
Response Body
status
string
error
error_message
string
Order timed out
error_code
string
invalid_request