Create the order from a quote and start payment (idempotent per quote_id)

post/v1/orders

Request

  • Base URL: https://pod.agentmade.dev
  • URL: https://pod.agentmade.dev/v1/orders
  • Auth: none declared

Request body

quote_idstring

quote_id returned by quote, for one parcel. Set quote_id or orders, not both.

contact_emailstring email

Email of the payer, for the order confirmation and the payment receipt. Not the recipient's email: for a gift, the recipient must not see the price. Optional.

payment_capabilitiesstring[]

Payment methods the calling agent can use. "hosted_checkout" = a link that the person opens to pay by card, Apple Pay or Google Pay. Always supported.

gift_messagestring

Short message for the packing slip of a gift. Not printed yet: the answer says so.

rights_attestationtrue required

Must be true: confirms the customer owns or is licensed to print all submitted artwork, and that it is not prohibited content.

Response

Order with payment URL

order_idstring required

A bearer key: whoever has it can read and cancel the order. Do not share it publicly.

status'AWAITING_PAYMENT' | 'PAID' | 'VALIDATING' | 'SUBMITTING' | 'SUBMITTED' | 'IN_PRODUCTION' | 'SHIPPED' | 'DELIVERED' | 'QUOTE_EXPIRED' | 'PAYMENT_FAILED' | 'REJECTED' | 'SUBMISSION_FAILED' | 'CANCELLED' | 'REFUND_PENDING' | 'REFUNDED' | 'DISPUTED' required
next_stepstring required

What the agent should do next, in plain language.

address_neededboolean required

True when purchase had no street address: the person enters it on the order page before paying.

status_reasonstring nullable required
quote_idstring required
order_urlstring required

The order page. The person sees the status there.

notesstring[] required

Changes

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