Create an order + hosted payment link

post/v1/checkout

Request

  • Base URL: https://agenticfabricationnetwork.ai
  • URL: https://agenticfabricationnetwork.ai/v1/checkout
  • Auth: HTTP bearer

Request body

offer_idstring required
shipping_option_idstring required
return_urlstring uri

Optional — the page the buyer is on when checkout starts. The post-payment landing pages show a 'Return to <site>' button pointing here. http(s) only; pass a URL the client actually knows, never an invented one.

coupon_codestring

Optional coupon code (early-adopter codes from the AFN team; case-insensitive). Validated before any order exists — unknown, deactivated, or fully-redeemed codes refuse with a 400 and no money moves. The discount shows on the hosted payment page; a 100%-off code makes the total $0 and no card is collected.

Response

Order created; give checkout_url to the user

order_idstring
checkout_urlstring uri
total_centsinteger

What the buyer pays; 0 when a 100%-off coupon covered the order

currency'usd'
discount_centsinteger

Present when a coupon applied: cents knocked off the total

coupon_codestring

The redeemed coupon code, normalized uppercase

price_basis'estimate_pending_verification'

Present when the total is a cached estimate. The quote is a price ceiling: the checkout page confirms the vendor's live price, which can only match the quote or come in lower. If the vendor repriced upward the order expires unpaid — just re-quote. Agents need no special handling.

Changes

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