> For the complete index of the 402pay docs, see [llms.txt](https://developer.402pay.co/llms.txt).

# Delete the wallet

Remove your wallet, right away during setup or after a 24-hour hold once you've been paid.

`DELETE https://dash.402pay.co/api/v1/wallet`

Removes your wallet, so checkout has nowhere to send payments until you add a new one. It takes a person signed in to the dashboard who confirmed their password or a passkey in the last 15 minutes, never an API key. Funds stay at the wallet's addresses on-chain, and its recovery phrase still controls them.

Once your business has received a payment (one collected as fees, or a referral payout, counts too), the deletion waits 24 hours: the answer is 202 with the pending change, and the wallet keeps receiving payments until `effective_at`. We email the owner a link that cancels it, which works without signing in, and [canceling it](https://developer.402pay.co/api/wallet/changes/cancel.md) from the dashboard works too. `GET /wallet` shows it as `pending_change` until then. A business still being set up loses its wallet right away, with 200.

Changing the wallet's encryption password isn't held: the phrase and its addresses stay the same.

### Errors

- 403 `session_required` An API key sent the request. Only a person signed in to the dashboard can send.
- 403 `step_up_required` The session hasn't proven its password or a passkey in the last 15 minutes. Confirm it at `POST /sessions/current/step-up` and send the request again.
- 404 `not_found` Your business has no wallet yet.
- 409 `wallet_change_pending` The wallet is already set to be deleted. Cancel the deletion first, or wait for it.

Any request can also fail on its key or its body. See [errors](https://developer.402pay.co/api/errors.md).

Request, Browser:

```js
// On a dashboard page, whose session cookie the browser sends.
const response = await fetch("/api/v1/wallet", {
  method: "DELETE",
  headers: {
    "402pay-Business": businessId,
  },
});
const { data } = await response.json();
```

Response, 202 Accepted:

```json
{
  "data": {
    "id": "wcr_7QmVx2LpT9sKd4Rz",
    "kind": "wallet_change",
    "change": "delete",
    "status": "pending",
    "wallet_id": "wal_1fIGZOrILmsCO0jw",
    "effective_at": "2026-09-29T14:05:09.123Z",
    "canceled_at": null,
    "created_at": "2026-09-28T14:05:09.123Z"
  }
}
```

Response, 200 OK:

```json
{
  "data": {
    "id": "wal_1fIGZOrILmsCO0jw",
    "kind": "wallet",
    "deleted": true
  }
}
```