Hey! These docs are for version 3.2, which is no longer officially supported. Click here for the latest version, 1.0!

Consent Handle Response

This API is invoked by the lenders to send the consent handles created in the AA system as part of the Consent Handle Request API triggered by the LSP. This allows bank account statements, GST historical data, etc. to be fetched. Once fetched, the status is sent along with the consent handle.

Response Parameters for the Consent Handle Respnse API:
(click to view)
ParameterTypeDescription
ack:wwwwwwww
  {error, traceId, timestamp}
ObjectJSON object for acknowlegement
    Parameters for the ack object:
ParameterTypeDescription
errorStringErrors in the current request received. If no errors are found, error = 0.
traceIdStringIdentification for tracing
timestampTime-
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 includes an object for Consent, which contains the identifier for consentHandle.     (click to open tables)
ParameterTypeDescription
metadata:wwwwtwwwww
 {param1, param2,...}
Object
Strings
Metadata specific to each API response
  Parameters for the metadata object:     click to open)
FieldTypeDescription
versionStringOCEN Version
timestampTime-
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)
traceIdStringIdentification for tracing
orgIdStringOrigin ID
requestIdwwwwwwwtwwwStringUnique reference ID for the Consent Handle Request (UUID used to tie request and response and for idempotency)
response: {error}ObjectObject contains one parameter, "error:", which indicates if any errors were found in the current request received. If none are found, error = 0.
consent:  {...}ObjectThis includes the consent handle and other details needed for the loan.
  Parameters for the consent object:   (click to open)
consentHandleStringID for the consent handle created by the AA for the lender once the Consent Handle Request API is triggered. When requested, the lender can use the consent handle to check with the AA for fetching bank account statements, GST historical data,etc.
consentStatusStringStatus of the consent
Example: "READY"
* = Required
Language
Authentication
Basic
base64
:
Click Try It! to start a request and see the response here!