Repayment Status Notification

Use Case

Use this webhook when the lender needs to notify Fundiin about repayment or debt clearance allocation for the loan. This endpoint supports batch updates.

Request

POST /lender/open/notify/repayment

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.
contractNumber	String		Contract number.
repaymentTransactions	JsonArray		Repayment transaction list.

Data of repaymentTransactions

Attribute	Type	Required	Description
lenderTransactionCode	String		Transaction code generated by the lender.
bankTransactionSequenceId	String		Unique transaction sequence ID assigned by the bank or financial institution.
debtClearanceDatetime	Timestamp		Time when the repayment or debt clearance is performed. Format: yyyy-MM-ddTHH:mm:ss+0700.
amount	Number		Repayment amount in VND.
installmentId	String		Related installment ID generated by the lender.
installmentNumber	Number		Related installment sequence number.

Example Request

{
  "requestId": "WH_REQ_202505300004",
  "fundiinRequestId": "REQ1234567890",
  "lenderCode": "LENDER_A",
  "requestingDatetime": "2025-05-30T10:15:00+0700",
  "contractNumber": "CNTR20250530001",
  "repaymentTransactions": [
    {
      "lenderTransactionCode": "LENDER_TXN_123456789",
      "bankTransactionSequenceId": "BANK_SEQ_202505300001",
      "debtClearanceDatetime": "2025-07-15T09:00:00+0700",
      "amount": 1500000,
      "installmentId": "INS_001",
      "installmentNumber": 1
    },
    {
      "lenderTransactionCode": "LENDER_TXN_987654321",
      "bankTransactionSequenceId": "BANK_SEQ_202508150001",
      "debtClearanceDatetime": "2025-08-15T09:00:00+0700",
      "amount": 2000000,
      "installmentId": "INS_002",
      "installmentNumber": 2
    }
  ]
}

Response

See Common Response and Common Response Codes.