Webhooks and Callbacks
Fundiin integrations rely on webhooks to keep systems synchronized after asynchronous events.
Webhook families
| Family | Direction | Purpose |
|---|---|---|
| Merchant payment notification | Fundiin to merchant | Notify the merchant when a payment reaches a final or updated status. |
| Lender lifecycle webhooks | Lender to Fundiin | Notify Fundiin about loan status, installment schedule, payment receipt, and repayment allocation. |
Merchant callbacks
Use Payment Notification when Fundiin needs to notify the merchant about payment results.
Minimum handling:
- Verify the
Signatureheader. - Match the event to your
referenceId. - Return the required acknowledgement.
- Retry internal processing safely with your own idempotency key.
Lender webhooks
Use Lender Webhooks Overview for lender-side events.
Core events:
| 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 |
Delivery rules
- Sign the exact raw request body with HMAC SHA-256.
- Reuse the same idempotency key when retrying the same event.
- Treat each webhook as independently acknowledged.
- Test successful, failed, delayed, and duplicate delivery scenarios before UAT.
Use Webhook Event Builder to generate signed sample cURL commands for merchant callbacks and lender notifications.