Suspend, resume or permanently disable a wallet token in core

POST/cards/wallets/tokens/{id}/controls

Fresh verified holder may suspend, resume or delete using the exact current local sequence. Fresh cards staff may permanently delete only. Core deletion is terminal and immediate; an outbox instruction requests external lifecycle handling but does not assert network deletion. Network resume cannot lift a local suspension.

Path parameters

idstringRequired

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

actionstringRequired

Suspend, resume, delete; delete is terminal in core

expected_sequenceintegerRequired

reasonstringRequired

Returns

200 OK

actorstringRequired

atstring · date-timeRequired

requestobjectRequired

3 child attributes

actionstringRequired

Suspend, resume, delete; delete is terminal in core

expected_sequenceintegerRequired

reasonstringRequired

resultobjectRequired

15 child attributes

consent_device_sha256stringRequired

consent_session_sha256stringRequired

consent_step_up_atstring · date-timeRequired

consented_atstring · date-timeRequired

consented_bystringRequired

effective_statusstringRequired

enrollmentobjectRequired

5 child attributes

card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

device_sha256stringRequired

Opaque device binding digest, not raw device identifiers

requestor_idstringRequired

terms_sha256stringRequired

terms_versionstringRequired

holder_customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

idstringRequired

local_sequenceintegerRequired

local_statusstringRequired

networkstringRequired

network_sequenceintegerRequired

network_statusstringRequired

network_token_referencestringOptional

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503