- Introduction
- Terminologies
- Webhooks
- Authentication
- Account
- Saving Account Guide
- Product ListGET
- Create AccountPOST
- Update AccountPUT
- Find ClientPOST
- AccountsGET
- Create Additional AccountPOST
- Account Details By BVNGET
- Get Client AddressesGET
- Get Account DetailsGET
- Get Account SummaryGET
- Client ImagesGET
- Update BVNPOST
- Update Transaction LimitPOST
- Client NotificationsPUT
- Get Savings ProductGET
- Get Account InterestGET
- Close Account And Move BalancePOST
- Activate Client AccountPOST
- Add Client AddressPOST
- Update Client AddressPUT
- Get Full Account DetailsGET
- Get Full Account Details By NUBANGET
- Upload Client PassportPOST
- Update NINPOST
- Create ClientPOST
- Get DirectorsGET
- Create DirectorsPOST
- Update DirectorsPUT
- Delete DirectorDELETE
- Get GendersGET
- Get SignatoriesGET
- Create SignatoriesPOST
- Delete SignatoryDELETE
- Get TemplateGET
- KYC
- Transaction
- Transfer
- Account Restrictions
- Loans
- Fixed Deposits
- Recurring Deposits
- Recurring Deposits
- List Recurring Deposit Products
- Get Recurring Deposit Product
- Preview Recurring Deposit Early Closure
- Close Recurring Deposit Early
- Open Recurring Deposit
- Get Recurring Deposit
- Pay Recurring Deposit Instalment
- Withdraw From Recurring Deposit
- Set Up Recurring Deposit Auto-Debit
- Cancel Recurring Deposit Auto-Debit
- Organisation
- Reporting
- Schemas
- Client
- Product
- ClientNotificationsRequest
- ClientNotificationsResponse
- ErrorDetail
- ErrorResponse
- ValidationErrorResponse
- LoanCustomer
- LoanApplicationRequest
- LoanApproveRequest
- LoanRejectRequest
- LoanWithdrawRequest
- LoanNoteRequest
- LoanAssignOfficerRequest
- LoanUnassignOfficerRequest
- LoanDisburseRequest
- LoanTransactionRequest
- LoanAdjustTransactionRequest
- LoanDateNoteRequest
- LoanPassthroughRequest
- LoanRescheduleRequest
- LoanRescheduleApproveRequest
- LoanRescheduleRejectRequest
- LoanCommandResult
- Loan
- LoanSummary
- LoanTransaction
- LoanRescheduleRequestData
- LoanSchedule
- LoanTemplate
- FixedDepositOpenRequest
- MaturityInstructionRequest
- DepositClosureRequest
- RecurringDepositOpenRequest
- RecurringAmountRequest
- AutoDebitRequest
- SavingsCloseRequest
Close Account And Move Balance
POST
/core/account/{nuban}/close
Request Body#
| Field Name | Type | Required | Description |
|---|---|---|---|
mainNuban | string | TRUE | NUBAN of the account that receives the balance. |
reference | string | TRUE | Your own unique reference for the request. |
closedOnDate | string | FALSE | Format yyyy-MM-dd. Defaults to today. |
Request
Authorization
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers，whose value is to concatenate the Token after the Bearer.Example:
Authorization: Bearer ********************Token URL: {{tpGatewayHostUrl}}/security/authenticate
or
Path Params
Body Params application/json
Example
{
"mainNuban": "0000000206",
"reference": "CLOSE-0001"
}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/0000000300/close' \
--header 'Content-Type: application/json' \
--data '{
"mainNuban": "0000000206",
"reference": "CLOSE-0001"
}'Responses
🟢200Closed
application/json
Bodyapplication/json
Example
{
"officeId": 1,
"clientId": 42,
"savingsId": 300,
"resourceId": 300
}🟠400Validation failed
🟠401The merchant's account has not been granted this operation,
🟠403Not allowed
🟠404Not found
🔴500The request could not be completed
Modified at 2026-11-10 06:20:21