Skip to content
Docs

Cancel a wallet change

Open in ChatGPT

Stop a wallet deletion while it's still waiting out the hold.

Stops a deletion that's waiting out its hold, so your wallet stays and payments keep going to it. It takes a person signed in to the dashboard, but no step-up, since nothing about where payments go changes. Canceling one that's already canceled returns it as it is.

Path

  • id string Required
    The wallet change's ID, such as wcr_7QmVx2LpT9sKd4Rz.

Errors

  • 403 session_required
    An API key sent the request. Only a person signed in to the dashboard can send.
  • 404 not_found
    No wallet change of your business has that ID.
  • 409 wallet_change_applied
    The hold is over and the change took effect, so there's nothing to cancel.

Any request can also fail on its key or its body. See errors.

RequestBrowser
// On a dashboard page, whose session cookie the browser sends with credentials.
const response = await fetch("https://wallet.402pay.co/api/v1/wallet/changes/wcr_7QmVx2LpT9sKd4Rz/cancel", {
  method: "POST",
  credentials: "include",
  headers: {
    "402pay-Business": businessId,
  },
});
const { data } = await response.json();
Response200 OK
{
  "data": {
    "id": "wcr_7QmVx2LpT9sKd4Rz",
    "kind": "wallet_change",
    "change": "delete",
    "status": "canceled",
    "wallet_id": "wal_1fIGZOrILmsCO0jw",
    "effective_at": "2026-09-29T14:05:09.123Z",
    "canceled_at": "2026-09-28T16:41:37.502Z",
    "created_at": "2026-09-28T14:05:09.123Z"
  }
}