Corgi BankDocumentation
OpenAPI

Simulate a merchant purchase on a card

POST/simulate/cards/purchase

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

amountintegerRequired
card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

channelstringRequired

Pos, ecommerce, atm, contactless

countrystringRequired
currency_codestringRequired
mccstringRequired
merchant_idstringOptional
merchant_namestringRequired
network_refstringOptional

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