Webhooks và Callbacks
Fundiin dùng webhooks để đồng bộ hệ thống sau các sự kiện bất đồng bộ.
Nhóm webhook
| Nhóm | Chiều | Mục đích |
|---|---|---|
| Merchant payment notification | Fundiin đến merchant | Thông báo khi payment có trạng thái cuối hoặc trạng thái mới. |
| Lender lifecycle webhooks | Lender đến Fundiin | Thông báo loan status, installment schedule, payment receipt và repayment allocation. |
Merchant callbacks
Dùng Payment Notification khi Fundiin cần gửi kết quả thanh toán về merchant.
Xử lý tối thiểu:
- Verify header
Signature. - Map event với
referenceId. - Trả acknowledgement đúng yêu cầu.
- Retry xử lý nội bộ bằng idempotency key của hệ thống bạn.
Lender webhooks
Dùng Lender Webhooks Overview cho event phía lender.
Các event chính:
| Event | Endpoint |
|---|---|
| Loan Application Status | /lender/open/notify/loan-application-status |
| Installment Schedule | /lender/open/notify/installment-schedule |
| Payment Receipt | /lender/open/notify/payment-receipt |
| Repayment Allocation | /lender/open/notify/repayment-allocation |
Quy tắc delivery
- Ký đúng raw request body bằng HMAC SHA-256.
- Dùng lại cùng idempotency key khi retry cùng một event.
- Mỗi webhook được acknowledge độc lập.
- Test các case thành công, thất bại, chậm và duplicate trước UAT.
Dùng Webhook Event Builder để tạo signed cURL mẫu cho merchant callback và lender notification.