Grant Loan Response

This method is called be the Lender when the Grant Loan processing is completed. This informs the borrower about the status of the loan in the lender system. Upon successful creation of a loan in the system, the lender returns all the details of the loan.

Request Body
metadata object — REQUIRED Metadata specific to each API request. version string — REQUIRED originatorOrgId string The organisation id on the Participant Registry. originatorParticipantId string The participant id on the Participant Registry. This will be different for every role under the same organisation. timestamp string — REQUIRED traceId string — REQUIRED requestId string — REQUIRED UUID used to tie request and response and for idempotency
productData object — REQUIRED Product Metadata specific to each API request. productId string — REQUIRED The product id on the Product Registry. productNetworkId string The product network id on the Product Registry.
response object — REQUIRED Status of response. Whether success or has encountered error status string — REQUIRED Possible values: [SUCCESS, ERROR] responseDetail string
loanDetails object — REQUIRED loanId string loanApplicationId string loanApplicationStatus string Possible values: [CREATED, PROCESSING, CONSENT_INITIATED, CONSENT_RECEIVED, CONSENT_REJECTED, OFFERED, OFFER_ACCEPTED, KYC_INITIATED, KYC_COMPLETED, KYC_FAILED, KYC_REJECTED, LOAN_AGREEMENT_INITIATED, LOAN_AGREEMENT_COMPLETED, LOAN_AGREEMENT_FAILED, REPAYMENT_SETUP_INITIATED, REPAYMENT_SETUP_COMPLETED, REPAYMENT_SETUP_FAILED, REPAYMENT_SETUP_REJECTED, SET_DISBURSEMENT_ACCOUNT_INITIATED, SET_DISBURSEMENT_ACCOUNT_COMPLETED, SET_DISBURSEMENT_ACCOUNT_FAILED, SET_DISBURSEMENT_ACCOUNT_REJECTED, GRANTED, REJECTED, ACTION_REQUIRED, DISBURSEMENT_INITIATED, DISBURSEMENT_COMPLETED, DISBURSED_FAILED, CLOSED, CANCELLED] createdDate string startDate string endDate string borrower object primaryId string — REQUIRED primaryIdType string — REQUIRED Possible values: [PAN, MOBILE, AADHAAR] additionalIdentifiers object[] key string — REQUIRED value string — REQUIRED url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. name string category string — REQUIRED Possible values: [ORGANIZATION, INDIVIDUAL] contactDetails object[] — REQUIRED type string — REQUIRED Possible values: [PRIMARY, OTHER] desctiption string phone string — REQUIRED email string address object hba string — REQUIRED srl string — REQUIRED landmark string als string vtc string pinCode string — REQUIRED po string district string state string — REQUIRED country string — REQUIRED url string latitude string longitude string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. documents object[] id string source string — REQUIRED Possible values: [GSTN, AA, FIP, FSR, FIU, USER, OTHER] sourceIdentifier string — REQUIRED format string — REQUIRED Possible values: [JSON, DOC, IMAGE, CSV, XML, PDF, URL] reference string — REQUIRED type string — REQUIRED Possible values: [GST_PROFILE, GSTN_B2B_INVOICE, PAN, AADHAAR, DRIVING_LICENSE, PASSPORT, OTHER] isDataInline boolean — REQUIRED data string — REQUIRED url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. aaIdentifier string For AA based flows, account aggregator identifier will be provided by the borrower documents object[] id string source string — REQUIRED Possible values: [GSTN, AA, FIP, FSR, FIU, USER, OTHER] sourceIdentifier string — REQUIRED format string — REQUIRED Possible values: [JSON, DOC, IMAGE, CSV, XML, PDF, URL] reference string — REQUIRED type string — REQUIRED Possible values: [GST_PROFILE, GSTN_B2B_INVOICE, PAN, AADHAAR, DRIVING_LICENSE, PASSPORT, OTHER] isDataInline boolean — REQUIRED data string — REQUIRED guarantors object[] primaryId string — REQUIRED primaryIdType string — REQUIRED Possible values: [PAN, MOBILE, AADHAAR] description string additionalIdentifiers object[] key string — REQUIRED value string — REQUIRED url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. name string relationshipWithBorrower string category string — REQUIRED Possible values: [ORGANIZATION, INDIVIDUAL] contactDetails object[] — REQUIRED type string — REQUIRED Possible values: [PRIMARY, OTHER] desctiption string phone string — REQUIRED email string address object hba string — REQUIRED srl string — REQUIRED landmark string als string vtc string pinCode string — REQUIRED po string district string state string — REQUIRED country string — REQUIRED url string latitude string longitude string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. documents object[] — REQUIRED id string source string — REQUIRED Possible values: [GSTN, AA, FIP, FSR, FIU, USER, OTHER] sourceIdentifier string — REQUIRED format string — REQUIRED Possible values: [JSON, DOC, IMAGE, CSV, XML, PDF, URL] reference string — REQUIRED type string — REQUIRED Possible values: [GST_PROFILE, GSTN_B2B_INVOICE, PAN, AADHAAR, DRIVING_LICENSE, PASSPORT, OTHER] isDataInline boolean — REQUIRED data string — REQUIRED url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. applications object[] primaryId string — REQUIRED primaryIdType string — REQUIRED Possible values: [PAN, MOBILE, AADHAAR] additionalIdentifiers object[] key string — REQUIRED value string — REQUIRED url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. name string category string Possible values: [ORGANIZATION, INDIVIDUAL] relationshipWithBorrower string contactDetails object[] type string — REQUIRED Possible values: [PRIMARY, OTHER] desctiption string phone string — REQUIRED email string address object hba string — REQUIRED srl string — REQUIRED landmark string als string vtc string pinCode string — REQUIRED po string district string state string — REQUIRED country string — REQUIRED url string latitude string longitude string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. documents object[] id string source string — REQUIRED Possible values: [GSTN, AA, FIP, FSR, FIU, USER, OTHER] sourceIdentifier string — REQUIRED format string — REQUIRED Possible values: [JSON, DOC, IMAGE, CSV, XML, PDF, URL] reference string — REQUIRED type string — REQUIRED Possible values: [GST_PROFILE, GSTN_B2B_INVOICE, PAN, AADHAAR, DRIVING_LICENSE, PASSPORT, OTHER] isDataInline boolean — REQUIRED data string — REQUIRED url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. offer object id string — REQUIRED isMappedtoDocument boolean documentId string validTill date — REQUIRED terms object — REQUIRED requestedAmount float — REQUIRED currency string — REQUIRED sanctionedAmount float netDisbursedAmount float interestType string Possible values: [FIXED, FLOATING] interestRate float annualPercentageRate float coolingOffPeriod object duration number — REQUIRED unit string — REQUIRED Possible values: [MONTH, DAY, YEAR] totalRepayableAmount float interestAmount float description string tenure object duration number — REQUIRED unit string — REQUIRED Possible values: [MONTH, DAY, YEAR] legalAgreement object type string — REQUIRED Possible values: [TEXT, DOCUMENT_URL, REDIRECT_TO_LENDER_URL] data string — REQUIRED documents object[] id string source string — REQUIRED Possible values: [GSTN, AA, FIP, FSR, FIU, USER, OTHER] sourceIdentifier string — REQUIRED format string — REQUIRED Possible values: [JSON, DOC, IMAGE, CSV, XML, PDF, URL] reference string — REQUIRED type string — REQUIRED Possible values: [GST_PROFILE, GSTN_B2B_INVOICE, PAN, AADHAAR, DRIVING_LICENSE, PASSPORT, OTHER] isDataInline boolean — REQUIRED data string — REQUIRED charges object prepayment object chargeType string — REQUIRED Possible values: [FIXED_AMOUNT, RATE_BASED] data object — REQUIRED rate float amount float applicableParameter string Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL] description string url string url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. bounce object chargeType string — REQUIRED Possible values: [FIXED_AMOUNT, RATE_BASED] data object — REQUIRED rate float amount float applicableParameter string Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL] description string url string url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. latePayment object chargeType string — REQUIRED Possible values: [FIXED_AMOUNT, RATE_BASED] data object — REQUIRED rate float amount float applicableParameter string Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL] description string url string url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. processing object chargeType string — REQUIRED Possible values: [FIXED_AMOUNT, RATE_BASED] data object — REQUIRED rate float amount float applicableParameter string Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL] description string url string url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. other object chargeType string — REQUIRED Possible values: [FIXED_AMOUNT, RATE_BASED] data object — REQUIRED rate float amount float applicableParameter string Possible values: [TOTAL_LOAN_AMOUNT, OUTSTANDING_PAYABLE_AMOUNT, EMI, REPAYMENT_PRINCIPAL] description string url string url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. disbursement object — REQUIRED plans object[] — REQUIRED id string — REQUIRED title string shortDescription string description string paymentUrl string payNowAllowed boolean editPlanAllowed boolean changeMethodAllowed boolean automatic boolean — REQUIRED scheduleType string — REQUIRED Possible values: [RECURRING, ONE_TIME, AS_PRESENTED] noOfInstallment number frequency string Possible values: [MONTHLY, WEEKLY, QUARTERLY, HALF_YEARLY, YEARLY] tenure object duration number — REQUIRED unit string — REQUIRED Possible values: [MONTH, DAY, YEAR] totalAmount float — REQUIRED principal float interestAmount float penalty float startDate date status string Possible values: [ACTIVE, INACTIVE, PENDING_AUTH] url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. accountDetails object[] id string description string status string Possible values: [ACTIVE, INACTIVE] accountDataType string — REQUIRED Possible values: [ACCOUNT, VPA] data object — REQUIRED accountType string Possible values: [CURRENT, SAVING, OVERDRAFT, ESCROW, WALLET] accountIFSC string accountNumber string vpa string maskedAccountNumber string accountHolderName string url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. repayment object — REQUIRED plans object[] — REQUIRED id string — REQUIRED title string shortDescription string description string paymentUrl string payNowAllowed boolean editPlanAllowed boolean changeMethodAllowed boolean automatic boolean — REQUIRED scheduleType string — REQUIRED Possible values: [RECURRING, ONE_TIME, AS_PRESENTED] noOfInstallment number frequency string Possible values: [MONTHLY, WEEKLY, QUARTERLY, HALF_YEARLY, YEARLY] tenure object duration number — REQUIRED unit string — REQUIRED Possible values: [MONTH, DAY, YEAR] totalAmount float — REQUIRED principal float interestAmount float penalty float startDate date status string Possible values: [ACTIVE, INACTIVE, PENDING_AUTH] url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements. description string documents object[] id string source string — REQUIRED Possible values: [GSTN, AA, FIP, FSR, FIU, USER, OTHER] sourceIdentifier string — REQUIRED format string — REQUIRED Possible values: [JSON, DOC, IMAGE, CSV, XML, PDF, URL] reference string — REQUIRED type string — REQUIRED Possible values: [GST_PROFILE, GSTN_B2B_INVOICE, PAN, AADHAAR, DRIVING_LICENSE, PASSPORT, OTHER] isDataInline boolean — REQUIRED data string — REQUIRED url string extensibleData object This API schema is for additional keys & values according to specific need. User can add JSON objects as per the requirements.

Responses
200 Acknowledgement of Request Received Schema — OPTIONAL error string traceId string timestamp string