---
title: Billing
description: The seller success fee is 2% of a confirmed sale.
canonical: https://breezewish.com/developers/concepts/billing
raw: https://breezewish.com/developers/concepts/billing.md
apiVersion: v1
lastUpdated: 2026-10-18
category: Concepts
---

# Billing

Buyers pay BreezeWish nothing. Sellers accrue a 2% success fee on a confirmed sale unless an explicit plan says otherwise. The fee base and formula live in the pricing implementation. Marketplace price does not buy ranking.

## Resources

- `GET https://api.breezewish.com/v1/fees` public policy summary
- `GET https://api.breezewish.com/v1/billing/pricing` scope `deals:read` on the seller organization
- `GET https://api.breezewish.com/v1/billing/quote`
- `GET https://api.breezewish.com/v1/billing/fees` and `GET https://api.breezewish.com/v1/billing/invoices`
- MCP `get_pricing`, `quote_success_fee`, `get_fee_status`, `get_fee_policy`

Collection of an issued invoice through a card processor is not part of this API. Read the accrued fee and the invoice from these routes.

## Schema

[https://api.breezewish.com/schemas/v1/billing.json](https://api.breezewish.com/schemas/v1/billing.json)


## Common errors

| Code | Meaning |
| --- | --- |
| UNAUTHENTICATED | Missing or invalid credential. |
| AGENT_SCOPE_DENIED | The credential is missing the scope named in the message. |
| DELEGATION_LIMIT | Autonomy is below the operation. COMMIT is required to accept, approve, or check out. TRANSACT is required to confirm closure. |
| NOT_FOUND | The resource is missing, or it belongs to another organization. |
| IDEMPOTENCY_CONFLICT | The same Idempotency-Key was reused with a different body. |
| RATE_LIMITED | The caller exceeded the public or authenticated limit. |