Skip to main content
DELETE
Revoke payment method
This account-scoped mutation requires a user-authorized human:actions OAuth grant. First list the saved item, review its current metadata, then send its Darwin ID with an If-Match header containing the listed revision in double quotes. A stale revision fails with 409; fetch the list again before retrying. No provider secret or payment details belong in this request. Revocation prevents future selection by Darwin but cannot undo a dispatched action or payment. This operation remains release-gated until account ownership migration and live provider verification are complete.

Authorizations

Authorization
string
header
required

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

Headers

If-Match
string
required
Pattern: ^"[0-9]+"$

Path Parameters

methodId
string
required
Required string length: 1 - 200

Response

Authorized account metadata only.

paymentMethodId
string
required
Required string length: 1 - 200
Pattern: ^[A-Za-z0-9_-]+$
label
string
required
Required string length: 1 - 100
method
enum<string>
required
Available options:
card,
bank,
hosted_checkout,
darwin_wallet,
mpp,
x402,
ucp,
acp
status
enum<string>
required
Available options:
active,
revoked,
expired
isDefault
boolean
required
revision
integer
required
Required range: 0 <= x <= 9007199254740991
expiresAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Last modified on October 5, 2026