post https://api.juspay.in/v3/loan/verifyLoanAcceptanceResponse
This API is invoked by the Lender when the OTP entered by the user is shared through the LSP. This API acknowledges the receipt of OTP and verifies if the user has entered the correct OTP that was shared by the lender on the mobile number associated with the disbursement account.
Response Parameters for the Verify Loan Acceptance Response API: (click to view)
| Parameter | Type | Description |
|---|---|---|
| ack:wwwwwwww {error, traceId, timestamp} | Object | JSON object for acknowlegement |
Parameters for the
ack object: | Parameter | Type | Description |
|---|---|---|
| error | String | Errors in the current request received. If no errors are found, error = 0. |
| traceId | String | Identification for tracing |
| timestamp | Time- stamp | YYYY-MM-DDThh:mm:ssZ+/-hh:mm (eg 1997-07-16T19:20:30+05:30) Z +/- hh:mm = time zone designator (Z) followed by time zone difference from GMT in hours and minutes. THIS IS OPTIONAL. If not provided, it is assumed to be IST (+5.30) |
The request for this API contains an array of objects, Credit Block. Each object contains a parameter, type, and a Data object, which contains otpSessionKey and status. (click to open tables)
| Parameter | Type | Description | |
|---|---|---|---|
| metadata:wwwwwwtnww {param1, param2,...} | * | Object Strings | Metadata specific to each API request |
Parameters for the metadata object: click to open)
| Field | Type | Description | |
|---|---|---|---|
| version | String | OCEN Version | |
| timestamp | Time- stamp | YYYY-MM-DDThh:mm:ssZ+/-hh:mm (eg 1997-07-16T19:20:30+05:30) Z +/- hh:mm = time zone designator (Z) followed by time zone difference from GMT in hours and minutes. THIS IS OPTIONAL. If not provided, it is assumed to be IST (+5.30) | |
| traceId | String | Identification for tracing | |
| orgId | String | Origin ID |
| requestId wwwwwwwnwwwwwww | * | String | Unique reference ID for the Verify Loan Acceptance Request (UUID used to tie request and response and for idempotency) |
| credBlock: [{...}, {...}, ...] | * | Array of Objects | Credentials block which contains details for verifying loan acceptance |
Parameters for each object in the creditBlock array:
(click to open)
| typewwwwwwwwnwww | * | String | Type of credential used for verifying loan acceptance. Example: "OTP" |
| data:wwwwwwnnw {param1, param2,...} | * | Object Strings | Credential InformationotpSessionKey, status, etc. |
Parameters for the data object: (click to open)
| otpSessionKeywwwnw | * | String | If type = "OTP", this is the key used for the verification acknowledgment session |
| status | * | String | If type = "OTP", this indicates if verification was successful by checking for correct OTP usage. If correct, status = "SUCCESS" |
| {{Field}} | String | {{value}} | |
| {{Field}} | String | {{value}} Other parameters as needed |
* = Required