Skip to main content

FAQ — Orders & Deliverables

Managing scope, milestones, and deliverables.

C
Written by Catalin Fetean
Updated over 3 weeks ago

How do I create an order?

From an Active contract → Create order or via API:
​

curl -X POST $API_BASE/api/orders -b cookies.txt \
  -H 'Content-Type: application/json' \
  -d '{
        "title":"Landing page redesign",
        "total":150000,
        "currency":"USD",
        "contractId":"ct_123",
        "milestones":[{"name":"Wireframes","amount":50000},{"name":"Final design","amount":100000}]
      }'

Notes

  • total is in minor units (e.g., cents).

  • If you omit milestones, you can add them later.

What statuses can an order have?

  • Created → DepositPending → DepositPaid → InProgress → (MilestoneReleased many times) → Completed

  • At any point: Disputed → Resolved
    ​Who changes status?

  • Webhooks (payments/settlement),

  • Milestone actions (release), and

  • Admin decisions (disputes).

What file types are allowed for deliverables?

Images (PNG/JPG), PDF, DOC/DOCX, TXT/MD, JSON/CSV/XML, ZIP/RAR/7z.
​Security

  • MIME‑type validation, AV scanning, size limits.

  • Files are stored outside the web root with signed/role‑checked access.

What’s the max file size?

Default 10 MB per file, up to 6 files per request (adjustable via policy).
​Tip: For large design/video packages, upload as a compressed archive and provide a checksum.

Can I partially release a milestone?

Yes. Release any portion up to the milestone amount:

curl -X POST $API_BASE/api/orders/ord_123/milestones/m1/release -b cookies.txt \
  -H 'Content-Type: application/json' \
  -d '{"amount":75000}'

Impact

  • Escrow balance decreases.

  • Status emits milestone.released and order.status.changed.

How do I reject a deliverable?

Use Reject and provide a reason:

curl -X POST $API_BASE/api/orders/ord_123/deliverables/dlv_456/reject -b cookies.txt \
  -H 'Content-Type: application/json' \
  -d '{"reason":"Need higher-resolution assets; see comments."}'

Order returns to InProgress. The counterparty is notified.

Can I cancel an order mid‑way?

Yes, by mutual consent.
​Effects

  • Unreleased escrow funds are returned/refunded per terms.

  • Final invoice may include cancellation fees if agreed in contract.

  • Status becomes Completed or Resolved depending on payout/refund.

How do I track acceptance criteria?

Include them in the milestone definition and reference them in review comments. For objective criteria (e.g., Lighthouse score), attach a report as evidence.

Can I clone an order for a new client?

Yes. Use Clone order to reuse structure/milestones without copying files or private comments.

How do I export order activity?

From the order screen → Export (CSV/JSON), or via API to pull events for BI. Exports include timestamps, actors, actions, and references to files.

Did this answer your question?