Skip to main content
DELETE
Delete wallet

Authorizations

API-KEY
string
header
required

Your partner API key.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. Required on every /api/v0/* call. Format YYYY-MM.<release>; 2026-09.1 is the latest. The version that served the request is echoed back on the response. Missing, malformed or unsupported values are rejected with 400.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

userId
string
required

Customer reference id, format cus_<20 chars> — never an internal UUID. Must belong to the authenticated partner.

walletId
string
required

Wallet reference id, format wlt_<20 chars>. Must belong to the customer named in the path.

Response

Soft-deleted. The response is 200 with a body — not an empty 204. The wallet stops appearing in List wallets and Get wallet answers 404 ERRWLT_1000, though it still exists on-chain at the same address.

walletId
string

The deleted wallet (wlt_…).

status
enum<string>
Available options:
deleted