Update NIBSS Mandate

Overview

The UpdateNibssMandateCommand updates an existing NIBSS direct debit mandate. Only mandates in Draft status can be updated. Once a mandate has been authorised, it cannot be modified.

Command Details

• Command: UpdateNibssMandateCommand
• Type: Command

API Endpoint

POST /api/bpm/cmd

Request Structure

Field	Type	Required	Description
mandateId	long	Yes	The ID of the mandate to update
amount	decimal	No	Updated total mandate amount
debitAmount	decimal	No	Updated debit instalment amount
numberOfInstallments	int	No	Updated number of instalments
mobileNumber	string	No	Updated mobile number
emailAddress	string	No	Updated email address
payerName	string	No	Updated payer name
tag	string	No	Updated tag

Try It Out

POST/api/bpm/cmdUpdateNibssMandateCommand

Base URL

Bearer Token

Request Body

{ "cmd": "UpdateNibssMandateCommand", "data": { "mandateId": 5012, "amount": 600000, "debitAmount": 60000, "mobileNumber": "08012345678", "emailAddress": "john.updated@example.com" } }

Response Structure

{
  "response": {
    "id": 5012,
    "status": "Draft"
  },
  "responseCode": "00",
  "responseDescription": "Mandate updated successfully"
}

Related Operations

• Create NIBSS Mandate — Create a new mandate
• Authorise NIBSS Mandate — Submit the mandate to NIBSS after updates
• Retrieve NIBSS Mandate by ID — View current mandate details