Skip to main content

Loans loanid repayments overview

Re-dates a loan account's repayment schedule in a single call, avoiding a full schedule-edit payload.

The repayment identified by fromRepaymentEncodedKey is moved to targetDueDate, and that day-of-month is then cascaded to every later repayment, advancing one month at a time. Repayments earlier than the target are left unchanged.

Date handling:

  • Month-end: if targetDueDate is the last day of its month, every following repayment is placed on the last day of its month (e.g. the 31st becomes the 30th or 28th/29th as appropriate).
  • Short months: a day that does not exist in a given month is clamped to that month's last day (e.g. day 31 becomes 28 in February of a non-leap year).
  • Non-working days: any non-working-day adjustment configured on the product/account is applied by the schedule engine after the dates are computed (e.g. a date falling on a weekend may roll to the next working day).

The change runs through the standard schedule-edit validation. On success the endpoint returns 200 with no body; retrieve GET /loans/{loanId}/schedule to see the updated due dates. Supported for dynamic mortgage and interest-only mortgage products.