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
| Component | Field reduced | Notes |
|---|---|---|
interest | outstanding_interest_amount | For 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_fee | outstanding_late_fee_amount | Only the outstanding portion can be reduced; late_fee_amount (total ever charged) stays on the record. |
daily_penalty | outstanding_daily_penalty_amount | Reducing 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
| Parameter | Type | Description |
|---|---|---|
loan_id | string | ID of the loan to adjust. Must belong to the authenticated lender. |
Body fields
| Field | Type | Required | Description |
|---|---|---|---|
component | string | Yes | The component to reduce. One of interest, late_fee, or daily_penalty. |
amount | integer | Yes | Centavos to take off. Must be at least 1 and at most the current outstanding amount of the component. |
reason | string | Yes | Why 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 status | Condition |
|---|---|
404 | The loan does not exist or belongs to a different lender. |
422 | The loan is already repaid, or is not yet active (e.g., still pending or failed). |
422 | amount exceeds the outstanding amount of the component. |
422 | component is not one of interest, late_fee, or daily_penalty (for example, principal or dst). |
422 | amount is zero or negative. |
422 | reason is blank, missing, or longer than 500 characters. |
422 | The request body is missing or is not valid JSON. |
Updated about 14 hours ago
