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

Set Repayment Plan Status Response / Webhook

This API is used by lenders to inform LSP about the status of a previously initiated set Repayment. The API returns the status of the repayment plan that the borrower has chosen. In case the borrower has chosen e-mandate as the repayment method in payment page URL, the status of the repayment plan becomes ACTIVE only after successful authorization of the e-mandate on the PSP by the borrower.

Response Parameters for the Set Repayment Plan Status Response API: w w (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 contains the parameter:  requestId  (UUID for the previous API request), and an object for  plan, which contains updated status parameters for the repayment plan.       (click to open tables)
ParameterTypeDescription
metadata:wwtwwwww
   {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
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.
requestIdwwwwwtwww*StringUnique reference ID for the Set Repayment Plan Status Request (UUID used to tie request and response and for idempotency)
loanId*StringUnique reference ID (UUID) of loan whose repayment plan status has been requested by the LSP (UUID generated by lender)
plan:  {...,{...},...}*ObjectUpdated details from the lender for the repayment plan that the borrower has chosen for the loan.
  Parameters for the plan object:
      (click to open)
id*StringUnique reference ID (UUID) of the repayment plan whose status update has been requested (UUID generated by lender)
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
* = Required
Language
Click Try It! to start a request and see the response here!