Validate QR
This function is used to validate the UPI International QR before proceeding for payment. There can be two types of QR codes Dynamic QR and Static QR codes. For Dynamic QR code the conversion amount is already handeled in the validate QR process, while for Static QR the conversion of amount is to be handeled by merchants by using Fx Conversion process.
For Dynamic QR and Static QR - For both Dynamic and Static QR's the first step will include the Validate QR process.
Unique uuid-v4 string
Example: abcd-12345-abcd-12345
Value: in.juspay.hyperapi
Parameters required to call Hyper SDK API
Operation to be performed in the SDK.
Example:- upiInternationalValidateQr
Unique merchant id shared during onboarding
Key ID to identify the public-private key pair used for signature generation
The complete URL of the QR to be verified
Signature generated for the signaturePayload
Example:-
Signature payload is a stringified JSON of the details mentioned in the below table.
Unique identifier associated with an account created by juspay.Ex: stock
Any unique reference associated with your customer.
Time when request is created in milliseconds.
Unique uuid-v4 string
Example: abcd-12345-abcd-12345
Value: in.juspay.hyperapi
Response Parameters
Operation to be performed in the SDK.
Example:- upiInternationalValidateQr
Unique Id for each transaction
Example: YBL99e9db4c88e84fb7834dff54cab92d09
Merchant type who will recieve the money
Example: SMALL, LARGE
Name of the payee.
Example: ABCD
Merchant Category Code of the payee merchant.
Example: 5678
VPA of the Payee involved in the transaction
Example: abc@xyz
SUCCESS/FAILURE
Response Code received from NPCI
Response Message received from NPCI
Details required for the fx conversion.
Markup Rate to be used.
Foreign exchange rate for the currency.
Amount in base currency (present only in case of dynamic QR).
Base currency of amount.
Converted amount based on the currency (present only in case of dynamic QR).
Active status for forex as recieved from NPCI - Y/N
The PSP response code for the operation
The PSP response message for the operation
Possible values :- true/false
Error Message
Error Code
Value: process_result
For static QR only Fx Conversion - Merchants have to handle the amount conversion using the Fx conversion process based on the mark up and Fx rate received in the validate QR response. The Fx process is given below
Unique uuid-v4 string
Example: abcd-12345-abcd-12345
Value: in.juspay.hyperapi
Parameters required to call Hyper SDK API
Operation to be performed in the SDK.
Example:- UpiInternationalFxConversion
Amount in base Currency
Example: 36.00
The code for base currency for conversion.
Foreign exchange rate.
Example: 1.00
The markup rate to be used for conversion.
Example: 1.00
Unique uuid-v4 string
Example: abcd-12345-abcd-12345
Value: in.juspay.hyperapi
Response Parameters
Operation to be performed in the SDK.
Example:- UpiInternationalFxConversion
The converted amount according to the parameters passed.
Example: 26.03
The PSP response code for the operation.
Example: SUCCESS
The PSP response message for the operation.
Example: SUCCESS
Possible values :- true/false
Error Message
Error Code
Value: process_result
After the conversion of money is completed UPI Send Money can be called with pay type as SCAN_PAY.