O1o11

Prepare a US/USD purchase within this card's existing permissions and spending limits. Amounts are integer USD cents. Card issuing is stubbed: no order or payment is submitted. Returns a durable purchase ID; poll get_purchase, never create another purchase to poll.

post/v1/purchase

Request

  • Base URL
    http://localhost:5100
  • URL
    http://localhost:5100/v1/purchase
  • Auth
    HTTP bearer

Request body

idempotencyKeystring required
urlstring uri required
itemstring required
quantityinteger
optionsobject
maxTotalMinorstring required
currency'USD'
country'US'
profileIdstring uuid
cardIdstring uuid

Card to use. Required when this connection has multiple cards. List cards first.

Response

Operation result. An invocation may still be pending; inspect its state.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.