Body
Lite Registration
This API will be used to create LRN(Lite Reference Number) for UPI Lite. XML provided should be passed to CL as it is.
Request
Response
API Endpoints
Production Link
POST
http://{{host}}/api/{uri}/merchants/npci/lite/account
Headers
content-type
*
String
Required
application/json
accept
*
String
Required
application/json
x-merchant-id
*
String
Required
Will be shared while onboarding.
x-merchant-channel-id
*
String
Required
Will be shared while onboarding.
x-timestamp
*
String
Required
This is an epoch unix timestamp string. For example, 1496918882000. It can be used by us to invalidate older requests.
x-merchant-signature
*
String
Required
This is a signature over combination of headers, payload. Refer Signature Calculation section for more details.
Request Schema: application/json
Request parameters
merchantCustomerId
*
String
Mandatory
Merchant generated unique profile id for customer as passed in the request
Values: String
upiRequestId
*
String
Mandatory
Unique id sent to UPI switch for the request
Values:35 character alphanumeric. Should always start with merchant prefix provided.
bankAccountUniqueId
*
String
Mandatory
Unique id for the bank account to be linked
Values:bankAccountUniqueId in the response of Fetch Accounts api call.
credBlock
*
string
Mandatory
Encrypted identity credblock
Values:As return by Common Library
ifsc
*
String
Mandatory
Ifsc for the bank account as returned by NPCI
clVersion
String
Optional
Common Library Version of the UPI application clVersion
Constraints: Common Library Version of the UPI application (Mandatory for BioAuth payments)
200 : Success
Response Body
status
*
String
Mandatory
PSP status of the API
Values:SUCCESS, FAILURE
responseMessage
*
String
Mandatory
PSP response message for the API
Values:Refer error code section
responseCode
*
String
Mandatory
PSP response code for the API
ValuesRefer error code section
Payload
json
rotation
*
String
Mandatory
merchants needs to call this api every "rotation" days, to rotate DEVICE-CERT and STATE
lrn
*
String
Mandatory
Lite Reference Number which is reference the number provided for the wallet linked with account number
respListKeys
*
String
Mandatory
xml which we will get after doing ReqListKeys (GetLite). This will give the lrn of the user
gatewayResponseStatus
*
String
Mandatory
Response status for Lite Registration
Values:SUCCESS, FAILURE
gatewayResponseCode
*
String
Mandatory
Response code for Lite Registration
gatewayResponseMessage
*
String
Mandatory
Response message for Lite Registration