Corgi BankDocumentation
OpenAPI

Authorize using an active token and exact signed cryptogram verification

POST/cards/wallets/authorizations

Requires 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-KeystringOptional

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

receiptobjectRequired
2 child attributes
payloadobjectRequired

Payload 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
actionstringRequired
device_sha256stringRequired
event_referencestringRequired
evidence_referencestringRequired
evidence_sha256stringRequired
issued_atstring · date-timeRequired
key_idstringRequired
networkstringRequired
network_token_referencestringRequired
requestor_idstringRequired
sequenceintegerRequired
token_idstringRequired
transaction_sha256stringOptional
verificationstringOptional
versionstringRequired
signaturestringRequired

Standard base64 Ed25519 signature

transactionobjectRequired
12 child attributes
amountintegerRequired
channelstringRequired
countrystringRequired
currency_codestringRequired
mccstringRequired
merchant_idstringOptional
merchant_locationstringOptional
merchant_namestringRequired
merchant_postal_codestringOptional
merchant_regionstringOptional
network_refstringRequired
partial_approval_allowedbooleanOptional

Returns

200 OK

approved_amountintegerOptional

A partial approval (response 10) or an increment

authorization_idstringRequired

Example auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decisionstringRequired
reasonstringRequired
replayedbooleanRequired
response_codestringRequired

Errors

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

400401403404409412413422424429500503

to move to open esc to close