Managing buyer discounts and pay increases on work orders.
Beyond bonuses and penalties, work orders can have Discounts (buyer-side reductions) and Increases (pay adjustments).
Discounts reduce the buyer's cost without affecting provider pay.
GET /workorders/{work_order_id}/discounts
{
"results": [
{
"id": 101,
"type": "percentage",
"value": 10,
"description": "Volume discount",
"applied_by": "system",
"created": { "utc": "2024-01-15 10:00:00" }
},
{
"id": 102,
"type": "fixed",
"value": 25.00,
"description": "Promotional discount",
"applied_by": "admin",
"created": { "utc": "2024-01-15 10:00:00" }
}
],
"total_discount": 40.00
}| Type | Description | Example |
|---|---|---|
percentage | Percentage off total | 10% off = $15 on $150 job |
fixed | Fixed dollar amount | $25 off |
Discounts are typically applied through business rules or admin actions, not directly via API in most integrations.
Pay increases adjust the provider's compensation, often due to scope changes or negotiations.
GET /workorders/{work_order_id}/increases
{
"results": [
{
"id": 201,
"amount": 50.00,
"reason": "Additional equipment needed",
"status": "approved",
"requested_by": "provider",
"approved_by": { "id": 500, "name": "Dispatch Manager" },
"created": { "utc": "2024-01-15 14:00:00" }
}
],
"total_increase": 50.00
}GET /workorders/{work_order_id}/increases/{increase_id}
PUT /workorders/{work_order_id}/increases/{increase_id}
{
"status": "approved"
}{
"status": "rejected",
"rejection_reason": "Outside scope agreement"
}{
"amount": 35.00,
"status": "approved",
"note": "Approved partial increase"
}| Reason | Description |
|---|---|
| Scope change | Work requirements expanded |
| Additional equipment | Extra hardware needed |
| Extended time | Job took longer than expected |
| Travel adjustment | Further distance than quoted |
| Emergency/urgent | Rush job premium |
Final Pay = Base Pay
+ Bonuses
- Penalties
+ Approved Increases
+ Approved Expenses
Buyer Cost = Final Pay
- Discounts
+ Platform FeesIncreases can only be approved before the work order reaches Paid status.
Last updated on