Mortgage prepayment penalty calculator
A 2% penalty on a 250,000 balance is 5,000, so clearing the mortgage takes 255,000. Enter the outstanding balance and the percent in your note to see the fee and the total payoff before you sell or refinance. Free in your browser.
- Free
- Runs in your browser
- No sign-up
- Your data stays on your device
Run — free
Worked example
- Outstanding balance
- 250,000
- Penalty percent
- 2
- Penalty
- 5,000
- Total payoff
- 255,000
- Decimal places
- 2
Many fixed-rate and closed mortgages still charge a prepayment penalty when you sell, refinance, or pay the loan off before the lockout window ends. Borrowers, loan officers, and refinance desks need a fast, auditable estimate of that fee as a simple percentage of the outstanding principal—not a multi-page note-schedule model. This mortgage prepayment penalty calculator multiplies your current outstanding balance by the contractual penalty percent, returns the dollar (or currency) penalty, and adds it to the balance so you see total cash required to clear the note. Half-up rounding is applied once when you choose a decimal precision. No network calls, random seeds, or server clocks are involved.
How the percent-of-balance prepayment penalty is computed
Most consumer mortgage notes express a soft prepayment penalty as a fixed percent of the remaining principal at the moment you request a payoff statement. If your outstanding balance is two hundred fifty thousand and the note says two percent for early payoff inside the first three years, the fee is five thousand. Half-up rounding is applied once to money fields after the raw product is computed, using the optional decimals parameter (default two).
The engine does not prorate by remaining months of a lockout, does not switch into interest-month modes, and does not pull live rates: it answers the single search intent of a mortgage prepayment penalty calculator based on a percentage of the outstanding balance. When the balance is zero the fee is zero as well. Negative balances and negative percents are rejected rather than silently producing a credit.
What you can do with it
Refinance break-even with soft prepayment clauses
Estimate the percent-of-balance fee and total cash to clear the old mortgage before comparing it to first-year savings on a new rate.
Sale net-sheet checks inside a lockout window
Convert the outstanding principal and the note’s penalty percent into a payoff total for seller proceeds before listing or accepting an offer.
FAQ
How is the mortgage prepayment penalty calculated?
Half-up rounding uses the optional decimals field (default 2).
Does this cover interest-month or yield-maintenance penalties?
No. This calculator models percent-of-outstanding-balance soft prepayment fees only. Other commercial structures need a different tool.
What does the total payoff figure include?
It is the outstanding balance plus the penalty, the cash needed to clear the mortgage. With 250,000 owed and a 2% clause, the total payoff is 255,000, which you can set against sale proceeds or a refinance.
How do I enter a penalty of one and a half percent?
Type 1.5. The penalty is entered as a percent of the outstanding balance, so 2 means 2% and needs no conversion into a decimal fraction.
Can I check a scenario with no penalty?
Yes. Enter 0 as the penalty percent and the fee is zero, so the total payoff equals the balance. It is a quick way to set a no-penalty offer beside one with a 2% clause.
Related tools
For developers — API access
Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.
API endpoint
Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.
Call it from your stack
curl -X POST https://api.kit.forhosting.com/finance/mortgage-prepayment-penalty \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"outstanding_balance":250000,"penalty_percent":2}'const res = await fetch("https://api.kit.forhosting.com/finance/mortgage-prepayment-penalty", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"outstanding_balance": 250000,
"penalty_percent": 2
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/finance/mortgage-prepayment-penalty",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"outstanding_balance": 250000,
"penalty_percent": 2
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/mortgage-prepayment-penalty", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"outstanding_balance":250000,"penalty_percent":2}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"outstanding_balance":250000,"penalty_percent":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/mortgage-prepayment-penalty", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Example request
{
"outstanding_balance": 250000,
"penalty_percent": 2
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "finance.mortgage_prepayment_penalty",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
Technical notes
Inputs are validated before math; invalid payloads fail with invalid_input and are not billed.
How the percent-of-balance prepayment penalty is computed
The formula is deliberately simple: penalty equals outstanding_balance times penalty_percent divided by one hundred. The calculator also returns total_payoff, which is outstanding_balance plus penalty, so refinance and sale worksheets can line up the wire amount against closing proceeds in one place. When penalty_percent is zero the penalty is zero and total_payoff equals the balance, which is useful for stress-testing a no-penalty scenario next to a two-percent clause.
Input contract, validation, response fields, and rounding
Numeric strings are accepted where a finite number is expected so form posts and spreadsheet exports do not need a separate cast step. POST a JSON body with two required finite numbers. outstanding_balance is the current unpaid principal on the mortgage in your currency unit and must be greater than or equal to zero. penalty_percent is the contractual early-payoff rate expressed as a percent of that balance—for example two for two percent or one point five for one and a half percent—and must also be greater than or equal to zero. Optional decimals is an integer from zero through eight that controls half-up places on outstanding_balance, penalty_percent, penalty, and total_payoff; it defaults to two when omitted. Missing fields, empty strings, non-finite values, and out-of-range decimals fail with invalid_input naming the problem; those failures do not consume prepaid balance. Every successful response echoes the rounded outstanding_balance and penalty_percent, returns penalty and total_payoff, includes a formula string restating the percent-of-balance identity, and reports the decimals used. Example: outstanding_balance two hundred fifty thousand and penalty_percent two yields penalty five thousand and total_payoff two hundred fifty-five thousand at two decimal places. Pair the response with your own closing calendar if you need hard lockout dates; this endpoint prices the fee only and does not emit legal opinions or note scans.
Where a mortgage prepayment penalty estimate earns its keep
Homeowners comparing a cash-out refinance against staying put use a mortgage prepayment penalty calculator to see whether a two-percent fee wipes out the first year of rate savings. Content sites that rank for mortgage prepayment penalty calculator benefit from a live tool whose free browser path matches the paid automation path on the same pure module. Failed validation does not consume balance. The tool does not model yield-maintenance, defeasance, or multi-month interest penalties used on some commercial and jumbo products; those schedules belong in their own capabilities. Loan officers and mortgage brokers quote soft prepayment clauses during rate-lock conversations and need total_payoff next to the new loan amount without opening a desktop amortization workbook. Portfolio and CMS automation can batch outstanding_balance and penalty_percent across many notes via the API using the identical JSON contract.
Integration use cases
Broker quotes and automation pipelines
Call the same JSON fields from scripts or CMS hooks to batch soft prepayment estimates across many residential loans.
Technical questions
What should I enter for outstanding_balance?
Use the current unpaid principal from your latest statement or payoff quote, not the original loan amount. It must be a finite number greater than or equal to zero.
Where does penalty_percent come from?
From your mortgage note or Loan Estimate—commonly 1% to 5% of remaining principal during an early-payoff window. Enter 2 for two percent.
What does the mortgage prepayment penalty calculator cost?
The browser tool is free. API requests use prepaid KIT balance at $0.002 per successful call; invalid input is not billed.