Remove a saved card

Permanently removes a stored payment method. The PSP detach API is called first; only if that succeeds is the record hard-deleted. If the PSP call fails the record is left intact and an error is returned — there is no orphaned local delete.

Backs the Edit Payment Methods screen in both the browser widget and the mobile SDK. The widget token is not consumed and remains usable for the checkout that follows.

FieldTypeRequiredDescription
widget_tokenstringYesActive widget token for the checkout session. The customer email and merchant are resolved from it, and the saved method must belong to that pair. Merchant auth headers are not required.

Never let this fail a payment. A card-management error is a management error: surface it inline on the manage screen and leave the checkout intact. Both the widget and the mobile SDK treat it as non-fatal.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
string
required
length ≥ 1
Responses
204

No Content

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json