TidePay
Wallets

Delete a wallet

DELETE
/wallets/{walletId}

Only succeeds while this row has no address registered yet. Once an address is set, it cannot be deleted — a wallet with a real destination falls back to any OTHER wallet you have registered for a different token before it ever falls back to an offer's own merchantDestinationWallet, so removing it would silently redirect payouts rather than reverting to something safe. To change where a token settles, register a different address on this same row instead (POST /v1/wallets, an upsert) — that fires a wallet.updated security notification and never leaves a gap where money is misdirected.

X-API-Key<token>

Your merchant API key, shown once at creation in the dashboard (Settings → API key).

In: header

Path Parameters

walletId*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/wallets/string"
{  "id": "string",  "deleted": true}