شارژ و پرداخت

شارژ کیف پول

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

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 وجود دارد، هرگز در تولید