Tính lãi vay & trả góp API
Lịch trả nợ hằng tháng của khoản vay: dư nợ giảm dần, trả góp đều hoặc lãi phẳng, lãi suất ưu đãi, phí trả nợ trước hạn và lãi suất thực tế.
API tính lãi vay lập lịch trả nợ đầy đủ theo từng tháng: dư nợ đầu kỳ, tiền gốc, tiền lãi, số tiền phải trả và dư nợ cuối kỳ. API hỗ trợ ba cách tính mà ngân hàng và công ty tài chính tại Việt Nam dùng: declining (dư nợ giảm dần: gốc trả đều, lãi tính trên dư nợ còn lại, cách phổ biến của vay mua nhà, mua xe), annuity (trả góp đều: mỗi tháng trả cùng một số tiền) và flat (lãi phẳng: lãi tính trên số tiền vay ban đầu mỗi tháng, hay gặp khi mua trả góp).
Các gói vay thực tế thường có lãi suất ưu đãi ban đầu: promo_rate=7.5&promo_months=12 áp dụng cho năm đầu, sau đó là lãi suất rate thông thường, số tiền trả góp được tính lại. prepay_month và prepay_fee mô phỏng tất toán trước hạn kèm phí phạt, start_date thêm ngày trả cho từng kỳ. Mọi phản hồi đều so sánh ba cách tính cho cùng khoản vay.
effective_annual_rate là lãi suất thực tế (IRR của dòng tiền trả nợ): vay lãi phẳng 12% thực chất tốn khoảng 21% một năm, đây là con số nên dùng để so sánh các gói vay. Số tiền mỗi kỳ được làm tròn đến đồng.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
amount | body|query | number | có | Số tiền vay. | |
rate | body|query | number | có | Lãi suất năm (%), ví dụ 10.5. | |
months | body|query | number | có | Thời hạn vay (tháng), hoặc years. | |
method | body|query | string | không | declining | declining, annuity hoặc flat. |
promo_rate | body|query | number | không | Lãi suất ưu đãi (%/năm). | |
promo_months | body|query | number | không | Số tháng hưởng lãi suất ưu đãi. | |
prepay_month | body|query | number | không | Tháng tất toán trước hạn. | |
prepay_fee | body|query | number | không | 0 | Phí trả nợ trước hạn (% số gốc trả trước). |
start_date | body|query | string | không | Ngày giải ngân (YYYY-MM-DD) để có ngày trả từng kỳ. | |
schedule | body|query | boolean | không | true | false: chỉ trả về số tổng. |
Ví dụ
curl "https://apibox.io.vn/v1/loan-calc?amount=120000000&months=12&rate=12&schedule=false" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/loan-calc?amount=120000000&months=12&rate=12&schedule=false', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/loan-calc?amount=120000000&months=12&rate=12&schedule=false",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/loan-calc?amount=120000000&months=12&rate=12&schedule=false');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"amount": 120000000,
"months": 12,
"rate": 12,
"method": "declining",
"first_payment": 11200000,
"max_payment": 11200000,
"last_payment": 10100000,
"total_interest": 7800000,
"total_paid": 127800000,
"effective_annual_rate": 12,
"compare_methods": {
"declining": {
"first_payment": 11200000,
"last_payment": 10100000,
"total_interest": 7800000
},
"annuity": {
"first_payment": 10661855,
"last_payment": 10661855,
"total_interest": 7942256
},
"flat": {
"first_payment": 11200000,
"last_payment": 11200000,
"total_interest": 14400000
}
}
}
Ứng dụng
- Công cụ tính lãi vay trên web ngân hàng, đại lý ô tô, bất động sản
- So sánh gói trả góp (lãi phẳng và dư nợ giảm dần) trong app tài chính
- Sinh lịch trả nợ cho hợp đồng, CRM
- Mô phỏng tất toán sớm trước khi chuyển khoản vay
Hỏi đáp
Dư nợ giảm dần hay trả góp đều?
Với dư nợ giảm dần, các kỳ đầu trả nhiều hơn nhưng tổng lãi thấp hơn. Trả góp đều giữ số tiền mỗi tháng như nhau nhưng tổng lãi cao hơn một chút.
Vì sao lãi phẳng đắt như vậy?
Lãi được tính trên số tiền vay ban đầu dù mỗi tháng bạn đã trả bớt gốc. Lãi phẳng 12% ≈ lãi thực tế 21%; xem effective_annual_rate.
Thời gian ưu đãi được tính thế nào?
Lãi suất ưu đãi áp dụng cho promo_months tháng đầu; sau đó lãi suất thông thường áp dụng cho dư nợ còn lại và, với trả góp đều, số tiền mỗi kỳ được tính lại.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.