Payment Received Notification

Use Case

Use this webhook when the lender needs to notify Fundiin that a payment from the user has been received successfully into the debt clearance account. Each request contains one received transaction with transaction ID, bank sequence ID, and received amount.

This webhook records money-in events only. It does not allocate the received amount to installments. Use Repayment Notification when the lender confirms repayment or debt clearance allocation.

Request

POST /lender/open/notify/payment-received

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.
receivedTransactions	JsonArray		Received money transaction list. Send exactly one transaction per request.

Data of receivedTransactions

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 when the money is received.
amount	Number		Received amount in VND.
receivedStatus	String		PENDING, SUCCESS, FAILED, REVERSED.

Example Request

{
  "requestId": "WH_REQ_202505300002",
  "fundiinRequestId": "REQ1234567890",
  "lenderCode": "LENDER_A",
  "requestingDatetime": "2025-05-30T10:15:00+0700",
  "contractNumber": "CNTR20250530001",
  "receivedTransactions": [
    {
      "lenderTransactionCode": "LENDER_TXN_123456789",
      "bankTransactionSequenceId": "BANK_SEQ_202505300001",
      "amount": 1500000,
      "receivedStatus": "SUCCESS"
    }
  ]
}

Response

See Common Response and Common Response Codes.