Amend NPS Mandate

Overview

AmendNpsMandateCommand amends an existing outward NPS mandate by sending a pain.010 amendment request via the BankLingo Nibss API. You can update the collection amount, the mandate end date, or both. On success, the local MandateSetup record is updated to Amended.

Outward mandates only

Only mandates we originated (destinationInstitutionCode ≠ our bank code) and that are in Active status can be amended.

Command Details

• Command: AmendNpsMandateCommand
• Type: Command

API Endpoint

POST /api/bpm/cmd

Request Structure

Field	Type	Required	Description
mandateReferenceNumber	string	Yes	NPS mandate reference number to amend
newAmount	decimal	No	New collection amount. Omit to keep existing amount
newEndDate	string	No	New end date in yyyy-MM-dd format. Omit to keep existing date
reason	string	No	Amendment reason

Try It Out

POST/api/bpm/cmdAmendNpsMandateCommand

Base URL

Bearer Token

Request Body

{ "cmd": "AmendNpsMandateCommand", "data": { "mandateReferenceNumber": "MND0000000001", "newAmount": 75000, "newEndDate": "2027-12-31", "reason": "Loan restructured" } }

Response Structure

{
  "isSuccessful": true,
  "statusCode": "00",
  "message": "NPS mandate amendment submitted successfully.",
  "data": {
    "id": 101,
    "mandateReferenceNumber": "MND0000000001",
    "mandateStatus": "Amended",
    "amount": 75000.00,
    "lastUpdated": "2026-07-05T09:15:00Z",
    "nibssApiResponse": "{\"responseCode\":\"00\",\"responseDescription\":\"Successful\"}"
  }
}

Error Responses

Condition	Message
Mandate not found	"NPS mandate 'MND...' not found."
Mandate is cancelled	"Cannot amend a cancelled mandate."
Nibss API rejected	"Nibss API rejected (HTTP 400)." with nibssApiResponse detail

Related Operations

• Get NPS Mandate by ID — Check current mandate status and amount
• Cancel NPS Mandate — Cancel the mandate instead