Loan Application Status Notification
Use Case
Use this webhook when the lender needs to notify Fundiin of status changes for a loan application, from receipt through disbursement, activation, and closure.
Integration: TRIAL + STANDARD
Request
POST /lender/open/notify/loan-application-status
See Lender Notification API Overview for base URL, request headers, HMAC signature, common request fields, idempotency, and response format.
Request Body
The request body includes the Common Request Fields plus the fields below.
| Parameter | Type | Required | Description |
|---|---|---|---|
| loanStatus | Loan status. See Loan Status Values. | ||
| lenderReferenceId | Stable application or loan identifier generated by the lender. Use one value across status updates for the same customer application or loan. | ||
| virtualAccount | Conditional | Virtual account details for customer repayment. Required when loanStatus = DISBURSED. See Data of virtualAccount. | |
| disbursementDate | Conditional | Datetime the lender disbursed the loan to the customer. Required when loanStatus = DISBURSED. Format: yyyy-MM-ddTHH:mm:ss+0700. Send null for other statuses. | |
| contractNumber | Conditional | Contract number. Required when a contract has been created. | |
| contractSigningUrl | Conditional | URL for the customer to sign the contract. Required when loanStatus = SIGNING_IN_PROGRESS. | |
| contractSigningUrlExpiry | Conditional | Expiry time of contractSigningUrl. Format: yyyy-MM-ddTHH:mm:ss+0700. | |
| contractUrl | Conditional | Signed contract document URL. Required when the contract has been signed. | |
| errorCode | Conditional | Required when loanStatus = REJECTED or loanStatus = CANCELLED. | |
| errorMessage | Conditional | Human-readable error description. Required when errorCode is returned. | |
| terminationReason | Conditional | Lender-defined reason code for rejection, cancellation, or closure. Follow the lender's reason code set. Example values only: FRAUD, NOT_ELIGIBLE, USER_INVALID. | |
| isReapplyAllowed | Conditional | Whether the customer can submit a new loan application after this rejection. Required when loanStatus = REJECTED. true when reapply is allowed, false otherwise. See Reapply Rules. | |
| reapplyAllowedFrom | Conditional | Earliest datetime the customer can reapply. Required when isReapplyAllowed = true; null means the customer can reapply immediately. Format: yyyy-MM-ddTHH:mm:ss+0700. See Reapply Rules. |
Data of virtualAccount
| Attribute | Type | Required | Description |
|---|---|---|---|
| accountNumber | Virtual account number for customer repayment. | ||
| accountName | Conditional | Virtual account name or beneficiary name, if available. | |
| bankCode | Conditional | Bank code, if available. | |
| bankName | Conditional | Bank display name, if available. |
Reapply Rules
When loanStatus = REJECTED, the lender must tell Fundiin whether the customer can submit a new loan application and from when.
isReapplyAllowed = truewhen the customer is allowed to reapply,falseotherwise.- When
isReapplyAllowed = true,reapplyAllowedFrommust be included in the payload. reapplyAllowedFrom = nullmeans the customer can reapply immediately.- When the lender rule requires a waiting period (for example 1 day or 30 days), the lender calculates
reapplyAllowedFrom = now + waiting period, wherenowis the time the lender sends the notification (requestingDatetime, timezone+0700). Fundiin stores the value as sent and does not recalculate it. - When
isReapplyAllowed = false, sendreapplyAllowedFrom = null. Fundiin ignores any value in this case.
| Lender rule | isReapplyAllowed | reapplyAllowedFrom | Example (requestingDatetime = 2025-05-30T10:15:00+0700) |
|---|---|---|---|
| Reapply immediately | true | null | null |
| Wait 1 day | true | now + 1 day | 2025-05-31T10:15:00+0700 |
| Wait 30 days | true | now + 30 days | 2025-06-29T10:15:00+0700 |
| Permanently rejected | false | null | null |
Loan Status Values
| Code | Description |
|---|---|
| RECEIVED | Lender received the loan application submitted by Fundiin. |
| PROCESSING | Lender is processing the loan application or disbursement request. |
| APPROVED | Lender approved the loan application. |
| REJECTED | Lender rejected the loan application. Populate errorCode and errorMessage. |
| CANCELLED | Loan application was cancelled before disbursement. Populate errorCode and errorMessage when applicable. |
| SIGNING_IN_PROGRESS | Customer can sign the contract. |
| DISBURSED | Lender has disbursed the loan. Populate lenderReferenceId, disbursementDate, and virtualAccount. |
| CLOSED | Loan has been fully repaid and has no remaining outstanding balance. |
Example Requests
DISBURSED
{
"requestId": "WH_REQ_202505300001",
"fundiinApplicationId": "APP1234567890",
"lenderCode": "LENDER_A",
"requestingDatetime": "2025-05-30T10:15:00+0700",
"loanStatus": "DISBURSED",
"lenderReferenceId": "LN20250530001",
"disbursementDate": "2025-05-30T10:12:30+0700",
"virtualAccount": {
"accountNumber": "9901234567890",
"accountName": "NGUYEN VAN A",
"bankCode": "VCB",
"bankName": "Vietcombank"
},
"contractNumber": "CNTR20250530001",
"contractUrl": "https://lender.example.com/contracts/CNTR20250530001",
"contractSigningUrl": null,
"contractSigningUrlExpiry": null,
"errorCode": null,
"errorMessage": null,
"terminationReason": null,
"isReapplyAllowed": false,
"reapplyAllowedFrom": null
}
REJECTED with 30-day reapply window
reapplyAllowedFrom = requestingDatetime + 30 days.
{
"requestId": "WH_REQ_202505300002",
"fundiinApplicationId": "APP1234567890",
"lenderCode": "LENDER_A",
"requestingDatetime": "2025-05-30T10:15:00+0700",
"loanStatus": "REJECTED",
"lenderReferenceId": "LN20250530001",
"disbursementDate": null,
"virtualAccount": null,
"contractNumber": null,
"contractUrl": null,
"contractSigningUrl": null,
"contractSigningUrlExpiry": null,
"errorCode": "CREDIT_SCORE_TOO_LOW",
"errorMessage": "Customer credit score does not meet minimum requirement.",
"terminationReason": "NOT_ELIGIBLE",
"isReapplyAllowed": true,
"reapplyAllowedFrom": "2025-06-29T10:15:00+0700"
}
REJECTED, reapply allowed immediately
{
"requestId": "WH_REQ_202505300003",
"fundiinApplicationId": "APP1234567891",
"lenderCode": "LENDER_A",
"requestingDatetime": "2025-05-30T10:15:00+0700",
"loanStatus": "REJECTED",
"lenderReferenceId": "LN20250530002",
"disbursementDate": null,
"virtualAccount": null,
"contractNumber": null,
"contractUrl": null,
"contractSigningUrl": null,
"contractSigningUrlExpiry": null,
"errorCode": "DOCUMENT_INVALID",
"errorMessage": "Submitted documents are invalid or unreadable.",
"terminationReason": "USER_INVALID",
"isReapplyAllowed": true,
"reapplyAllowedFrom": null
}
REJECTED, reapply not allowed
{
"requestId": "WH_REQ_202505300004",
"fundiinApplicationId": "APP1234567892",
"lenderCode": "LENDER_A",
"requestingDatetime": "2025-05-30T10:15:00+0700",
"loanStatus": "REJECTED",
"lenderReferenceId": "LN20250530003",
"disbursementDate": null,
"virtualAccount": null,
"contractNumber": null,
"contractUrl": null,
"contractSigningUrl": null,
"contractSigningUrlExpiry": null,
"errorCode": "FRAUD_SUSPECTED",
"errorMessage": "Application flagged by fraud screening.",
"terminationReason": "FRAUD",
"isReapplyAllowed": false,
"reapplyAllowedFrom": null
}
Response
See Common Response.