Skip to main content
Buy-specific behavior on top of quote-then-execute. Quotes expire in 60 seconds. Pass the quote total as expectedTotal so the live charge cannot go up.
Quotes and execute require stytch_admin. Payment methods require stytch_member. See Authentication.

​
Items

Each item is a listing id and quantity. Up to 50 items; listing ids must be unique.
paymentMethod is required on create so fees match execute. Use wire_transfer or a Stripe pm_ / ba_ id. Refresh the same cart with GET /execution/v2/buy/quotes/:quoteId. Repeat selectedOptionalIds as query params (?selectedOptionalIds=vault_shipping).

​
Payment methods

Pass the Stripe id, not the stripe / stripe_ach type label. If Stripe onboarding is incomplete, this returns 422 (stripe_customer_not_configured).

​
Vault shipping and execute

Select vault_shipping via selectedOptionalIds. When it is selected and eligible, omit shipping on execute — fulfillment goes to your vault and standard shipping is waived. Eligibility: Optionals.
sweep: true keeps filling leftover size after a partial fill. promotionCode applies at execute; preview first on POST .../promotion-preview.

​
After execute

orderId from execute is a sale order (GET /orders/get-sale-orders/v1). That is Pure selling to you.

​
Endpoints

Errors: Execution errors. Sandbox: Sandbox.