QR (Dynamic)

Collect money from customers on your website with Dynamic BHIM UPI QR implementation.


Header Request

Accept : application/json
Content-Type: application/json

Request Parameters

Following are the parameters to be sent in the request body:

ParametersMandatory (M) , Optional (O)Descriptions
tokenMToken is a unique identifier of an application requesting access to your service.
request.purposeMPayment remarks for the transaction
request.amountMAmount to be transferred
request.external_refMYour transaction ID (Agent ID)
request.latitudeMEnd Customer Latitude
request.longitudeMEnd Customer Longitude
request.endpoint_ipMEnd Customer IP Address
request.expiresOexpiry time.Enter timestamp.
request.customer_vpaOVPA of the customer


Configure a Webhook from https://www.instantpay.in/developers/api/webhooks to receive payment notifications.

Sample Request

curl --location --request POST 'https://www.instantpay.in/ws/collections/upidqr/generate' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data-raw '{
    "token": "bf94012f**********65187117853ab4",
    "request": {
        "purpose": "Final Test",
        "amount": "1",
        "external_ref": "1645590072",
        "latitude": "28.6097",
        "longitude": "77.2046",
        "endpoint_ip": "1*.***.***.**4",
        "customer_mobile": "90******07",
        "customer_email": "sh******@gmail.com"
POST /ws/collections/upidqr/generate HTTP/1.1
Host: www.instantpay.in
Content-Type: application/json
Accept: application/json

    "token": "bf94012f**********65187117853ab4",
    "request": {
        "purpose": "Final Test",
        "amount": "1",
        "external_ref": "1645590086",
        "latitude": "28.6097",
        "longitude": "77.2046",
        "endpoint_ip": "1*.***.***.**4",
        "customer_mobile": "90******07",
        "customer_email": "sh*****@gmail.com"

Response Parameters

statuscodeStringInstantPay Status Code
statusStringStatus message
dataArrayResponse Data (If Present)
timestampStringCurrent time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest Reference Number
orderidStringTransaction Id ( If transaction otherwise it is null )

Sample Response

    "statuscode": "TXN",
    "status": "QR Code generated Successfully",
    "data": {
        "amount": "1.00",
        "order_id": "CIU0************82",
        "upi_qr_string": "upi://pay?pa=dqr.189590@icici&pn=SHWETA STORE&tr=DQRCIU012205409503382&tn=Final Test&am=1&cu=INR&mc=5411"
    "timestamp": "2022-02-23 09:50:33",
    "ipay_uuid": "A1E4A04125E5FFDBEE47",
    "orderid": "CIU0***********82",
    "environment": "PRODUCTION"


Note :

1 - Latitude and Longitude must be represented in degrees with 4 digits after decimal.
2- externalRef must be unique and in alpha numeric characters.
3- Remarks should be in alphabet and it can be of maximum 20 characters.
4- Purpose are Case Sensitive.

Click Try It! to start a request and see the response here!