Debit Customer Account

Processes customer account to GL transaction. This debits funds from the specified customer account and credits a corresponding GL associated with the GL code specified.

TSQ Interval Time: 60 seconds

TransactionType: DEBIT

To debit a customer account, you make a post request by passing RetrievalReference, AccountNumber, NibssCode, Amount and some other required payload in the request body to the debit endpoint.

Here is an example of a full request body payload and a sample response.

// Live URL
http://api.mybankone.com/thirdpartyapiservice/apiservice/
CoreTransactions/Debit

POST https://staging.mybankone.com/thirdpartyapiservice/apiservice/ CoreTransactions/Debit

Request Body

Name
Type
Description

RetrievalReference*

String

Initial transaction unique reference

AccountNumber*

String

Account number to be credited

NibssCode *

String

6-digit institution BankOne code

Amount *

String

Transaction Amount in kobo

Fee

String

Fee in kobo

Narration *

String

Transaction Narration

Token*

String

Authentication Key for the request

GLCode

String

Identifies the GL account to be impacted

{
    "IsSuccessful": true,
 "ResponseMessage": "Approved by Financial Institution",
 "ResponseCode": "00",
 "Reference": "A1612187583"
}

Last updated