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ế.

GETPOSThttps://apibox.io.vn/v1/loan-calc
Dữ liệu & JSON▶ Dùng thử online

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ênVị tríKiểuBắt buộcMặc định
amountbody|querynumbercóSố tiền vay.
ratebody|querynumbercóLãi suất năm (%), ví dụ 10.5.
monthsbody|querynumbercóThời hạn vay (tháng), hoặc years.
methodbody|querystringkhôngdecliningdeclining, annuity hoặc flat.
promo_ratebody|querynumberkhôngLãi suất ưu đãi (%/năm).
promo_monthsbody|querynumberkhôngSố tháng hưởng lãi suất ưu đãi.
prepay_monthbody|querynumberkhôngTháng tất toán trước hạn.
prepay_feebody|querynumberkhông0Phí trả nợ trước hạn (% số gốc trả trước).
start_datebody|querystringkhôngNgày giải ngân (YYYY-MM-DD) để có ngày trả từng kỳ.
schedulebody|querybooleankhôngtruefalse: 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"

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →