Submitting orders via API

End-to-end: products → cart → checkout/submit → polling order status.

6 min read · Updated 2026-04-26

End-to-end flow

1. List products: GET /api/products
2. Get product detail + decoration zones: GET /api/products/{productId}
3. Save a design: POST /api/account/designs
4. Add to cart: PUT /api/account/cart
5. Submit checkout: POST /api/checkout/submit
6. Poll order status: GET /api/orders/by-number/{orderNumber}

Webhooks instead of polling

Subscribe to order.status_changed webhooks via /account/webhooks instead of polling. See the signature verification guide.