Paycose Docs
Service Account
DELETE/service_accounts/{service_account_id}

Delete Service Accounts

Soft-delete a service account.

Lifecycle is packed with the SA: best-effort AdminDeleteClient against Hydra (revoking the OAuth2 client_credentials registration) before the DB soft-delete. A Hydra-side failure does NOT block the SA delete — the orphan Hydra client is recoverable by a periodic reaper job, while a half-deleted SA in the wallet DB would be operationally worse.

Requires: Bearer token, X-Country header, AAL2. In live mode this also requires the application to be KYB verified.

Request

Example

curl -X DELETE 'https://api.paycose.com/api/v1/app1/platform/wallet/service_accounts/{{service_account_id}}' \
  -H 'X-Session-Token: {{session_token}}' \
  -H 'X-Country: {{country}}' \
  -H 'X-Test-Mode: {{x_test_mode}}'

Headers

NameValueDescription
X-Session-Token{{session_token}}
X-Country{{country}}
X-Test-Mode{{x_test_mode}}true=wallet_test, false=wallet_live (default). Toggle the x_test_mode collection variable to flip every applicable request.

Responses

200200 OK

Headers

NameValue
Content-Typeapplication/json

Body

{
  "message": "<string>"
}
400400 Bad Request

Headers

NameValue
Content-Typeapplication/json

Body

{
  "object": "error",
  "code": "<string>",
  "key": "<string>",
  "i18n_key": "<string>",
  "message": "<string>",
  "request_id": "<string>"
}
500500 Internal Server Error

Headers

NameValue
Content-Typeapplication/json

Body

{
  "object": "error",
  "code": "<string>",
  "key": "<string>",
  "i18n_key": "<string>",
  "message": "<string>",
  "request_id": "<string>"
}

On this page