quantity: 1 needs dropshipping. Without it, checkouts/create returns 412 PRECONDITION_FAILED.
Dropshipping costs credits. The cost is charged for each line with quantity: 1, or once for an order that has none. It is free when your paid plan includes dropshipping.
Such a plan also lets you order a single unit without dropShip. Still send "dropShip": true if you want your brand on the receipt.
Create a dropshipping checkout
1
Get a quote
Call
checkouts/quoteDropshipping to see the current cost.cURL
The checkout is charged
creditCost for each line with quantity: 1, or once if it has none.2
Create the checkout
Call The request returns
checkouts/create with "dropShip": true and the quote you accepted:expectedDropshippingCreditCost: the quote’screditCost.expectedDropshippingPolicyRevision: the quote’srevision, as a number.
cURL
412 PRECONDITION_FAILED in two cases:- The cost or the pricing revision changed since your quote. Get a new quote and try again.
- The account doesn’t have enough credits. Add credits or choose a plan in Arcade Studio, then try again.
Your brand on the receipt
Every order ships with a printed receipt. A dropshipped order carries your brand instead of Arcade’s, once your brand is set up. Set up your brand in Arcade Studio, under Settings → Branded Receipts, before your first dropshipped order. The API has no endpoint for this.
An order with
dropShip: false always ships with Arcade’s invoice.
When credits are charged
- Creating the checkout checks that your balance covers the credits. Nothing is reserved.
- Paying the checkout charges them, even if your balance has dropped since and the charge leaves it negative.
Cancel an unpaid checkout
To cancel an unpaid checkout, callcheckouts/cancel with the checkoutId.
Cancelling doesn’t guarantee the checkout page stops working. If someone still pays a cancelled checkout, the credits are charged at the cost you agreed to, even if that leaves a negative credit balance.