Authorize using an active token and exact signed cryptogram verification
/cards/wallets/authorizationsRequires the same verified processor identity and signing key. Receipt action authorize, verification cryptogram_verified, and SHA256 of wallets.Transaction must bind the exact USD contactless/ecommerce terms, enrolled token, requestor, device and current lifecycle sequence. Suspended/deleted tokens cannot create a new hold or facility reservation. Authoritative already-committed debit holds can recover through later revocation under their original reference; existing completed authorization replay remains available. Token increments and force presentment without original authorization are explicitly unsupported. Network token issuance, HSM cryptogram verification and scheme certification remain processor integration responsibilities.
Headers
Idempotency-KeystringOptionalSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
receiptobjectRequired2 child attributes
payloadobjectRequiredPayload is the versioned, domain-separated processor receipt. SigningBytes is normative: typed JSON in this field order with the timestamp normalized to UTC. Activate requires issuer_identity_verified; authorize requires cryptogram_verified.
15 child attributes
actionstringRequireddevice_sha256stringRequiredevent_referencestringRequiredevidence_referencestringRequiredevidence_sha256stringRequiredissued_atstring · date-timeRequiredkey_idstringRequirednetworkstringRequirednetwork_token_referencestringRequiredrequestor_idstringRequiredsequenceintegerRequiredtoken_idstringRequiredtransaction_sha256stringOptionalverificationstringOptionalversionstringRequiredsignaturestringRequiredStandard base64 Ed25519 signature
transactionobjectRequired12 child attributes
amountintegerRequiredchannelstringRequiredcountrystringRequiredcurrency_codestringRequiredmccstringRequiredmerchant_idstringOptionalmerchant_locationstringOptionalmerchant_namestringRequiredmerchant_postal_codestringOptionalmerchant_regionstringOptionalnetwork_refstringRequiredpartial_approval_allowedbooleanOptionalReturns
200 OK
approved_amountintegerOptionalA partial approval (response 10) or an increment
authorization_idstringRequiredExample auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm
decisionstringRequiredreasonstringRequiredreplayedbooleanRequiredresponse_codestringRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503