Loan Application Status Notification

Use Case

Use this webhook when the lender needs to notify Fundiin about updates in the loan application or contract lifecycle.

Request

POST /lender/open/notify/loan-application-status

See Multi Lender Webhooks Overview for base URL, request headers, HMAC signature, common response codes, retry policy, and replay protection.

Request Body

Parameter	Type	Required	Description
requestId	String		Unique webhook request ID generated by the lender.
fundiinRequestId	String		Request ID previously passed by Fundiin to the lender.
lenderCode	String		Lender code assigned by Fundiin.
requestingDatetime	Timestamp		Request timestamp. Format: yyyy-MM-ddTHH:mm:ss+0700.
loanStatus	String		Loan application status. See Loan Application Status.
lenderApplicationId	String		Loan application ID generated by the lender.
contractNumber	String	Conditional	Required when a contract has been created.
contractSigningUrl	String	Conditional	URL for the customer to sign the contract. Required when loanStatus = SIGNING_IN_PROGRESS.
contractUrl	String	Conditional	Signed contract URL. Required when the contract has been signed.
errorCode	String	Conditional	Required when loanStatus = REJECTED or loanStatus = CANCELLED.
errorMessage	String	Conditional	Required when errorCode is returned.
isReapplyingAllowed	Boolean	Conditional	Indicates whether the customer can reapply after a rejected application.
reapplyingDatetime	Timestamp	Conditional	Time when the customer can reapply. Format: yyyy-MM-ddTHH:mm:ss+0700.

Loan Application Status

Code	Description
RECEIVED	Lender receives the application submitted by Fundiin.
APPROVED	Lender approves the loan application.
REJECTED	Lender rejects the loan application.
CANCELLED	Lender cancels the loan application.
SIGNING_IN_PROGRESS	Customer can sign the contract.
WAITING_CONFIRM	Customer has signed the contract and is waiting for Fundiin confirmation.
PROCESSING	Fundiin confirms the contract successfully.
SIGNED_TO_BE_DISBURSED	Contract flow is completed and waiting for disbursement.
DISBURSED	Lender has disbursed the loan.
ACTIVATED	Contract is active.
TERMINATED	Loan application has reached final settlement.

Example Request

{
  "requestId": "WH_REQ_202505300001",
  "fundiinRequestId": "REQ1234567890",
  "lenderCode": "LENDER_A",
  "requestingDatetime": "2025-05-30T10:15:00+0700",
  "loanStatus": "DISBURSED",
  "lenderApplicationId": "LA20250530001",
  "contractNumber": "CNTR20250530001",
  "contractSigningUrl": null,
  "contractUrl": "https://lender.example.com/contracts/CNTR20250530001",
  "errorCode": null,
  "errorMessage": null,
  "isReapplyingAllowed": false,
  "reapplyingDatetime": null
}

Response

See Common Response and Common Response Codes.