Integration Guide
This guide defines the webhook specification for lenders integrating with Fundiin. Lenders notify Fundiin of loan lifecycle events, disbursement, Payment Receipt, Repayment Allocation, and Installment Schedule updates so Fundiin can keep the customer experience current.
Fundiin supports two integration tiers.
Use when the lender can only provide total outstanding, amount due, and next due date.
- Data provided: loan-level repayment summary
- Installment Schedule is required with loan summary only
- Payment Receipt and Repayment Allocation are not available
Use when the lender can provide per-installment status and payment allocation.
- Data provided: installment-level schedule and payment allocation
- Installment Schedule is required with the full schedule
- Payment Receipt and Repayment Allocation are required
How each integration tier drives value
Fast integration path
Rapid onboarding process with minimal engineering effort required.
Minimal data exposure
Only shares essential high-level loan metrics (balance, due dates).
Reduce support load
Customers can view full installment breakdown and payment history directly on Fundiin app without contacting lender.
Better customer experience
Customers manage all their loans in one place on Fundiin.
Lender data becomes the repayment screen customers see.
Fundiin App reflects the latest lender-provided state after each webhook notification. Switch between tiers to see how much detail each integration can display to the customer.
Loan-level summary
Total loan amount, amount due, next due date, and received-but-unallocated payments.
Instantly updates outstanding balance, next due date, and payment amount after each event.
Displays principal, interest, and overdue fees breakdown separately for each period.
Tracks payments received and real-time allocations to corresponding debt periods.
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 đ
Implement the required notifications.
The four API detail pages below mirror the webhook specifications from the integration guide.
Loan Application Status
/lender/open/notify/loan-application-statusNotifies Fundiin of status changes for a loan application, from receipt through disbursement, activation, and closure.
Open referenceInstallment Schedule
/lender/open/notify/installment-scheduleSent after loan activation and after each repayment allocation as the single sync point for Fundiin to refresh loan state.
Open referencePayment Receipt
/lender/open/notify/payment-receiptRecords the money-in event when the lender receives a payment from the customer. It captures receipt only.
Open referenceRepayment Allocation
/lender/open/notify/repayment-allocationNotifies Fundiin of debt allocation after the lender has processed a payment. Supports batch allocation.
Open reference