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

Create Loan Applications Request

This API is called by the LSP to create loan applications in the lender system. The LSP sends all the data about the borrower in this request.

Response Parameters for the Create Loan Applications Request 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 array for Loan Applications, which includes arrays for Collaterals, Guarantors, Applicants, and Offers for each borrower, and also a block for Terms.     (click to open tables)
ParameterTypeDescription
metadata:wwwwwwwwww
 {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) where; YYYY = four-digit year MM = two-digit month (01=January, etc.) DD = two-digit day of month (01 through 31) hh = two digits of hour (00 through 23) (am/pm NOT allowed) mm = two digits of minute (00 through 59) ss = two digits of second (00 through 59) 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
requestIdStringUnique reference ID for the loan applications request
loanApplications:wwwwwi
    [{...},{...},..]
Array of
Objects
Array of LoanApplications
  Parameters for each object in the loanApplications array:
      {click to open)
createdDateStringDate/time (ISO representation) when loan application was created
loanApplicationIdStringUnique reference ID (UUID) for the loan application (used to tie request and response and for idempotency)
typeStringType of application
Example: "CASHFLOW"
borrower:wwwwwwnww
   {params, arrays}
Object
Strings, etc.
IDs, contact details, and documentation of borrower
  Parameters for the borrower object:    (click to open)
primaryIdStringPrimary ID for borrower instance
primaryIdTypeStringType of Primary ID
additionalIdentifiers:ww
    [{...},{...},..]
Array of
Objects
Additional Identifiers:
key
String
  Additional key related to
  the entity.
value
String
  Value for the key in the
  context of the entity.
url
String
  For any new data that needs
  to be passed as a link.
extensibleData
JSON
  For any new data that needs
  to be added.
nameStringName of borrower
categoryStringCategory that loan is used for
Example: "ORGANIZATION"
contactDetails: [{...},{...},..]Array of
Objects
List of contacts (with details) for borrower instance
 Parameters for each object in the contactDetails array:
     {click to open)
typeStringType of contact
Example: "PRIMARY"
descriptionStringDescription of the contact detail
phoneStringPhone number of contact instance
emailStringEmail of contact instance
address:wwwwwwnww
   {param1, param2,...}
Object
Strings
Address details for contact instance
 Parameters for the address object:     {click to open)
FieldTypeDescription
coStringCare of
hbaStringHouse/Building/Apartment number
srlStringStreet/Road/Lane
landmarkStringNotable landmark at address location
alsStringArea/Locality/Sector
vtcStringVillage/Town/City
pincodeString4-digit code to unlock
poStringPost Office box number
districtStringDisdtrict of address location
stateStringState of address location
countryStringCountry of address location
uriStringDigital address
latitudeStringLatitude of address location
longitudeStringLongitude of address location
urlStringFor any new data that needs to be passed as a link
extensibleDatawwwiwwJSONFor any new data that needs to be added.
documents:  [{...},{....}...]
wwwwwwwwwwwwntww
Array of
Objects
List of documents (with details) for borrower instance
  Parameters for each object in the documents array:
     (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifierStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
urlStringFor any new data that needs to be passed as a link
extensibleDatawwwwiwwJSONFor any new data that needs to be added.
collaterals: [{...}, {...}, ...]
wwwwwwwwwwwwwww
Array of
Objects
List of collaterals (with details) for borrower instance
 Parameters for each object in the collaterals array:
     {click to open)
collateralPrimaryIdStringPrimary Identifier for the collateral. Generated as collateralPrimaryIdType_collaetralPrimaryId
collateralPrimaryIdTypeStringExpandable ENUM. Type of collateral source. Will be Invoice in case of invoice based lending, vehicle identification number (VIN) for vehicle as collateral
descriptionStringDescription of the collateral
typeStringType of collateral
Example:"GST_INVOICE"
additionalIdentifiers:
    [{...},{...},..]
Array of
Objects
Additional Identifiers:
key
String
  Additional key related to
  the entity.
value
String
  Value for the key in the
  context of the entity.
url
String
  For any new data that needs
  to be passed as a link.
extensibleData
JSON
  For any new data that needs
  to be added.
valuation:wwwnwwwww
   {param1, param2,...}
Object
Evaluation parameters:
value
String
  Value of collateral
currency
String
  Currency used for evaluation
date
String
  Date of evaluation
source
String
  Source of collateral
parties: [{...},{...},..]Array of
Objects
Parties involved for collateral instance
 Parameters for each object in the parties array:
     {click to open)
primaryIdTypeStringIdentifier Type for the Party
primaryIdStringParty unique identifier for the identifier type above
descriptionStringDescription of the Party
categoryStringCategory of the Party
nameStringName of the Party
relationshipWithBorrowerStringAssociation with collateral. In case of invoice, the 2 parties involved would be the buyer and seller
contactDetails: [{...},{...},..]Array of
Objects
List of contacts (with details) for the party instance. If no data is there to be sent, an empty array block can be passed.
 Parameters for each object in the contactDetails array:
     {click to open)
typeStringType of contact
Example: "PRIMARY"
descriptionStringDescription of the contact detail
phoneStringPhone number of contact instance
emailStringEmail of contact instance
address:wwwwwwnww
   {param1, param2,...}
Object
Strings
Address details for contact instance
 Parameters for the address object:     {click to open)
FieldTypeDescription
coStringCare of
hbaStringHouse/Building/Apartment number
srlStringStreet/Road/Lane
landmarkStringNotable landmark at address location
alsStringArea/Locality/Sector
vtcStringVillage/Town/City
pincodeString4-digit code to unlock
poStringPost Office box number
districtStringDisdtrict of address location
stateStringState of address location
countryStringCountry of address location
uriStringDigital address
latitudeStringLatitude of address location
longitudeStringLongitude of address location
urlStringFor any new data that needs to be passed as a link
extensibleDatawwwwwJSONFor any new data that needs to be added.
additionalIdentifiers:wtw
    [{...},{...},..]
Array of
Objects
Additional Identifiers:
key
String
  Additional key related to
  the entity.
value
String
  Value for the key in the
  context of the entity.
url
String
  For any new data that needs
  to be passed as a link.
extensibleData
JSON
  For any new data that needs
  to be added.
documents:
    [{...},{...},..]
Array of
Objects
Additional documents related to the Party. If no data is there to be sent, an empty array block can be passed.
  Parameters for each object in the documents array:
     (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifierStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwwwnwwJSONFor any new data that needs to be added
documents: [{...},{...},..]
wwwwwwwwwwwwwww
Array of
Objects
List of documents (with details) for collateral instance
  Parameters for each object in the documents array:
     (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifierStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwwwwiwJSONFor any new data that needs to be added
guarantors: [{...}, {...}, ...]
wwwwwwwwwwwwwww
Array of
Objects
List of guarantors (with details) for loan applications instance
 Parameters for each object in the guarantors array:
     {click to open)
primaryIdTypeStringIdentifier Type for the Guarantor
primaryIdStringGuarantor unique identifier for the identifier type above
descriptionStringDescription of the Guarantor and his involvement in the loan
categoryStringCategory of the Guarantor
nameStringName of the Guarantor
relationshipWithBorrowerStringRelationship of the Guarantor with Borrower
contactDetails: [{...},{...},..]Array of
Objects
ContactDetails for the Guarantor. If no data is there to be sent, an empty array block can be passed.
 Parameters for each object in the contactDetails array:
     {click to open)
typeStringType of contact
Example: "PRIMARY"
descriptionStringDescription of the contact detail
phoneStringPhone number of contact instance
emailStringEmail of contact instance
address:wwwwwwnww
   {param1, param2,...}
Object
Strings
Address details for contact instance
 Parameters for the address object:     {click to open)
FieldTypeDescription
coStringCare of
hbaStringHouse/Building/Apartment number
srlStringStreet/Road/Lane
landmarkStringNotable landmark at address location
alsStringArea/Locality/Sector
vtcStringVillage/Town/City
pincodeString4-digit code to unlock
poStringPost Office box number
districtStringDisdtrict of address location
stateStringState of address location
countryStringCountry of address location
uriStringDigital address
latitudeStringLatitude of address location
longitudeStringLongitude of address location
urlStringFor any new data that needs to be passed as a link
extensibleDatawwwwwJSONFor any new data that needs to be added.
additionalIdentifiers:wtw
    [{...},{...},..]
Array of
Objects
Additional Identifiers:
key
String
  Additional key related to
  the entity.
value
String
  Value for the key in the
  context of the entity.
url
String
  For any new data that needs
  to be passed as a link.
extensibleData
JSON
  For any new data that needs
  to be added.
documents:
    [{...},{...},..]
Array of
Objects
Additional documents related to the Guarantor. If no data is there to be sent, an empty array block can be passed.
  Parameters for each object in the documents array:
     (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifierStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwwwiwwJSONFor any new data that needs to be added
applicants: [{...}, {...}, ...]
wwwwwwwwwwwwwww
Array of
Objects
List of applicants (with details) for loan applications instance
 Parameters for each object in the applicants array:
     {click to open)
primaryIdTypeStringIdentifier Type for the Applicant
primaryIdStringApplicant unique identifier for the identifier type above
categoryStringCategory of the Applicant
nameStringName of the Applicant
relationshipWithBorrowerStringRelationship of the applicant with Borrower
contactDetails: [{...},{...},..]Array of
Objects
ContactDetails for the Applicant If no data is there to be sent, an empty array block can be passed.
 Parameters for each object in the contactDetails array:
     {click to open)
typeStringType of contact
Example: "PRIMARY"
descriptionStringDescription of the contact detail
phoneStringPhone number of contact instance
emailStringEmail of contact instance
address:wwwwwwnww
   {param1, param2,...}
Object
Strings
Address details for contact instance
 Parameters for the address object:     {click to open)
FieldTypeDescription
coStringCare of
hbaStringHouse/Building/Apartment number
srlStringStreet/Road/Lane
landmarkStringNotable landmark at address location
alsStringArea/Locality/Sector
vtcStringVillage/Town/City
pincodeString4-digit code to unlock
poStringPost Office box number
districtStringDisdtrict of address location
stateStringState of address location
countryStringCountry of address location
uriStringDigital address
latitudeStringLatitude of address location
longitudeStringLongitude of address location
urlStringFor any new data that needs to be passed as a link
extensibleDatawwwwwJSONFor any new data that needs to be added.
additionalIdentifiers:ww
    [{...},{...},..]
Array of
Objects
Additional Identifiers:
key
String
  Additional key related to
  the entity.
value
String
  Value for the key in the
  context of the entity.
url
String
  For any new data that needs
  to be passed as a link.
extensibleData
JSON
  For any new data that needs
  to be added.
documents:
    [{...},{...},..]
Array of
Objects
Additional documents related to the Applicant. If no data is there to be sent, an empty array block can be passed.
  Parameters for each object in the documents array:
     (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifierStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwwtwwwJSONFor any new data that needs to be added
terms:wwwwwwwwwww
  {param1, param2}
ObjectTerms for loan application instance
 Parameters for the terms object:    {click to open)
requestedAmountStringAmount . 2 digits precision
descriptionStringDescription of the loan terms
currencyObjectISO string of the currency. Use INR for Indian Rupee. Among other accepted values are EUR, USD, GBP. Default value: INR
sanctionedAmountStringLoan Amount Approved by lender
interestTypeStringFlag indicating if the interest rate is fixed or floating
interestRateStringInterest Rate for the loan. 2 digits precision
interestAmountStringInterest Amount for the duration specified in tenure
totalAmountStringTotal amount for repayment
tenure:wwwwwwnww
   {duration, unit}
Object
Strings
Tenure details:
duration
String
  Duration of the loan amount.
unit
String
  Time units (day, month, etc.)
legalAgreement:
    {type, date}
Object
Strings
Loan Agreement:
type
String
  Indicates whether the
  agreement is shared directly
  as text or needs to be
  fetched from a url.
date
String
  Base64 encoded string.
documents:wwwwww
    [{...},{...},..]
Array of
Objects
Additional documents related to the terms. If no data is there to be sent, an empty array block can be passed.
  Parameters for each object in the documents array:
     (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifierStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
charges:wwwwww
    {(...},{...},...}
ObjectPenalties levied for issues with repayments
  Parameters for the charges object:     (click to open)
prepayment:ww
      {....,{...}}
ObjectPrepayment (use Charge Details object parameters below)
bounce:
      {....,{...}}
ObjectBounce (use Charge Details object parameters below)
latePayment:
      {....,{...}}
ObjectDetails of the charges levied when the borrower makes a late payment (use Charge Details object parameters below)
processing:
      {....,{...}}
ObjectProcessing fees charged by the lender (use Charge Details object parameters below)
  Parameters for the chargeDetails object:     (click to open)
chargeTypeStringThis field indicates whether the penalty is fixed or varies
descriptionStringDescription of charge calculation
dataObject
Details of charge:
rate
String
  interest rate
applicableParameter
String
  Parameter for which
  data applies
amount
String
  Loan amount based on
  applicableParameter.
urlStringFor any new data that needs to be passed as a link
extensibleDataStringFor any new data that needs to be added
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwwnwJSONFor any new data that needs to be added
descriptionStringDescription of loan instance, if any
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwwwnwJSONFor any new data that needs to be added
offers: [{...}, {...}, ...]Array of
Objects
List of offers (with details) for loan applications instance
  Parameters for each object in the offers array:
      (click to open)
idStringUnique identifier (UUID) for the offer in the lending system
descriptionStringA short description of the offer.
validTillStringTime till which the offer from the lender is available
terms:wwwwwwwtw
    {...,{...},{...},[...],..}
ObjectDetails about the terms of the loan offer
 Parameters for the terms object:    {click to open)
requestedAmountStringAmount - 2 digits precision
descriptionStringDescription of the loan terms
currencyObjectISO string of the currency. Use INR for Indian Rupee. Among other accepted values are EUR, USD, GBP. Default value: INR
sanctionedAmountStringLoan Amount Approved by lender
interestTypeStringFlag indicating if the interest rate is fixed or floating
interestRateStringInterest Rate for the loan. 2 digits precision
interestAmountStringInterest Amount for the duration specified in tenure
totalAmountStringTotal amount for repayment
tenure:
   {duration, unit}
Object
Strings
Tenure details:
duration
String
  Duration of the loan amount.
unit
String
  Time units
  (DAY, MONTH, etc.)
legalAgreement:
    {type, date}
Object
Strings
Loan Agreement:
type
String
  Indicates whether the
  agreement is shared directly
  as text or needs to be
  fetched from a url.
data
String
  Base64 encoded string.
documents:www
    [{...},{...},..]
Array of
Objects
Additional documents related to the terms. If no data is there to be sent, an empty array block can be passed.
  Parameters for each object in the documents array:
      (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifiernStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
charges:wwwwww
    {(...},{...},...}
ObjectPenalties levied for issues with repayments
  Parameters for the charges object:     (click to open)
prepayment:ww
      {....,{...}}
ObjectPrepayment (use Charge Details object parameters below)
bounce:
      {....,{...}}
ObjectBounce (use Charge Details object parameters below)
latePayment:
      {....,{...}}
ObjectDetails of the charges levied when the borrower makes a late payment (use Charge Details object parameters below)
processing:
      {....,{...}}
ObjectProcessing fees charged by the lender (use Charge Details object parameters below)
  Parameters for the chargeDetails object:     (click to open)
chargeTypeStringThis field indicates whether the penalty is fixed or varies
descriptionStringDescription of charge calculation
dataObject
Details of charge:
rate
String
  interest rate
applicableParameter
String
  Parameter for which
  data applies
amount
String
  Loan amount based on
  applicableParameter.
urlStringFor any new data that needs to be passed as a link
extensibleDataStringFor any new data that needs to be added
urlStringFor any new data that needs to be passed as a link.
extensibleDatawtwJSONFor any new data that needs to be added
disbursement:wwiw
    { [{...},..], [{...},..] }
Object
Arrays
Details about the disbursement provided by lender.
 Parameters for the disbursement object:
     {click to open)
plans: [{...},{...},..]
wwwwwwwwwiww
Array of
Objects
Disbursement plans selected for the loan
  Parameters for each object in the plans array:
     (click to open)
idStringUnique id for the disbursement plan in the lender system
titleStringTitle of the disbursement plan
shortDescriptionStringShort description for the disbursement plan
descriptionStringDetailed description of the disbursement plan
urlStringURL of the payment page provided by the lender to show disbursement plans
automaticBooleanFlag indicating whether disbursement is automatic or user initiated
payNowAllowedBooleanFlag indicates if the lender can make an immediate payment with this disbursement plan
editPlanAllowedBooleanThis flag indicates if the configurations of the current disbursement plan can be changed by the borrower
changeMethodAllowedBooleanThis field indicates if the borrower can choose a different disbursement method for the plan
scheduleTypeStringType of schedule - can be ONE_TIME, AS_PRESENTED or RECURRING
frequencyStringIn case of a recurring payment, this field indicates how often the payment is disbursed
noOfInstallmentsStringNumber of installments for the chosen disbursement plan. Will be 1 for ONE_TIME schedule type
tenure:wwwwwinww
   {duration, unit}
Object
Strings
Tenure associated with the disbursement plan. This value will be less than or equal to the tenure in loan terms.
Tenure details:
duration
String
  Duration of the loan amount.
unit
String
  Time units
  (DAY, MONTH, etc.)
principalStringPrincipal - up to 2 digits precision
interestAmountStringInterest component for the duration specified in plan - up to 2 digits precision
penaltyStringPenalty component for the duration specified in loan - up to 2 digits precision
startDateStringThe first date on which the borrower chooses to make payment/wishes to get the disbursement credited.
statusStringFlag indicating if the plan is ACTIVE or INACTIVE
totalAmountStringTotal amount of loan
accountDetails:wn
    [{...},{...},..]
Array of
Objects
Details on accounts where the amounts will be disbursed by the lender.
  Parameters for each object in the accountDetails array:
     (click to open)
idStringUnique id. Mandatory if object is coming from lender
descriptionStringDescription of the account
statusStringThis field captures the status of whether the account has been linked to a loan or not
accountDataTypeStringThis suggests what kind of data is expected for account details in the data object
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwwwtJSONFor any new data that needs to be added
data:
   {param1, param2,...}
ObjectThis object captures details of the account as suggested by the accountDataType parameter (Parameters are variable).
repayment:wwwwiw
    { [{...},..] }
Object
Array
Details about repayment plans provided by lender.
 Parameters for the repayment object:
      {click to open)
plans:  [{...},{...},..]
wwwwwwwwwiww
Array of
Objects
Repayment plans selected for the loan
  Parameters for each object in the plans array:
     (click to open)
idStringUnique id for the repayment plan in the lender system
titleStringTitle of the repayment plan
shortDescriptionStringShort description for the repayment plan
descriptionStringDetailed description of the payment plan
paymentUrlStringURL of the payment page provided by the lender to show repayment details
automaticBooleanFlag indicating whether payment is automatic or user initiated
payNowAllowedBooleanFlag indicates if the borrower can make an immediate payment with this repayment plan
editPlanAllowedBooleanThis flag indicates if the configurations of the current repayment plan can be changed by the borrower
changeMethodAllowedBooleanThis field indicates if the borrower can choose a different payment method for the plan
scheduleTypeStringType of schedule - can be ONE_TIME, AS_PRESENTED or RECURRING
frequencyStringIn case of a recurring payment, this field indicates how often the payment is disbursed
noOfInstallmentsStringNumber of installments for the chosen repayment plan. Will be 1 for ONE_TIME schedule type
tenure:wwwwwinww
   {duration, unit}
Object
Strings
Tenure associated with the repayment plan. This value will be less than or equal to the tenure in loan terms.
Tenure details:
duration
String
  Duration of the loan amount.
unit
String
  Time units
  (DAY, MONTH, etc.)
principalStringPrincipal - up tp to 2 digits precision
interestAmountStringInterest component for the duration specified in plan - up to 2 digits precision
penaltyStringPenalty component for the duration specified in loan - up to 2 digits precision
startDateStringThe first date on which the borrower chooses to make payment/wishes to get the disbursement credited.
statusStringFlag indicating if the plan is active or inactive
totalAmountStringTotal amount of loan
documents:wwwww
    [{...},{...},..]
Array of
Objects
Any other additional documents provided by the lender as part of the offer. If no data is there to be sent, an empty array block can be passed.
  Parameters for each object in the documents array:
      (click to open)
formatStringFormat of document data to be sent
referenceStringUnique identifier for a document which can be used by other objects for referencing a document. In case where isDataInline is false, reference number can be used to hit an external API to get the data.
sourceStringSource system from where data is coming. Source can be from AA ecosystem or from USER
sourceIdentifierwwStringIf source is in AA ecosystem, sourceIdentifier is the identifier in central registry. In case of User, it will be his unique identifier
typeStringExpandable enum. Includes fiTypes in AA ecosystem and any additional type of documents that can be added to the system later
isDataInlineBooleanIndicates whether the data is actually present in the document block. If Yes, data field contains base 64 encoded version of the data.
dataStringData to be sent for document instance (Base64 encoded string)
urlStringFor any new data that needs to be passed as a link.
extensibleDatawwnwJSONFor any new data that needs to be added
* = Required
Language
Authentication
Basic
base64
:
Click Try It! to start a request and see the response here!