# شارژ و پرداخت

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

## شارژ کیف پول

**مصرف ← شارژ**: مبلغ و درگاه را انتخاب کنید تا به صفحهٔ درگاه هدایت شوید. هنگام بازگشت،
ارورا پرداخت را با درگاه **تأیید** می‌کند و تنها پس از آن کیف پول را شارژ می‌کند.

```text
GET  /api/v1/payment-gateways                          # درگاه‌های در دسترس شما
POST /api/v1/organizations/{org_id}/wallet/top-up      # {"amount": 500000, "gateway": "zarinpal"}
GET  /api/v1/organizations/{org_id}/payments
GET  /payments/callback/{token}                        # کاربر از درگاه به اینجا برمی‌گردد
```

فقط مرحلهٔ **تأیید** پول را جابه‌جا می‌کند. بازگشت از درگاه به‌تنهایی هرگز کیف پول را شارژ
نمی‌کند — همین است که جلوی ساختن اعتبار با یک آدرس بازگشت جعلی را می‌گیرد.

## درگاه‌ها

| درگاه | کاربرد |
| --- | --- |
| **زرین‌پال** | پرداخت‌های واقعی |
| **درگاه آزمایشی** | محیط محلی و staging — صفحهٔ تأیید/رد نشان می‌دهد و از همان مسیر بازگشت برمی‌گردد |

فقط درگاه‌هایی در پرداخت پیشنهاد می‌شوند که روی این نمونهٔ ارورا فعال باشند.

## وضعیت‌های پرداخت

| وضعیت | معنی |
| --- | --- |
| `pending` | شروع شده و کاربر در درگاه است |
| `paid` | تأیید و شارژ شده |
| `failed` | درگاه رد کرده یا تأیید ناموفق بوده |
| `canceled` | کاربر بدون پرداخت برگشته |

جدول پرداخت‌ها هر تلاش را همراه با کد پیگیری و رسید، کنار دفتر کیف پول نشان می‌دهد.

## دسترسی‌ها

شارژ و دیدن پرداخت‌ها به توانمندی **`org:billing`** نیاز دارد — نقش `billing` برای همین وجود
دارد تا واحد مالی بدون دسترسی فنی کارش را انجام دهد.

## عیب‌یابی

| نشانه | علت / راه‌حل |
| --- | --- |
| هیچ درگاهی پیشنهاد نمی‌شود | فعلاً درگاه پرداختی در دسترس نیست — با پشتیبانی تماس بگیرید |
| پرداخت انجام شد ولی موجودی تغییر نکرد | تأیید ناموفق بوده — وضعیت ردیف پرداخت را ببینید؛ پول نزد درگاه است، گم نشده |
| بازگشت از درگاه خطا می‌دهد | توکن بازگشت منقضی شده یا قبلاً استفاده شده؛ شارژ تازه‌ای شروع کنید |
| درگاه آزمایشی پیشنهاد نمی‌شود | فقط در محیط محلی و staging وجود دارد، هرگز در تولید |