Draft Orders - PlatformDTC

https://api.platformdtc.com/api/v1/draft_orders

Auth: X-Agent-Key: sq_agt_*. Scopes: read_draft_orders, write_draft_orders. Status flow: open → invoice_sent → completed (converts to a real order). Request bodies wrap the resource: { "draft_order": { … } }.

Endpoints

POST /draft_orders · GET /draft_orders (cursor) · GET /draft_orders/{id} · PUT /draft_orders/{id} · DELETE /draft_orders/{id}
POST /draft_orders/calculate — compute totals without saving
POST /draft_orders/{id}/send_invoice — set invoice_sent + invoice URL
POST /draft_orders/{id}/complete — create the real order + line items, link completed_order_id

curl -s -X POST https://api.platformdtc.com/api/v1/draft_orders \
  -H "X-Agent-Key: sq_agt_*" -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"draft_order":{"email":"[email protected]","currency":"USD",
       "line_items":[{"variant_id":"var_…","quantity":3,"price":2500}],
       "applied_discount":{"value_type":"fixed_amount","value":1000}}}'

Totals (subtotal, discount, shipping, tax, total) are server-computed. Emits draft_orders/create|update|delete.

​Endpoints

Endpoints