ForHosting KIT · 金融・お金

利息元本組み入れ計算ツール

残高10,000に未払い利息500を組み入れると元本は10,500になり、年6パーセント・60か月なら月々の返済は193.33から202.99に増えます。猶予期間や返済の一時停止にかかる負担が分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

元金: 10,000
未払利息: 500

結果

新しい元本残高: 10,500
資本化前の月額返済: 193.33
資本化後の月額返済: 202.99
月額返済の変化: 9.67

無料

利息を元本に組み入れると起きること

元本組み入れとは、たまったまま支払われていない利息をローン残高に加えることです。学生ローンの猶予期間や返済猶予など、返済を止めていた期間のあとによく行われます。新しい残高は、もとの元本に未払い利息を足しただけの金額です。残高10,000に繰り延べた利息500があれば、10,500になります。それ以降、加えた金額は元本として扱われるため、その分にも利息がかかります。

返済額への影響を確かめる

年利と月数も入力すると、組み入れ前と後の残高それぞれについて、毎月一定の返済額を計算します。月利は年利の12分の1です。年6パーセント・60か月なら、10,000は月193.33、10,500は月202.99で、差は9.67です。金利と期間はセットで入力し、両方とも省くと新しい残高だけが表示されます。金利がゼロの場合は残高を月数で割った額が返済額になるので、その場合も妥当な金額が得られます。

活用例

支払い猶予後の残高確定

返済猶予後に飛ばした利息を組み入れ、再計算後の高くなった返済額を借り手に提示します。

学生ローン

据置期間中の未払い利息が、返済開始前に残高をどれだけ押し上げるかを示します。

よくある質問

返済額はどのように計算されますか？

利率がほぼゼロの場合はprincipal/monthsに切り替わります。

利息の元本組み入れとは何ですか？

たまったまま支払われていない利息を、ローンの残高に加えることです。それ以降は元本の一部になるため、残高10,000に未払い利息500があれば、残高は10,500になります。

組み入れ後に返済額が増えるのはなぜですか？

大きくなった残高をもとに返済額を計算し直すうえ、加えた利息にも利息がかかるためです。同じ金利と期間で前後の残高を計算し直すので、その差が組み入れによる毎月の負担になります。

金利と期間は必ず入力しますか？

必須ではありません。2つはセットで、両方を入れると組み入れ前後の返済額も分かり、入れなければ新しい残高だけが表示されます。期間は整数の月数で入力してください。

利息が元本に組み入れられるのはどんなときですか？

多くは返済を止めていた期間のあとです。学生ローンの猶予期間や返済猶予の終了時に、未払いの利息が残高に加えられ、それから通常の返済が始まります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/finance/interest-capitalization

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/finance/interest-capitalization \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"principal":10000,"unpaid_interest":500}'

const res = await fetch("https://api.kit.forhosting.com/finance/interest-capitalization", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "principal": 10000,
    "unpaid_interest": 500
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/interest-capitalization",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "principal": 10000,
    "unpaid_interest": 500
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/interest-capitalization", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"principal":10000,"unpaid_interest":500}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"principal":10000,"unpaid_interest":500}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/interest-capitalization", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "principal": 10000,
  "unpaid_interest": 500
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.interest_capitalization",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

unpaid_interestをprincipalに加算して組み入れ後の新しい残高を求め、さらにannual_rateとmonthsを指定した場合は両方を再計算して、payment_before、payment_after、payment_deltaを表示します。

元本組み入れの計算

元本組み入れとは、発生済みだが未払いの利息をローン残高に繰り入れる処理です。周期利率が実質ゼロに丸められる場合は、公式はprincipalをmonthsで割る形へと滑らかに切り替わり、ゼロ除算による破綻を避けつつ妥当な返済額を返します。new_principalはprincipalとunpaid_interestの合計となり、たとえば繰り延べ利息500ドルを抱えた1万ドルの残高は1万500ドルになります。annual_rateとmonthsも併せて渡すと、標準的な固定返済額の公式 payment = P·i·(1+i)^n / ((1+i)^n − 1) を用いて、旧残高と新残高の両方を再計算します。ここでiはannual_rateを100で割り、さらに12で割った値、nはmonthsです。年利6％・60か月の場合、1万ドルの残高は月193.33ドル、1万500ドルの残高は月202.99ドルとなり、payment_deltaは9.67ドルになります。

入力、丸め、検証

principalはゼロより厳密に大きい有限の数値、unpaid_interestはゼロ以上の有限の数値でなければなりません。いずれかに違反すると、型のない例外を投げる代わりに、問題のあるフィールド名を示す型付きのinvalid_inputエラーが返ります。annual_rateとmonthsは任意で、二つは一組として扱われます。monthsは正の整数、annual_rateはゼロ以上でなければならず、そうでない場合は返済のブロックが単に省略され、principal、unpaid_interest、new_principalだけが返ります。金額の出力はすべて、生のIEEE値に明示的なhalf-upの規則を適用して一度だけ丸められ、既定値2のdecimalsパラメータに従います。payment_deltaは丸める前の返済額から計算してから丸めるため、表示された二つの金額の差から1セントたりともずれることはありません。

どんなときに使うか

貸し手が返済猶予、支払い延期、負の償却による不足分を残高に繰り入れ、借り手の新しい返済額を提示する必要があるときにご利用ください。たとえば据置期間中に利息を飛ばすと、再計算の前に学生ローンが1万ドルから1万500ドルへ増える様子を示せます。純粋なモジュールは同型です。組み入れ後の残高だけを知りたい場合はannual_rateとmonthsを省略します。失敗したタスクに課金されることは決してなく、前払い残高は公表された基本料金での成功したAPI呼び出しにのみ使われます。

連携の活用例

ローン管理業務

JSON APIを通じて、ポートフォリオ全体のnew_principalとpayment_deltaを一括処理します。

技術的な質問

元本組み入れとは何をするものですか？

unpaid_interestをprincipalに加算し、new_principal = principal + unpaid_interestとなります。その後、任意で返済額を再計算します。

annual_rateとmonthsは必須ですか？

いいえ。省略すると組み入れ後の残高だけが返ります。両方を指定すると、payment_before、payment_after、payment_deltaも得られます。

丸めはどのように扱われますか？

decimals桁（既定値2）へのhalf-upで、各フィールドは別の丸め済み数値からではなく生の値から一度だけ丸められます。

無料ですか？

tier Aブラウザwidgetでは無料です。決定的なAPIは$0.002からで、成功した呼び出しにのみ課金されます。

KITの完全なドキュメントを見る →