Hướng dẫn tích hợp
Tài liệu này mô tả đặc tả webhook dành cho lender tích hợp với Fundiin. Lender sẽ thông báo cho Fundiin các sự kiện về vòng đời khoản vay, giải ngân, ghi nhận thanh toán, gạch nợ và cập nhật lịch trả góp để dữ liệu hiển thị cho khách hàng luôn được đồng bộ với trạng thái mới nhất.
Fundiin hỗ trợ hai cấp độ tích hợp.
Bảng bên dưới định nghĩa các webhook bắt buộc cho từng cấp độ. Vui lòng xác nhận cấp độ tích hợp với integration manager của Fundiin trước khi go-live.
Dùng khi lender chỉ cung cấp được dữ liệu tổng hợp ở cấp khoản vay như tổng dư nợ, số tiền cần thanh toán và ngày đến hạn tiếp theo.
- Dữ liệu cung cấp: tóm tắt nghĩa vụ trả nợ ở cấp khoản vay
- Installment Schedule là bắt buộc, nhưng chỉ cần gửi dữ liệu tổng hợp của khoản vay
- Không yêu cầu Payment Receipt và Repayment Allocation
Dùng khi lender cung cấp được dữ liệu chi tiết theo từng kỳ trả góp và thông tin gạch nợ sau thanh toán.
- Dữ liệu cung cấp: lịch trả góp theo từng kỳ và thông tin gạch nợ
- Installment Schedule là bắt buộc và cần gửi đầy đủ danh sách kỳ trả góp
- Payment Receipt và Repayment Allocation là bắt buộc
Giá trị vận hành thực tế của từng cấp độ
Tích hợp nhanh chóng
Quy trình tích hợp đơn giản, mất ít công sức phát triển của đội ngũ kỹ thuật.
Hạn chế tối đa chia sẻ dữ liệu
Chỉ chia sẻ các chỉ số cơ bản ở cấp khoản vay (số dư nợ, ngày đến hạn).
Giảm tải bộ phận chăm sóc khách hàng
Khách hàng tự tra cứu chi tiết từng kỳ thanh toán và lịch sử giao dịch trực tiếp trên app Fundiin mà không cần liên hệ Lender.
Trải nghiệm khách hàng vượt trội
Khách hàng dễ dàng quản lý tập trung tất cả các khoản vay tại một nơi duy nhất trên app Fundiin.
Dữ liệu từ lender được dùng để hiển thị màn hình trả nợ cho khách hàng.
Fundiin App cập nhật trạng thái mới nhất do lender cung cấp sau mỗi webhook. Chuyển giữa các cấp độ để xem mỗi kiểu tích hợp có thể hiển thị mức độ chi tiết nào cho khách hàng.
Tổng hợp cấp khoản vay
Bao gồm tổng khoản vay, số tiền cần thanh toán ngay, ngày đến hạn tiếp theo và khoản đã nhận nhưng chưa gạch nợ.
Cập nhật ngay dư nợ còn lại, ngày đến hạn tiếp theo và số tiền cần thanh toán sau mỗi sự kiện.
Hiển thị riêng tiền gốc, lãi và phí quá hạn cho từng kỳ trả góp.
Theo dõi khoản tiền đã nhận và phần đã được phân bổ vào các kỳ nợ tương ứng.
Tổng khoản vay: 30,000,000 đ
- Mã khoản vay
- Cashloanfundiin 1
- Đối tác cho vay
- Lender
- Ngày đến hạn tiếp theo
- 10/05/2026
- Số tiền đến hạn tiếp theo
- 10,400,000 đ
Cập nhật lúc: 09:41 · 10/06/2026
Tổng khoản vay: 30,000,000 đ
- Mã khoản vay
- Cashloanfundiin 1
- Đối tác cho vay
- Lender
- Ngày đến hạn tiếp theo
- 10/07/2026
- Số tiền đến hạn tiếp theo
- 10,000,000 đ
- Tiền gốc
- 9,800,000 đ
- Lãi trong hạn
- 200,000 đ
- Tiền gốc
- 9,800,000 đ
- Lãi trong hạn
- 200,000 đ
- Lãi quá hạn
- 400,000 đ
- Tiền gốc
- 9,800,000 đ
- Lãi trong hạn
- 200,000 đ
Triển khai các notification bắt buộc.
Bốn trang API chi tiết bên dưới tương ứng với các đặc tả webhook trong hướng dẫn tích hợp.
Trạng thái hồ sơ vay
/lender/open/notify/loan-application-statusThông báo cho Fundiin khi trạng thái hồ sơ vay thay đổi, từ lúc tiếp nhận, giải ngân, kích hoạt khoản vay đến tất toán.
Mở tài liệuLịch trả góp
/lender/open/notify/installment-scheduleĐược gửi sau khi khoản vay được kích hoạt và sau mỗi lần gạch nợ để Fundiin đồng bộ lại trạng thái khoản vay.
Mở tài liệuGhi nhận tiền thanh toán
/lender/open/notify/payment-receiptGhi nhận sự kiện lender đã nhận tiền thanh toán từ khách hàng. Webhook này chỉ xác nhận dòng tiền vào, chưa thể hiện việc gạch nợ.
Mở tài liệuThông tin gạch nợ
/lender/open/notify/repayment-allocationThông báo cho Fundiin việc khoản thanh toán đã được phân bổ vào một hoặc nhiều kỳ nợ sau khi lender xử lý.
Mở tài liệu