Dynamic QR Generation API:

---

Request Method :: POST

Description: This API is used to generate a real-time, transaction-specific QR code for accepting payments from customers.

Headers

---

Content-Type: application/JSON

header_secrets:  To be generated by following the above logic

pass_key:  To be shared during integration by ISU Team

Request Body Parameters

Parameters	Description	Min Length	Max Length	Data type	Default Value	Mandatory/Optional
payeeVPA	Payee's VPA of Merchant for Payment Collection (e.g- upicashpoint.uat@nsdl )	1	100	String		Mandatory
paymentMode	Payment Mode for the Transaction	1	10	String	CASHPOINT	Mandatory
txnAmount	Transaction amount for which transaction is initiated Min: ₹100 Max: ₹5000 and must e in multiple of ₹100.	1	10	String		Mandatory
channelId	Channel Identifier Web: “WEBUSER” Android: “Android”	1	10	String		Mandatory
txnNote	Transaction Note(No Special Character Allowed, Space in Start and end also not allowed)	1	50	String		Mandatory
clientRefId	Unique client reference needs to be generated by partner/Merchant for each transaction	10	19	String		Mandatory
merchantType	Type of Merchant Default Value: BC	1	10	String	BC	Mandatory
expiryTime	Time in Minutes Min Time: 1 Max Time: 30	1	2	String		Mandatory
mobilenumber	Mobile Number of Customer	10	10	String		Mandatory
tid	Terminal Id of Device (Only Alphanumric allowed no special character, i.e Device Serial No)	1	20	String		Mandatory
paramA	Additional Parameter	0	255	String		Optional
paramB	Additional Parameter	0	255	String		Optional
paramC	Additional Parameter	0	255	String		Optional

Sample Request Body

---

{ "payeeVPA": "upicashpoint.uat@nsdl", "paymentMode": "CASHPOINT", "txnAmount": "100", "channelId": "ANDROID", "txnNote": "SchedulerTest", "clientRefId": "AVJ7808764576093492", "merchantType": "BC", "expiryTime": "1", "mobilenumber": "8303344556", "tid":"FT76786578", "paramA": "", "paramB": "", "paramB": "" }

Encrypted Sample Request Body

---

{ "RequestData": "Y7qaCBXopOKA36QzARHcWLDKTNWWqc00Tonup2MC+ObFZ+AeVd5/EfQIdjr81KYg6F3mio0dijqBRGH+zuaGNfKktZMS7v0YZEtDC/h5QlxxvrhQavM23Okr74DtiMxXeMaS1uiIKyjNT1MnKHH0u7KKSp0EHUzX2MLscfZzs3RbCPdpJF6NRHitLH9H7AeJYjZrMok2qxPeHs5RsETKQabV315d0Vtdzc0y4o+Yk+07M9N3Ik9f702AAD1DaEMmEzrJCtmcACm7zk/FeJQOAV+HWXzn901rb6RA28lyTTRHt2BCCbFiobqxshJ+9vjyRdlXQh7nPO85Rd+gb0qQK9Cq/wd3jegBkhx7qQJ14cTmo/XnV1HKujSG2G9g0xf/GCQetWT8ihfYWkHCKdjqAQ==" }

Response Body Parameters

Parameters	Description	Min Length	Max Length	Data type
amount	Transaction amount for which the transaction is initiated	1	10	Integer
clientRefId	Unique client reference ID needs to be generated by partner/Merchant for each new transaction	10	19	String
intentData	UPI Intent URL (NA for Cashpoint))	NA	Na	string
payeeVPA	Payee's VPA of Merchant for Payment Collection	1	100	String
payerVPA	Payer’s UPI ID	1	100	String
paymentState	State of the Payment	1	10	String
qrData	Base64 Encoded QR Data, which needs to be converted into a QR to collect payment	NA	Na	String
status	Status of Transaction Initiation	1	10	String
statusCode	Status Code	1	3	String
statusDesc	Status Description	1	50	String
txnId	Generated Transaction ID	18	58	string

Sample Response Body

---

SUCCESS:

{ "amount": "100", "clientRefId": "AVJ7808764576093492", "qrData": "iVBORw0KGgoAAAANSUhEUgAAADkAAAA5AQAAAACkY74oAAABtElEQVR4XmP4DwENDHgYH8SeMbqUsDcwfL8jLPaF9XsDw5eYh/cuLBUHMiKuHCnRBTFipjO27QUyvt++Efs+Fqjmg2hoaGgIUNf/r0yyXPVAcz7F2TrK8AKlvv02djl59H0Dw99GVa03+kA1f6ou35y0LLyB4TdXwVOmGPUGhn8rpQXbPPUbGH65bb3qb3YdaMXnCbf2bDnewPDz4IWLR4X9Gxh+LBO/1aloD7TCiUPwv1860ORfdzIie4Amf7i7pLhGezvQnD9coQ2M8UDFDEcbl38ob2D4Wuwzd8Jzd6BUmORUwVSgrt+Fv2LPh/M3MHxkdjlg1QBU823vx+KDi0GOP2i56nAS0Pbf5uVXIjbOB7==", "payeeVPA": "63705423781902@nsdl", "payerVPA": null, "paymentState": "INITIATED", "intentData": "", "status": "SUCCESS", "statusCode": "0", "statusDesc": "Cashpoint transaction initiated successfully", "txnId": "544861572153540004" }

 

SUCCESS(Encrypted):

---

{ "ResponseData": "O62gv3DYEibQXG3qw4YHYxt6L4JKPH9oXjX+JwC4pux1vxESU7RargvU0BXCGSHBIiCAYZGuV9VEdC+ljKqeGjnjSWzRvDuymNN76XAg4rEc+51z7Q7AlkKr8s5+paWdRYa1RyTuzxTt0J3IXAKXbukTZi6GobEiTHWT24WhlQatJ1tx3fPtsLtQrSsxgt0+3hFjs+j9nCJso4hi3TeN1DI+Qy49TdGH+bwY+TOuSgAWc+uJlKDgi6Bh/ZGFc9PQ7Mk4dBPilrvxvMpaG6WZ2VgA6B0MF8Y4oVd8ZPLOx3NMm6t0usvdw1LHoDtKnqbThAyAAVdZxRv7UCB2rsj1ryRez1OmWnK56dDXT8CuKKxxwy7RRWinCv+j2q3RQ+MN3L5ZGhiXe4JCN5CH/+87rx/tKm1Syzf46DRiciY36zUNXMjaKJO2kd8Hx639U7tE77/jBm93nG73FtZHhjQcA1seyx+M1+2IKKBQmNR4SnpGnd9Fp8IyNLntidIqup5LghwDCeYgdlfVfAY58ls0RL06fwYhAkQ58SYZr1omoyR7Imv3AQBK8efh3JPouyTsTF9gwQSxgZWcSVUwWrevFJtsTCOdnVyh+Ml2HKiZjqYa8UZjg2FkWSYh40b2cLYaYN4BnK4IKx53KbMbzKsEFoRPXohbb9ogOMY5Nu8TQ0Q2Ao36paNl6PKBBHjqzbjs/pqqlZGcqFuYJLlCO3IjKiocJacajz6WTvvOfzVnzQZnhxVyqwPXSjPpRrh2GDCxnkiEozPHb5OaOBgYdfGttYSgNlfI4Fui6tLsfBNepUtMn1d7dHDLmCkj5icZQN0URb+YVC4aMqs7n9OZFol8ksDS3bKBHPJFn3hWvpsWyk5Xvv0pDJLi/DKYLbZXNscWjcvNKi/JQPKycP3F818NVy/tbTs3vMxYJryANcpT6Sek5iIcA4ciZdQ4UvTdMLNP"}

FAILED:

Amount is blank or Invalid Amount, entered :

{ "statusCode": -1, "status": "FAILED", "txnId": null, "statusDesc": "Invalid Amount, Please try again" }

Client Reference id must not be blank :

{ "statusCode": -1, "status": "FAILED", "txnId": null, "statusDesc": "Client Reference id must not be blank" }

Merchant not onboarded with MCC 6013:

{ "statusCode": -1, "status": "FAILED", "txnId": null, "statusDesc": "Merchant not allowed for Cashpoint transaction - Invalid MCC" }

Status Codes

Status	Status Code	Description
INITIATED	0	Qr generated successfully
FAILED	-1	QR generation failed due to invalid request