Close Account

Permanently closes an account. The balance must be zero.

POST/v1/accounts/{id}/close

⚠️

Account closure is irreversible. Any attached cards will be cancelled.

Request

curl -X POST https://api.vaultspay.ae/v1/accounts/acc_01HX7.../close \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

200 OK

{
  "id": "acc_01HX71YM6FJ3A8W7T5K6NRB2DN",
  "object": "account",
  "status": "closed",
  "closed_at": "2026-04-24T14:52:03Z"
}

HTTP	Code	Description
409	`non_zero_balance`	Transfer out the remaining balance first.
409	`active_authorisations`	Wait for pending card authorisations to clear.