1. Account Restrictions
Core Banking Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Product List
      GET
    • Create Account
      POST
    • Update Account
      PUT
    • Find Client
      POST
    • Accounts
      GET
    • Create Additional Account
      POST
    • Account Details By BVN
      GET
    • Get Client Addresses
      GET
    • Get Account Details
      GET
    • Get Account Summary
      GET
    • Client Images
      GET
    • Update BVN
      POST
    • Update Transaction Limit
      POST
  • KYC
    • Get KYC Info
      POST
    • Update KYC
      POST
    • Get KYC Level
      GET
  • Transaction
    • Payment Types
      GET
    • Debit Account
      POST
    • Credit Account
      POST
    • Transaction History
      GET
    • Transaction Details [Legacy]
      GET
    • Transaction Details
      GET
  • Transfer
    • Get Institutions
    • Name Inquiry
    • Interbank Transfer
    • InterBank Transfer Query
    • Transfer Details
    • IntraBank Transfer
    • Intrabank Transfer To Virtual Accounts
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  • Account Restrictions
    • Block Debit
      POST
    • Unblock Debit
      POST
    • Hold Amount
      POST
    • Release Amount
      POST
  • Schemas
    • Client
    • Product
  1. Account Restrictions

Block Debit

Developing
POST
/core/account/block-debit

Block Debits#

Blocks outgoing transactions only (post‑no‑debit). Deposits are still accepted; withdrawals and
outbound transfers are rejected.
POST /core/account/block-debit

Request Body#

Field NameTypeRequiredDescription
nubanstringTRUEAccount number (NUBAN) to place a debit block on.
reasonForBlockstringTRUEReason recorded against the block. Maximum 100 characters.
{
  "nuban": "0000000206",
  "reasonForBlock": "Suspected fraud - under review"
}

Response#

Field NameTypeDescription
officeIdintegerIdentifier of the office that owns the client / account.
clientIdintegerClient identifier of the account holder.
savingsIdintegerSavings account ID identifier.
resourceIdintegerIdentifier of the resource affected by the command.

Request

Body Params application/jsonRequired

Example
{
    "nuban":"0000000090",
    "reasonForBlock":"Erroneous Posting"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/core/account/block-debit' \
--header 'Content-Type: application/json' \
--data '{
    "nuban":"0000000090",
    "reasonForBlock":"Erroneous Posting"
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{}
Modified at 2026-09-04 10:53:50
Previous
Get Reports
Next
Unblock Debit
Built with