Checkout and payment

This page covers everything between the cart and a paid order: how the price is recalculated the moment before you are charged, what a gift card or discount does to the total, and when the money actually leaves your card. Prints are sold by weight, so the number in your cart is not final until the model has been through the slicer.

What you are charged for#

A cart total is goods and shipping, plus four charges that appear only when they apply: the second-AMS fee on a print using five or more colours, the new-filament fee for a colour or filament we buy in for you, Priority print if you choose it, and support removal if you choose it. Any discount comes off after that. There is no handling fee and no tax line.

The cart re-prices before it charges#

A print's price is written into your browser when you add it. That number can go stale — an older price sheet, or a quote made from the volume estimate before the slicer had weighed the model. Opening the cart posts your print items back for a fresh quote.

The response carries prices, keyed by cart item id, and measuring, a list of ids whose price is still a volume estimate. While measuring is not empty the Checkout button stays disabled and reads Weighing your print. A project ordered in its own colours whose colour slice is still running is in measuring too. unpriceable lists items that will never be measured, with the reason, such as a project whose colours turned out not to be printable; and secondAmsFees gives the $25 second-AMS fee, keyed by item id, for each print using five or more colours. It is capped at 60 requests an hour per account, and the first 40 items in the cart.

A print that can never be measured is refused with 422 and the reason instead, and a colour order is never swapped for a single-colour one: if a project's colours cannot be printed, the item has to be removed and added again in one colour. A print using five or more colours adds the $25 second-AMS fee as its own Stripe line, once for that cart line however many copies it holds. The fee is not goods, so the first-order discount and promo codes are not taken off it and it does not count toward free shipping, but a gift card can settle it like postage.

One limit worth knowing: the cart quotes each print as a single unit, so the 5-unit and 10-unit bulk tiers are not applied through the cart. They do apply on the Print and Ship button on /print and on API orders, where the quantity reaches the quote.

Normal or Priority print#

Beside the shipping choice, checkout asks how soon the order is printed. The two choices add up: the print speed is how long until the parcel leaves Austin, and the shipping speed is how long it then spends with the carrier.

• It is offered on /print, in the design studio's Print & Ship, and in the cart whenever the cart holds at least one print. Store products are picked off the shelf, so a cart of store products alone, or Buy Now on a product page, has no print speed and is never charged for one.
• Once per order: a cart with three prints and a desk clock pays it once, worked on all four items together.
• Priority print puts the order's prints first in the farm's queue. That is the half of the wait it changes; express shipping changes the other half.
• No discount is taken off it: the first-order discount, X3DMEMBER and a Pro plan's 10% are all worked out without it. It does not count toward free shipping either. A gift card or print credit can pay it, like postage.
• In the cart it is a line of its own at Stripe, named Priority print. Print & Ship folds it into the order's one Stripe line.
• The confirmation email names the print speed you chose, and your order on /orders and its stage emails list Priority print as a row of its own.
• Print API and MCP orders have no print speed to choose and are printed at Normal.

Paying#

Checkout hands off to Stripe Checkout as a one-off payment. Card details are entered on Stripe's page and never reach X3D. Your account email is prefilled, and the delivery address is collected there rather than in the cart.

Choose United States or International before checking out: in the cart, on Print & Ship, and on Buy Now for a single store product. That choice sets both the shipping rate and which countries Stripe will accept an address in: US only for domestic, and AE, AT, AU, BE, CA, CH, DE, DK, ES, FI, FR, GB, IE, IN, IT, JP, MX, NL, NO, NZ, PT, SE, SG for international.

The session does not pin a list of payment methods, so what you are offered on that page comes from Stripe, not from us. A card always works. A gift card is not a payment method here — it is applied as a discount on the session before Stripe asks for anything, which is also how an order fully covered by one can complete at $0.

Discounts, gift cards and promo codes#

First order#

A first order takes 10% off. It is applied as a fixed amount worked out from goods only, so it never comes off postage — a percentage coupon used to take 10% off the shipping line too, which is how the cart once said $10.40 while Stripe charged $9.90. Eligibility is checked on the server: no orders on the account, and no paid plan. If that check errors, the discount is withheld rather than guessed at.

Gift cards#

Enter the code in the cart and press Apply. It is validated before it shows as applied, so a bad code fails there rather than after you have committed to a checkout.

A good card returns valid: true, the tidied-up code, and availableCents — the spendable balance, not the face value, which differ once part of it has been spent. An unknown code, a voided card and an empty card all answer with the same 404, so guessing gets no signal. You get 20 checks an hour.

At checkout the balance is held, not spent. The hold is taken against what is owed after the percentage discount, and only turned into a deduction when Stripe confirms the payment — an abandoned cart never quietly eats somebody's present. If the checkout session fails to open, the hold is released immediately. A card that covers the whole bill leaves nothing to pay; Stripe still collects your delivery address and completes the order at $0.

Promo codes#

X3DMEMBER takes 5% off, once per account. It is printed on the thank-you card in every parcel, so it is a code for your next order rather than your first. Type it into the cart and press Apply: it is checked against your account before it shows as applied, and the summary total moves straight away, so what the cart says is what Stripe is asked for.

Like the first-order discount, the 5% is worked out from goods only and never comes off postage. Checking a code never consumes it — the one use is only held when you start a checkout, and only spent when Stripe confirms the payment, so a cart you abandon gives the code back. You get 20 checks an hour.

Any other code is looked up in Stripe. If it does not match an active code, checkout continues at full price rather than failing. With no code entered, Stripe’s own promotion-code box is enabled on the payment page instead. Both only happen when the session’s single discount slot is free: a gift card or one of our own discounts claims it first.

When your card is charged#

1. 1
   You press Checkout

   The cart is re-quoted on the server, a gift card hold is taken if you entered a code, and a work order listing every file and print setting is written for the farm. Nothing has been charged yet.

2. 2
   Stripe takes the payment

   You are sent to Stripe Checkout. The charge happens when you confirm it there — not when you added to the cart, and not when you pressed Checkout.

3. 3
   The webhook creates the order

   Stripe calls back. This is when the order gets its number, such as 2610019: only a paid order is numbered, so a checkout nobody pays for never takes one and the numbers run without gaps. The order record is written at stage placed, any gift card hold is spent, and the confirmation emails go out. This step is idempotent, so a retried webhook cannot create a second order, a second number or a second email.

4. 4
   You land back on /orders

   The success redirect is /orders?checkout=success with the session id attached. The page asks the server to confirm the payment status; that probe is read-only and creates nothing.

What the receipt contains#

• A confirmation email from [email protected], subject Order confirmed - #<order number>, listing the order number, the items, the total charged, the print speed, the delivery service with its transit estimate, and the shipping address.
• Stripe's own receipt for the charge, linked as Receipt beside the payment under Payment History on /orders, whenever Stripe issued one.
• For several orders at once, the Statement / invoice link on /orders builds one statement for a date range, which you can download as a PDF. See /docs/studio/orders.

The customer copy is a plain summary. Signed download links for the model files go only to the operator copy of the email, since you already hold your own files.

Checkouts that skip the cart#

A payment link can be paid once. It does not expire: each press of Pay reopens the checkout already started for it, or starts a fresh one, so an old email still works. We can cancel a link before it is paid, and the page then says so; reply to the email it came in for a new one. Paying it is what creates the order, numbered like any other, with the same confirmation and the same email at every stage.

Print and Ship refuses an unweighed model exactly as the cart does, with the same 409. A store product has nothing to weigh, so it never hits that gate. Either way the order is written only once Stripe confirms the checkout, including a $0 checkout that print credit paid in full, and all of them appear on /orders — a single store product redirects you back to /store rather than to the order list, but its order is filed alongside the rest. A payment-link order is filed under the email address we made the link for, so sign in with that address to see it.

API orders are charged at submission#

The developer API works the other way round. There is no checkout page and no cart: the order is submitted and the card saved on your account is charged in the same request.

curl -X POST https://x3dstudios.com/api/print/orders \
  -H "Authorization: Bearer $X3D_API_KEY" \
  -F "[email protected]" \
  -F "recipientName=Ada Lovelace" \
  -F "street1=13359 N Highway 183" \
  -F "city=Austin" \
  -F "state=TX" \
  -F "zip=78750" \
  -F "material=pla" \
  -F "color=Black" \
  -F "quantity=2"

A successful charge returns 201 with status RECEIVED, paid true, and charged set to the amount taken. If the card is declined you still get 201 and a real order, but at status PENDING_PAYMENT with a paymentUrl you can send someone to. This is why minting an API key requires a card on file in the first place — and why an order below $0.50 is refused outright. An API order has no print speed to choose and is printed at Normal.