Buyback Quotes
Quotes are proposals listing what you'll pay a client for their devices.
Where to find it
Admin: /commerce/orders → Quotes module (also legacy /buyback)
Portal: /portal/quotes (for vendor reps)
API: /api/v1/buyback/quotes
Quote anatomy
| Field | Purpose |
|---|---|
| Reference name | Human-readable label |
| Client | Sub-organization the quote is for (optional) |
| Client share | What the client gets (percentage or $/device) |
| Status | 0 = declined, 1 = approved, 2 = pending |
| Items | Devices on the quote — each with SKU, grade, quantity, value |
Building a quote
- Create quote (
POST /buyback/quotes) — set name and client share config - Look up pricing for each device the client has
- Add items (
POST /buyback/quotes/{id}/items) — SKU, grade, quantity, value - Send to client for review
- Client approves or declines →
PATCH /buyback/quotes/{id}/status
Client share calculation
Two ways to split revenue:
Percentage split (clientCalc = 0):
clientValue= % the client keeps- Example:
clientValue = 85→ client gets 85%, you keep 15%
Per-device flat ($):
clientCalc = 1,clientValue= dollars per device- Example:
clientValue = 50→ client gets $50/device regardless of value
Revenue share stored per item
The client_share field on each quote item stores that item's share amount. This lets you mix/match rates per item if needed (normally they all match the quote's default).
Webhooks
buyback.quote.created— on new quotebuyback.quote.approved— on status → 1buyback.quote.declined— on status → 0