Core Banking Services
  1. Transaction
Core Banking Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Product List
      GET
    • Create Account
      POST
    • 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
  • Transaction
    • Payment Types
      GET
    • Debit Account
      POST
    • Credit Account
      POST
    • Transaction History
      GET
    • Transaction Details
      GET
  • Transfer
    • Get Institutions
      GET
    • Name Inquiry
      POST
    • Interbank Transfer
      POST
    • InterBank Transfer Query
      GET
    • Transfer Details
      GET
    • IntraBank Transfer
      POST
    • Intrabank Transfer To Virtual Accounts
      POST
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  1. Transaction

Debit Account

POST
/core/debit
This API facilitates the deduction of a specified amount from a customer's account using a selected payment method. The transaction is processed based on the provided account details and payment type.

Request Body#

The request should be a JSON object containing the following fields:
Field NameTypeRequiredDescription
nubanstringTRUEThe NUBAN (bank account number) of the account to be debited.
amountdecimalTRUEThe exact amount to be deducted from the account.
paymentTypeIdintegerTRUEUnique identifier representing the selected payment type for the transaction.

Response Table#

Field NameTypeDescription
transactionIDintegerUnique identifier assigned to the processed debit transaction.
nubanstringThe NUBAN (bank account number) from which the funds were deducted.
amountdecimalThe amount that was successfully debited from the account.
statusstringThe outcome of the transaction, indicating whether it was "Successful" or "Failed."

Request

Body Params application/json
nuban
string 
required
paymentTypeId
integer 
required
amount
number 
required
Example
{
    "nuban": "0000000244",
    "paymentTypeId": 1,
    "amount": 5.50
}

Request 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 --request POST '/core/debit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "nuban": "0000000244",
    "paymentTypeId": 1,
    "amount": 5.50
}'

Responses

🟢200Success
application/json
Body
object {0}
Example
{
    "transactionID": 465,
    "nuban": "0000000244",
    "amount": 5.5,
    "paymentTypeId": 1
}
Modified at 2025-03-19 15:02:48
Previous
Payment Types
Next
Credit Account
Built with