لوگوی پلتفرم Aizeمستندات پلتفرم Aize

کیف پول و صورت‌حساب

مدیریت موجودی، افزایش اعتبار و تراکنش‌های خود

کیف پول و صورت‌حساب

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

آشنایی با کیف پول شما

نمای کلی موجودی

موجودی فعلی

  • در IR، مبالغ با واحد تومان و نرخ تبدیل نمایش داده می‌شوند؛ موجودی پایه کیف پول دلاری است
  • با هر فراخوانی API به‌صورت لحظه‌ای به‌روزرسانی می‌شود
  • حداقل موجودی برای ساخت کلید API: $5.00

نشانگرهای وضعیت:

  • 🟢 سالم: موجودی بالاتر از آستانه پایین (پیش‌فرض: $10)
  • 🟡 موجودی کم: زیر آستانه، نیازمند توجه
  • 🔴 مسدود: موجودی $0، فراخوانی‌های API مسدود می‌شوند

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

یک آستانه سفارشی تنظیم کنید تا پیش از اتمام موجودی، هشدار دریافت کنید:

  1. به تنظیمات فضای کاری بروید
  2. آستانه موجودی کم را تنظیم کنید
  3. پیش‌فرض $10 است، می‌توانید هر مبلغی تعیین کنید
  4. با افت موجودی زیر این سطح، ایمیل دریافت کنید

افزایش اعتبار

نحوهٔ افزایش اعتبار

  1. روی دکمهٔ «افزایش اعتبار» در صفحهٔ کیف پول کلیک کنید.
  2. در IR، زرین‌پال یا رمزارز (NOWPayments) را از روش‌های فعال انتخاب کنید. هر روش فقط در صورت پیکربندی درگاه نمایش داده می‌شود.
  3. برای زرین‌پال، مبلغ را به تومان وارد کنید: حداقل ۱۰۰٬۰۰۰ تومان و حداکثر ۲۰۰٬۰۰۰٬۰۰۰ تومان در هر پرداخت.
  4. برای رمزارز، مبلغ افزایش اعتبار دلاری است: حداقل ۱۰ دلار و حداکثر ۱۰٬۰۰۰ دلار.
  5. پرداخت را تکمیل کنید و منتظر تأیید بمانید؛ پس از تأیید، اعتبار به کیف پول افزوده می‌شود.

پرداخت با زرین‌پال

  • پرداخت با کارت بانکی از طریق صفحه پرداخت زرین‌پال انجام می‌شود.
  • هر ۱ تومان = ۱۰ ریال (IRR)؛ بازه مجاز برابر ۱٬۰۰۰٬۰۰۰ تا ۲٬۰۰۰٬۰۰۰٬۰۰۰ ریال است.
  • مبلغ نمایش‌داده‌شده در پنجرهٔ افزایش اعتبار به تومان است و برای ارسال به درگاه به ریال تبدیل می‌شود.
  • پس از پرداخت به سامانه بازمی‌گردید؛ اعتبار پس از تأیید پرداخت اعمال می‌شود.
  • اگر نرخ تبدیل قابل اعتماد در دسترس نباشد، پرداخت ایجاد نمی‌شود؛ بعداً دوباره تلاش کنید یا از روش فعال دیگری استفاده کنید.

پرداخت با رمزارز (NOWPayments)

  1. روش پرداخت «رمزارز» را انتخاب کنید.
  2. به صفحه پرداخت بروید و از میان رمزارزهای موجود در آن صفحه انتخاب کنید.
  3. دقیقاً همان مبلغ، رمزارز و شبکه مشخص‌شده را به آدرس ارائه‌شده بفرستید.
  4. منتظر تأیید بلاکچین بمانید؛ زمان تأیید به رمزارز و شبکه بستگی دارد.

تأیید و امنیت پرداخت

  • پرداخت زرین‌پال پیش از اعمال اعتبار از درگاه استعلام می‌شود.
  • امضای HMAC-SHA512 برای بازخوانی‌های NOWPayments بررسی می‌شود.
  • پردازش تکراری یک پرداخت، اعتبار تکراری ایجاد نمی‌کند.
  • پس از تأیید، تراکنش ثبت و موجودی کیف پول به‌روزرسانی می‌شود.

سابقه تراکنش‌ها

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

انواع تراکنش

افزایش اعتبار (سبز)

  • پرداخت‌های تأییدشده زرین‌پال یا رمزارز
  • مبلغ پرداخت و اعتبار کیف پول
  • شناسه پرداخت یا تراکنش برای پیگیری
  • وضعیت: در انتظار ← تأییدشده

کسر بابت مصرف (قرمز)

  • هزینه‌های درخواست API
  • پس از هر درخواست موفق کسر می‌شود
  • مدل استفاده‌شده و تعداد توکن را نشان می‌دهد
  • برای جزئیات، به گزارش فراخوانی‌های API لینک دارد

بازپرداخت‌ها (سبز)

  • اعتبارهای صادرشده توسط مدیر
  • شامل دلیل در توضیحات
  • به موجودی در دسترس اضافه می‌شود

تعدیل‌ها (زرد)

  • تغییرات دستی موجودی توسط مدیر
  • می‌تواند مثبت یا منفی باشد
  • شامل یادداشت‌های مدیر

مشاهده تراکنش‌ها

جزئیات رکورد تراکنش:

  • نوع: DEPOSIT، USAGE_DEDUCTION، REFUND، ADJUSTMENT
  • مبلغ: مقدار دلاری با پیشوند + یا -
  • موجودی پس از تراکنش: موجودی شما پس از این تراکنش
  • زمان: تاریخ و ساعت دقیق
  • توضیحات: شرح قابل‌فهم برای انسان
  • فراداده: جزئیات فنی بیشتر (قابل‌گسترش)

صفحه‌بندی:

  • 20 تراکنش در هر صفحه
  • برای تراکنش‌های قدیمی‌تر روی «بارگذاری بیشتر» کلیک کنید
  • جدیدترین تراکنش‌ها ابتدا نمایش داده می‌شوند

تحلیل هزینه

آمار دوره فعلی

این ماه

  • کل هزینه در ماه شمسی/میلادی جاری
  • در روز اول هر ماه از نو شروع می‌شود
  • برای برنامه‌ریزی بودجه مفید است

30 روز گذشته

  • بازه غلتان 30 روزه
  • برای پیگیری دقیق‌تر بودجه ماهانه مناسب‌تر است
  • نوسانات مرزی ماه‌ها را هموار می‌کند

نرخ مصرف روزانه میانگین

  • میانگین هزینه روزانه شما
  • بر اساس 30 روز گذشته محاسبه می‌شود
  • به پیش‌بینی زمان نیاز به افزایش موجودی کمک می‌کند

روزهای باقی‌مانده تخمینی

  • تعداد روز تا رسیدن موجودی به $0
  • بر اساس نرخ مصرف فعلی
  • روزانه به‌روزرسانی می‌شود
  • فرمول: Current Balance / Average Daily Spend

نکات بهینه‌سازی هزینه

مصرف خود را پایش کنید:

  1. برای دیدن هزینهٔ هر فراخوانی، گزارش فراخوانی‌های API را بررسی کنید
  2. مدل‌های پرهزینه مورد استفاده را شناسایی کنید
  3. برای وظایف ساده‌تر، جایگزین‌های ارزان‌تر را در نظر بگیرید

از رده‌های مدل استفاده کنید:

  • GPT-5.4 Nano / GLM-4.7 Flash: سریع و ارزان برای کارهای ساده
  • GPT-5.4 Mini: تعادل سرعت و هزینه برای استفاده روزمره
  • Claude 4.6 Sonnet / GPT-5.4: برای استدلال پیچیده استفاده کنید
  • Claude 4.8 Opus: سطح سازمانی، بالاترین توانمندی

محدودیت کلید API تعیین کنید:

  • با تعیین سقف ماهانه از هزینه‌های بی‌رویه جلوگیری کنید
  • برای محیط توسعه و تولید محدودیت‌های متفاوت تعیین کنید
  • هنگام نزدیک شدن به سقف، هشدار دریافت کنید

مدل صورت‌حساب

سیستم پیش‌پرداخت

پلتفرم Aize از یک مدل صورت‌حساب پیش‌پرداختی استفاده می‌کند:

  1. اول افزایش اعتبار: پیش از مصرف، اعتبار کیف پول را افزایش دهید
  2. پرداخت به ازای مصرف: فقط برای فراخوانی‌های واقعی API هزینه پرداخت می‌کنید
  3. کسر آنی: هزینه پس از هر درخواست کسر می‌شود
  4. بدون حداقل: به هر میزان که نیاز دارید استفاده کنید
  5. بدون انقضا: موجودی هرگز منقضی نمی‌شود

نحوه محاسبه هزینه‌ها

هزینه هر درخواست API شامل موارد زیر است:

Total Cost = (Base Provider Cost × Markup) + Fixed Fee

مثال:

  • هزینه ارائه‌دهنده (OpenAI): $0.10
  • سود اضافه‌شده (25%): $0.025
  • کارمزد ثابت: $0.01
  • هزینه شما: $0.135

هزینه‌ها بر اساس موارد زیر متفاوت است:

  • مدل: Claude 4.8 Opus > GPT-5.4 > Claude 4.6 Sonnet > GPT-5.4 Mini > GPT-5.4 Nano
  • توکن‌ها: توکن بیشتر = هزینه بیشتر
  • ورودی در مقابل خروجی: معمولاً توکن‌های خروجی هزینه بیشتری دارند

قیمت‌گذاری شفاف

هزینه دقیق هر درخواست را مشاهده کنید:

  1. به گزارش فراخوانی‌های API بروید
  2. جزئیات را ببینید:
    • هزینه ارائه‌دهنده (آنچه ما می‌پردازیم)
    • هزینه مشتری (آنچه شما می‌پردازید)
    • سود ما (شفاف)
    • تفکیک توکن ورودی/خروجی

وضعیت و مسدودسازی کیف پول

زمان مسدود شدن کیف پول

مسدودسازی خودکار:

  • رسیدن موجودی به $0.00
  • سیستم بلافاصله فضای کاری را مسدود می‌کند
  • تمام فراخوانی‌های API با خطای 402 Payment Required مسدود می‌شوند
  • امکان ساخت کلید API جدید وجود ندارد

مسدودسازی دستی (اقدام مدیر):

  • تخلفات انطباقی
  • اختلافات پرداخت
  • بازبینی حساب

اثرات کیف پول مسدود

هنگام مسدود بودن:

  • ❌ فراخوانی‌های API مسدود می‌شوند
  • ❌ امکان ساخت کلید API وجود ندارد
  • ✅ امکان مشاهده داشبورد وجود دارد
  • ✅ امکان مشاهده تحلیل‌ها/گزارش‌ها وجود دارد
  • ✅ افزایش اعتبار ممکن است

فرایند رفع مسدودی

رفع مسدودی خودکار:

  1. اعتبار را افزایش دهید (زرین‌پال: ۱۰۰٬۰۰۰ تا ۲۰۰٬۰۰۰٬۰۰۰ تومان؛ رمزارز: ۱۰ تا ۱۰٬۰۰۰ دلار)
  2. منتظر تأیید پرداخت بمانید
  3. کیف پول به‌طور خودکار رفع مسدودی می‌شود
  4. دسترسی API بلافاصله بازیابی می‌شود
  5. ایمیل اطلاع‌رسانی ارسال می‌شود

رفع مسدودی دستی (در صورت مسدودسازی توسط مدیر):

  • با پشتیبانی تماس بگیرید
  • مشکل زمینه‌ای را برطرف کنید
  • مدیر به‌صورت دستی حساب را رفع مسدودی می‌کند

سوالات متداول

افزایش اعتبار چقدر طول می‌کشد؟

زرین‌پال: پس از بازگشت از درگاه و تأیید پرداخت، اعتبار اعمال می‌شود.

رمزارز: اعمال اعتبار به تأیید بلاکچین بستگی دارد؛ وضعیت را در صفحه پرداخت بررسی کنید.

اگر مبلغ اشتباهی ارسال کنم چه می‌شود (رمزارز)؟

دقیقاً مبلغ و رمزارز مشخص‌شده در صفحه پرداخت را ارسال کنید. اعتبار کیف پول پس از تأیید یا تکمیل پرداخت، بر اساس مبلغ واقعی دریافت‌شده اعمال می‌شود. اگر پرداخت در انتظار مانده یا اعتبار با انتظار شما متفاوت است، شناسه پرداخت را برای پشتیبانی بفرستید.

آیا می‌توانم بازپرداخت دریافت کنم؟

برای بررسی درخواست بازپرداخت با پشتیبانی تماس بگیرید و شناسه پرداخت را ارائه دهید. تأیید پرداخت به معنی بازپرداخت خودکار نیست.

موجودی باقی‌مانده چه سرنوشتی دارد؟

  • وجه هرگز منقضی نمی‌شود
  • برای استفاده آینده در دسترس است
  • برای بستن حساب، با پشتیبانی تماس بگیرید
  • ممکن است واجد شرایط برداشت باشد (بسته به مورد)

آیا اطلاعات پرداخت من امن است؟

پرداخت بانکی در صفحه زرین‌پال انجام می‌شود. پرداخت‌های رمزارزی را NOWPayments پردازش می‌کند و امضای بازخوانی آن‌ها پیش از پردازش بررسی می‌شود.

دریافت کمک

مشکلات پرداخت:

  1. وضعیت پرداخت را در سابقه پرداخت‌ها بررسی کنید؛ برای رمزارز، کاوشگر بلاکچین را نیز ببینید
  2. آدرس و مبلغ صحیح ارسال‌شده را تأیید کنید
  3. منتظر بمانید تا زمان تأیید کامل شود (بسته به ارز متفاوت است)
  4. اگر پرداخت تأیید شده اما اعتبار داده نشده، با پشتیبانی تماس بگیرید

سوالات مربوط به کیف پول:

  • ایمیل: support@example.com
  • موارد زیر را ذکر کنید:
    • شناسهٔ فضای کاری
    • شناسه تراکنش (در صورت وجود)
    • در صورت کمک‌کننده بودن، تصاویر صفحه

مراحل بعدی

در این صفحه