Inactive

Inactive

POST {{Environment_URL}}/mass-payments/v1/accounts/:id

By using this endpoint, the specified sub-account will be permanently deactivated and unlinked from your Main Account.

The process includes a crucial asynchronous step: any remaining balance in the sub-account will be automatically transferred back to the Main Account.

WARNING: This action is irreversible. Once this route is executed, the deactivation and balance transfer cannot be undone.

Headers

Name	Value
Authorization	Bearer <token>

Query Parameter

Name	Data Type	Description	Value
id	Number	Subaccount Identifier	acc_01K97P082A1

Response

200 - OK

{
  "message": "Account inactivated successfully",
  "id": "acc-01...",
  "status": "INACTIVE"
}