Overview

This API generates a QR string which can be encoded into a QR code to add funds to your virtual account by passing account_number and payment_details entity.

Problem

• The requirement to easily add funds to a virtual bank account.

Solution

• API to generate the QR String, which can be encoded into the desired QR code that users can scan to add funds to their Virtual Bank Account.

Sequence Diagram

Endpoint

Request

Follow the below guidelines to pass the account number in the path parameter, and the payment details entity as the body, with the option of passing static in the query parameter.

Path Parameter

Query Parameter

Body

The payment details entity is passed into the body.

Sample CURL Request

curl --request POST \
     --url 'https://api.sandbox.co.in/tax-payment/accounts/xxxxxxxxxxxxxxx/upi/qr?static=false' \
     --header 'Accept: application/json' \
     --header 'Authorization: xxxxxxxxxxxxxxx' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --data '
{
  "@entity": "payment",
  "payment_details": {
    "@entity": "payment_details",
    "description": "Payment Request For Order: 12345678 ",
    "notes": {},
  },
  "amount": 100
}
'

📘

Different Types of UPI QR strings.

1. Static - A static QR string can be used to collect multiple payments on a single QR string.

   • These QRs are similar to what are being used by local shops and vendors to collect payments from a retail customer.

2. Dynamic - A dynamic QR string can be used to collect exactly one payment on a single QR string.

   • For each transaction, a customer has to create a new QR code, and each QR code will have a unique
     transaction Id associated with it, which can be used to reconcile transaction postback on successful
     payment.
   • These QRs are similar to what is being used in payment gateways.

❗️

Test Environment Not Available

Response

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Generate QR String API is a Paid API, a wallet charge will take place.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here