---
title: "upgrade_below_payout"
url: https://services.dev/docs/reference/check/upgrade_below_payout
---
# upgrade_below_payout

URL: https://services.dev/docs/reference/check/upgrade_below_payout

> The approved price adds less than the person's payout.

| Fix | Fails in | Exit |
|---|---|---|
| Raise price.approved past the payout. | `services/translation.ts` | 1 |

**Owned by** [Service()](https://services.dev/docs/service.md): the page that explains what this gate holds.

## What check says

```txt title="npx services.dev check"
  ✗ The approved price adds less than the person's payout. Raise price.approved past the payout.
    https://services.dev/docs/reference/check/upgrade_below_payout
✗ 1 to fix
```

## The failing file

```ts title="services/translation.ts"
import { Service } from 'services.dev'

export default Service({
  name: 'Translation',
  description: 'A document, translated.',
  input: { document: 'file', to: 'language: a BCP 47 tag, such as fr-CA' },
  output: { document: 'file' },
  price: { usd: 49, approved: 59, payout: 30 },
})
```

## The fix

```diff title="git add -A && git diff --staged"
diff --git a/services/translation.ts b/services/translation.ts
index 6de3e19..470e0d1 100644
--- a/services/translation.ts
+++ b/services/translation.ts
@@ -5,5 +5,5 @@ export default Service({
   description: 'A document, translated.',
   input: { document: 'file', to: 'language: a BCP 47 tag, such as fr-CA' },
   output: { document: 'file' },
-  price: { usd: 49, approved: 59, payout: 30 },
+  price: { usd: 49, approved: 89, payout: 30 },
 })
```

```txt title="npx services.dev check"
✓ ready to sell · 1 Service · it keeps at least 46% of every job
```

## Explained in

- [Service()](https://services.dev/docs/service.md)

## What an agent reads

```json title="npx services.dev check --json · the upgrade_below_payout failure"
{
  "code": "upgrade_below_payout",
  "reason": "The approved price adds less than the person's payout.",
  "next": "Raise price.approved past the payout.",
  "doc_url": "https://services.dev/docs/reference/check/upgrade_below_payout"
}
```

<details>
<summary>The whole document check --json prints</summary>

```json title="npx services.dev check --json"
{
  "ai": {
    "cents_per_call": 42,
    "simulated": true
  },
  "mcp": {
    "tools": 13,
    "tokens": 4516,
    "sandbox": 9,
    "budget": 8000
  },
  "services": [
    {
      "path": "services/translation.ts",
      "lines": 5,
      "steps": "draft · ai → review · ai · adversarial · then a person approves",
      "ok": false,
      "price": "$49 per job, or $59 with a person's approval, within 48 hours, charged on delivery.",
      "who": "AI delivers unless the buyer pays for a person's approval.",
      "agent": {
        "tool": "order_translation",
        "words": 28,
        "job": "job_7Hq2",
        "status": "accepted",
        "on": null,
        "charged": 4900,
        "person": false,
        "why": ""
      },
      "ledger": "+$49.00 · AI $0.84 (example) · you $48.16",
      "approved_ledger": "+$59.00 · AI $0.84 (example) · person $30.00 · you $28.16 · approved",
      "outcome": null,
      "margin": {
        "floor": {
          "cents": 3920,
          "pct": 80
        },
        "approved": {
          "cents": 1720,
          "pct": 29
        },
        "own": 1720,
        "stop": 4180,
        "nested": []
      },
      "apps": [
        "customer portal",
        "delivery portal",
        "owner console"
      ],
      "failures": [
        {
          "code": "upgrade_below_payout",
          "reason": "The approved price adds less than the person's payout.",
          "next": "Raise price.approved past the payout.",
          "doc_url": "https://services.dev/docs/reference/check/upgrade_below_payout"
        }
      ]
    }
  ]
}
```

</details>

---

- Up: [check’s gates](https://services.dev/docs/reference/check.md)
- Previous: [price_below_cost](https://services.dev/docs/reference/check/price_below_cost.md)
- Next: [rail_conflict](https://services.dev/docs/reference/check/rail_conflict.md)