Checkout

Manage checkouts. Use action=“create_order” to create a pending sale_order with lines. Use action=“create_payment_link” to generate a Stripe Checkout URL for a pending order. Share this URL with the buyer so they can pay. Use action=“get_order” to check the status of an order (e.g. to see if it became “completed” via webhook).

Input Schema

Parameter	Type	Description
action	string	Action to perform: create_order, create_payment_link, get_order
site_id	string	Seller site UUID (defaults to current site)
buyer_user_id	string	Buyer user UUID (required for digital assets/subscriptions)
customer_email	string	Customer email — resolves/creates lead and used for Stripe
lead_id	string	Lead UUID to attach to the sale
owner_site_id	string	Owner site UUID (for B2B destination)
source	string	Source of the order: quote, marketplace, shop, sales
lines	string	JSON string of order lines. Each line needs: `catalogItemId`, `quantity`. For reservable items, include `reservationStart` and `reservationEnd` (ISO datetimes).
order_id	string	Order UUID (required for create_payment_link, get_order)
return_url	string	Optional URL to redirect buyer after payment (defaults to commerce app `/buyer/orders`)

Note: Stripe payment completion and entitlement grants are handled by the commerce (market-fit) Stripe webhook when metadata.type = sale_order. This tool only creates pending orders and payment URLs.

Example


{
  "action": "create_payment_link",
  "order_id": "ORDER_ID"
}