Deallocating a reserved account

You can delete a reserved account by initiating a DELETE request to the endpoint below. Once the request is made, then the account will immediately be deallocated.

Please note this action cannot be reversed!!

This endpoint is protected with OAuth 2.0 Bearer token. To find out more about authorization for Monnify endpoints, check Here

Endpoint URL: {{base_url}}/api/v1/bank-transfer/reserved-accounts/reference/{accountReference}

HTTP Method: DELETE

The {{base_url}} for test is https://sandbox.monnify.com but when you go live, it changes to the live url

Deallocate Account Request

Request Headers
Authorization:"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"


Request URL
DELETE https://sandbox.monnify.com/api/v1/bank-transfer/reserved-accounts/reference/9900725554

Deallocate Account Response

{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "797854529434",
        "accountReference": "reference12345#",
        "accountName": "Test Reserved Account",
        "currencyCode": "NGN",
        "customerEmail": "test@tester.com",
        "accountNumber": "9900725554",
        "bankName": "Providus Bank",
        "bankCode": "101",
        "reservationReference": "NRF72EMEBCGNN6WUKD35",
        "status": "ACTIVE",
        "createdOn": "2019-08-07 17:05:50.0"
    }
}

Field Reference

^(M)indicates fields that are mandatory in the request body. ^(m) Indicates fields that are mandatory only if the parent object is not empty.

Field	Description

Field	Description
accountReference	Your unique reference used to identify this reserved account
accountName	The name you want to be attached to the reserved account. This will be displayed during name enquiry
currencyCode	Currency for transactions to this reserved account. Should be “NGN”
contractCode	Contract Code (See your Monnify dashboard)
customerEmail	Email address of the customer who the account is being reserved for. This is the unique identifier for each customer.
customerName	Full name of the customer who the account is being reserved for
customerBvn	BVN of the customer the account is being reserved for. Please note that if BVN is not supplied there will be low limits on the reserved account.
incomeSplitConfig	Object containing specifications on how payments to this reserve account should be split.
subAccountCode	The unique reference for the sub account that should receive the split.
feeBearer	Boolean to determine if the sub account should bear transaction fees or not
feePercentage	The percentage of the transaction fee to be borne by the sub account
splitPercentage	The percentage of the amount paid to be split into the sub account.
bankName	Name of the bank where the virtual account was created
bankCode	Bank code of the bank where the virtual account was created
accountNumber ^(M)	virtual account number generated for the accountReference (Reserved account number)
status	Status of the reserved account number ("ACTIVE" means the account can be used)
createdOn	Date and time reserved account was created

Deallocate Account Request

Deallocate Account Response

Field Reference

Related Articles