Skip to main content
Delete a Wallet
curl --request DELETE \
  --url https://api.spherepay.co/v2/wallet/{id} \
  --header 'Authorization: Bearer <token>'
{
  "ok": true
}
Use this endpoint to permanently remove a registered wallet from SpherePay. Once deleted, the wallet ID can no longer be used in transfer requests. You cannot delete a wallet that is referenced as the source or destination of any active or pending transfer.
This action is irreversible. Ensure no active or pending transfers reference this wallet before deleting it.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

The wallet ID

Minimum string length: 1
Example:

"wallet_ce745ef7f3df4b9a8bff1301ce24b045"

Response

​
ok
boolean
required

Indicates whether the deletion was successful

Example:

true

Last modified on June 18, 2026