Skip to main content

InitiateMandateOnLoanCommand

Overview​

Initiates a direct debit mandate with NIBSS for automated loan repayment collection.

Status: 📝 Documentation in progress

Command Structure​

{
"cmd": "InitiateMandateOnLoanCommand",
"data": "{\"loanQuoteId\":110}"
}

Parameters​

ParameterTypeRequiredDescription
loanQuoteIdlongYesLoan application ID

Process​

  1. Validates collection account details
  2. Submits mandate request to NIBSS
  3. Generates mandate reference number
  4. Updates mandate status
  5. Sends OTP to customer for authorization

Mandate Lifecycle​

  1. PENDING - Request submitted
  2. OTP_SENT - Awaiting customer authorization
  3. ACTIVE - Customer authorized, mandate active
  4. FAILED - Authorization failed or rejected