JavaScript is disabled. Some features may not work. You can also read the static version: View text version

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.

Process Parameters

Request

Response

                      requestId
                      *
                      

String

Mandatory

Unique uuid-v4 string

Example: abcd-12345-abcd-12345

                      service
                      *
                      

String

Mandatory

Value: in.juspay.hyperapi

                      payload
                      *
                      

JSON

Mandatory

Parameters required to call Hyper SDK API

                      action
                      *
                      

String

Mandatory

Operation to be performed in the SDK.

Example:- upiInternationalValidateQr

                      upiRequestId
                      *
                      

String

Mandatory

Unique merchant id shared during onboarding

                      merchantKeyId
                      *
                      

String

Mandatory

Key ID to identify the public-private key pair used for signature generation

                      qrPayload
                      *
                      

String

Mandatory

The complete URL of the QR to be verified

                      signature
                      *
                      

String

Mandatory

Signature generated for the signaturePayload

Example:-

                      signaturePayload
                      *
                      

String

Mandatory

Signature payload is a stringified JSON of the details mentioned in the below table.

                      merchant_id
                      *
                      

String

Mandatory

Unique identifier associated with an account created by juspay.Ex: stock

                      customer_id
                      *
                      

String

Mandatory

Any unique reference associated with your customer.

                      timestamp
                      *
                      

String

Mandatory

Time when request is created in milliseconds.

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

Process Parameters

Request

Response

                      requestId
                      *
                      

String

Mandatory

Unique uuid-v4 string

Example: abcd-12345-abcd-12345

                      service
                      *
                      

String

Mandatory

Value: in.juspay.hyperapi

                      payload
                      *
                      

JSON

Mandatory

Parameters required to call Hyper SDK API

                      action
                      *
                      

String

Mandatory

Operation to be performed in the SDK.

Example:- UpiInternationalFxConversion

                      baseAmount
                      *
                      

String

Mandatory

Amount in base Currency

Example: 36.00

                      baseCurrency
                      *
                      

String

Mandatory

The code for base currency for conversion.

                      fxRate
                      *
                      

String

Mandatory

Foreign exchange rate.

Example: 1.00

                      markupPercentage
                      *
                      

String

Mandatory

The markup rate to be used for conversion.

Example: 1.00

After the conversion of money is completed UPI Send Money can be called with pay type as SCAN_PAY.