Loan Adjustments

How lenders can reduce the outstanding interest, late fee, or daily penalty on an active loan using the PayMongo Capital API.

Lenders can reduce what a loan still owes on selected components using POST /v1/capitals/lenders/loans/{loan_id}/adjustments. Use this to waive a late fee for a first-time overdue merchant, discount interest for early repayment, or forgive an accumulated daily penalty.

An adjustment only lowers the outstanding balance — it never refunds money already collected.

Adjustable components

ComponentField reducedNotes
interestoutstanding_interest_amountFor revolving loans, the loan first accrues interest up to the current moment, so the adjustable amount may be slightly higher than the last retrieved value.
late_feeoutstanding_late_fee_amountOnly the outstanding portion can be reduced; late_fee_amount (total ever charged) stays on the record.
daily_penaltyoutstanding_daily_penalty_amountReducing the outstanding penalty to zero does not stop the penalty from accruing — it continues to accrue each subsequent day the loan stays overdue.

Principal and DST cannot be adjusted.

Request

POST /v1/capitals/lenders/loans/{loan_id}/adjustments

Path parameter

ParameterTypeDescription
loan_idstringID of the loan to adjust. Must belong to the authenticated lender.

Body fields

FieldTypeRequiredDescription
componentstringYesThe component to reduce. One of interest, late_fee, or daily_penalty.
amountintegerYesCentavos to take off. Must be at least 1 and at most the current outstanding amount of the component.
reasonstringYesWhy you are making the adjustment. Required, non-blank, up to 500 characters. Merchants never see adjustments or reasons.

Example request — waive a late fee

curl -XPOST https://api.paymongo.com/v1/capitals/lenders/loans/loan_123/adjustments -H "Content-Type: application/json" -d \
'{
  "component": "late_fee",
  "amount": 75000,
  "reason": "Goodwill: first time overdue"
}'

Response

Returns the loan object with updated outstanding amounts. The example below shows only the relevant fields; see Contract and Loan for the full loan object.

{
  "data": {
    "id": "loan_123",
    "status": "active",
    "late_fee_amount": 75000,
    "outstanding_late_fee_amount": 0,
    "outstanding_principal_amount": 10000000,
    "outstanding_interest_amount": 25000,
    "outstanding_dst_amount": 500,
    "outstanding_daily_penalty_amount": 5000,
    "outstanding_amount": 10030500
  }
}

Note that late_fee_amount (the total amount charged) remains at 75000, while outstanding_late_fee_amount reflects the reduced balance.

Clearing the full outstanding balance

If an adjustment reduces outstanding_amount to zero — meaning outstanding principal, interest, DST, late fee, and daily penalty are all zero — the loan transitions to repaid automatically. For a term loan, the associated contract also transitions to completed. For a revolving contract, the contract stays active and the available credit is not restored (since no principal was repaid in an adjustment).

Error codes

HTTP statusCondition
404The loan does not exist or belongs to a different lender.
422The loan is already repaid, or is not yet active (e.g., still pending or failed).
422amount exceeds the outstanding amount of the component.
422component is not one of interest, late_fee, or daily_penalty (for example, principal or dst).
422amount is zero or negative.
422reason is blank, missing, or longer than 500 characters.
422The request body is missing or is not valid JSON.

Did this page help you?