# کیف پول و پرداخت مصرفی

> https://docs.errora.org/billing/wallet

هر سازمان یک **کیف پول به تومان** دارد و به ازای آنچه واقعاً مصرف می‌کند پول می‌دهد. خبری از
پلن، صندلی و سطح‌بندی نیست.

## فهرست قیمت

نرخ هر واحد:

| سرویس | واحد | نرخ (تومان) |
| --- | --- | --- |
| خطا / لاگ | به ازای هر رویداد یا رکورد لاگ | ۱۰ |
| ردیابی | به ازای هر اسپن | ۰٫۱ |
| بازپخش نشست | به ازای هر نشست ضبط‌شده | ۱۵۰ |
| مانیتورینگ کران | به ازای هر چک‌این | ۱ |
| مانیتورینگ آپ‌تایم | به ازای هر بررسی | ۱ |
| پروفایلینگ | به ازای هر پروفایل | ۲۰ |
| متریک | به ازای هر سطل متریک | ۰٫۵ |
| رفع هوش مصنوعی | به ازای هر اجرا | ۲۰٬۰۰۰ |

فهرست زنده: `GET /api/v1/pricing`. اسلایدرهای صفحهٔ قیمت‌گذاری کمک می‌کنند صورتحساب ماهانه را
از روی حجم مورد انتظارتان تخمین بزنید.

## اعتبار ثبت‌نام و خط اعتبار

- سازمان‌های تازه با **۱۰۰٬۰۰۰ تومان** اعتبار شروع می‌کنند.
- سرویس‌ها تا یک خط اعتبار، حتی زیر صفر، به کار ادامه می‌دهند؛ پس یک جهش ترافیکی وسط حادثه،
  رصد شما را ساکت نمی‌کند.
- پس از عبور از آن خط، دریافت داده **متوقف** می‌شود: تا شارژ کیف پول، دادهٔ جدید پذیرفته
  نمی‌شود. چیزی که قبلاً ذخیره شده حذف نمی‌شود.

## نحوهٔ محاسبهٔ مصرف

مصرف همان‌طور که داده می‌رسد شمرده می‌شود و چند ثانیه بعد، در پس‌زمینه، از کیف پول کسر
می‌شود. به همین دلیل موجودی پله‌پله جابه‌جا می‌شود نه به ازای تک‌تک رویدادها — و به همین دلیل
محاسبهٔ مصرف هیچ‌وقت دادهٔ ارسالی برنامه‌تان را کند یا رد نمی‌کند.

## صفحهٔ مصرف

صفحهٔ **مصرف** این‌ها را نشان می‌دهد:

- **موجودی** فعلی و اینکه سازمان معلق شده یا نه
- **هزینه و تعداد واحد هر سرویس** در آن بازه
- **تفکیک روزانه و ماهانه**
- **دفتر کیف پول** (هر بدهکار و بستانکار) و تاریخچهٔ پرداخت‌ها

```text
GET /api/v1/pricing
GET /api/v1/organizations/{org_id}/usage
GET /api/v1/organizations/{org_id}/wallet
GET /api/v1/organizations/{org_id}/wallet/transactions
```

خواندن اطلاعات صورتحساب به توانمندی **`org:billing`** نیاز دارد. موجودی از راه
[MCP](/products/mcp) و ابزار `get_wallet_balance` برای ایجنت‌های هوش مصنوعی هم در دسترس است.

## هشدار موجودی

یک آستانه و یک کانال تعیین کنید تا با عبور موجودی از آن، `wallet.balance_low` فعال شود —
ایمیل، پیامک، Mattermost، تلگرام، بله یا وب‌هوک.

```text
GET/POST/PATCH/DELETE /api/v1/organizations/{org_id}/balance-alerts
```

دست‌کم یکی بگذارید. تمام‌شدن اعتبار دریافت داده را متوقف می‌کند و اولین نشانه‌اش معمولاً این
است که «چرا داشبورد ساکت است؟».

## کنترل هزینه

1. **ترِیس و پروفایل را نمونه‌برداری کنید** — پرحجم‌ترین سرویس‌ها هستند.
2. **`replaysSessionSampleRate` را کم کنید** — بازپخش گران‌ترین واحد است.
3. **مراقب کاردینالیتی برچسب متریک‌ها باشید** — هر ترکیب برچسب یک سطل جداست.
4. برای جریانی که نمی‌توانید سر منبع اصلاحش کنید، از **نرخ نمونه‌برداری پروژه** استفاده کنید.
5. برای هشدارها **`issue.created` را به `event.received` ترجیح دهید** — قلم هزینه‌ای نیست،
   ولی از همان جنس مراقبت است.

## عیب‌یابی

| نشانه | علت / راه‌حل |
| --- | --- |
| دریافت داده متوقف شده | موجودی از خط اعتبار گذشته — [شارژ کنید](/billing/payments) |
| موجودی پله‌ای کم می‌شود | تسویه در بازه‌های زمانی انجام می‌شود، نه به ازای هر رویداد |
| مصرف بیشتر از انتظار است | در صفحهٔ مصرف ببینید کدام سرویس غالب است — معمولاً اسپن‌های ردیابی یا بازپخش |
| اعداد با شمارنده‌های خودتان فرق دارد | ارورا آنچه را که *می‌رسد* حساب می‌کند: بعد از نمونه‌برداری SDK و پیش از نرخ نمونه‌برداری پروژه |