Get Inward Debit Request by ID

Overview

GetNpsInwardDebitRequestByIdQuery retrieves the full detail of a single NPS inward direct debit request including BVN, KYC level, and reversal information.

Command Details

• Command: GetNpsInwardDebitRequestByIdQuery
• Type: Query

API Endpoint

POST /api/bpm/cmd

Request Structure

Field	Type	Required	Description
id	int	Yes	Internal ID of the inward debit request

Try It Out

POST/api/bpm/cmdGetNpsInwardDebitRequestByIdQuery

Base URL

Bearer Token

Request Body

{ "cmd": "GetNpsInwardDebitRequestByIdQuery", "data": { "id": 501 } }

Response Structure

{
  "isSuccessful": true,
  "statusCode": "00",
  "data": {
    "id": 501,
    "sessionID": "SESS-20260201-001",
    "mandateReferenceNumber": "MND0000000001",
    "debitAccountName": "JOHN DOE",
    "debitAccountNumber": "0123456789",
    "debitBankVerificationNumber": "12345678901",
    "debitKYCLevel": "3",
    "beneficiaryAccountName": "ABC COMPANY",
    "beneficiaryAccountNumber": "9876543210",
    "beneficiaryBankVerificationNumber": "98765432101",
    "beneficiaryKYCLevel": "3",
    "originatorAccountName": "ABC COMPANY",
    "originatorAccountNumber": "9876543210",
    "originatorBankVerificationNumber": "98765432101",
    "originatorKYCLevel": "3",
    "narration": "Loan repayment",
    "amount": 50000.00,
    "transactionFee": 50.00,
    "status": "Successful",
    "responseCode": "00",
    "responseDescription": "Approved",
    "receiveResponseCode": "00",
    "transactionTimeStamp": "2026-02-01T08:00:00Z",
    "transactionId": "TXN123456",
    "paymentReference": "PAY123456",
    "destinationInstitutionCode": "090114",
    "channelCode": "1",
    "transactionLocation": null,
    "sourceProvider": "nps",
    "reversalAdviseSessionId": null,
    "reversalAdviseTimeStamp": null
  }
}

Additional Fields vs List

Field	Description
debitBankVerificationNumber	Debtor BVN
debitKYCLevel	Debtor KYC tier
beneficiaryBankVerificationNumber	Beneficiary BVN
beneficiaryKYCLevel	Beneficiary KYC tier
originatorBankVerificationNumber	Originator BVN
originatorKYCLevel	Originator KYC tier
destinationInstitutionCode	Our bank code (we are the destination/debtor)
channelCode	NPS channel code
transactionLocation	Physical location if provided
reversalAdviseSessionId	Session ID of the reversal, if reversed
reversalAdviseTimeStamp	Timestamp of reversal

Related Operations

• Get NPS Inward Debit Requests — List all inward debit requests
• Get NPS Mandate by ID — View the mandate this debit belongs to