fulfillment_order
Place a manufacturing order from a previous quote. Charges an orchestration fee upfront to prevent unpaid orders, with automatic refund if placement fails.
Instructions
Place a manufacturing order based on a previous quote.
Charges the orchestration fee BEFORE placing the order to prevent
unpaid orders. If order placement fails after payment, the
charge is automatically refunded.
Args:
quote_id: Quote ID from ``fulfillment_quote``.
shipping_option_id: Shipping option ID from the quote's
``shipping_options`` list.
shipping_address: Optional shipping contact/address dict for
provider checkout. Keys: ``first_name``, ``last_name``,
``email``, ``phone``, ``street``, ``city``,
``postal_code``, ``country``; include ``state`` for US.
shipping_profile_name: Saved shipping profile name to use
instead of passing ``shipping_address``.
preview_token: Token from ``issue_preview_token`` after the
rendered model preview was shown to and approved by the user.
preview_file_path: Exact model file path that was previewed.
The preview token is validated against this file's bytes.
shipping_confirmation_token: Token from
``issue_shipping_confirmation_token`` after the contact and
shipping address were shown to and approved by the user.
payment_hold_id: PaymentIntent ID from the quote's
``payment_hold`` field. If provided, the previously
authorized hold is captured before placing the order.
This is the preferred payment flow.
quoted_price: Total price returned by ``fulfillment_quote``
(used to calculate the fee when no ``payment_hold_id``
is provided). Required when ``payment_hold_id`` is
empty and a payment rail is configured.
quoted_currency: Currency of ``quoted_price`` (default USD).
jurisdiction: Buyer's region (e.g. ``"US-CA"``, ``"DE"``, ``"AU"``).
When provided, the response includes an accurate total with
tax so the user sees exactly what they'll pay — no hidden
fees. Use ``tax_jurisdictions`` to see all supported codes.
business_tax_id: If the buyer is a registered business, their
tax ID (EU VAT number, AU ABN, etc.). Businesses in the
EU, UK, Australia, and Japan are tax-exempt via reverse
charge — the tax line shows $0.00.
Use ``fulfillment_order_status`` to track progress after placing.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quote_id | Yes | ||
| jurisdiction | No | ||
| quoted_price | No | ||
| preview_token | No | ||
| business_tax_id | No | ||
| payment_hold_id | No | ||
| quoted_currency | No | USD | |
| shipping_address | No | ||
| preview_file_path | No | ||
| shipping_option_id | No | ||
| shipping_profile_name | No | ||
| shipping_confirmation_token | No |