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