رفتن به محتوای اصلی
مالی

بروکر ارز

تأمین نقدینگی ارز، قیمت‌گذاری، موجودی و کلاینت API

11
بخش
2
پنل
معرفی سرویس

«بروکر ارز» تأمین‌کننده نقدینگی و قیمت خرید/فروش ارز برای باشگاه‌ها و اپلیکیشن‌های متصل است. فرق آن با «نرخ ارز» داخلی مون\u200cتک این است که یک شخص/third-party مستقل (بروکر) موجودی واقعی نگه می‌دارد، قیمت می‌گذارد و معاملات را تأیید می‌کند. ادمین پلتفرم بروکر را می‌سازد، ارزها و باشگاه‌های مجاز را وصل می‌کند و توکن API یک‌بار نمایش می‌دهد. پنل بروکر جایی است که خود بروکر قیمت، موجودی، معاملات و کلاینت‌های API را مدیریت می‌کند. اگر تازه کار هستید، مسیر را این‌طور ببینید: ادمین بروکر + ارز + باشگاه → بروکر قیمت و موجودی → (اختیاری) کلاینت API → درخواست خرید/فروش از اپ → معامله pending → بروکر تأیید → تسویه. این راهنما بدون مسیر API و نام فیلد، فقط با منوهای واقعی نوشته شده است.

1
بخش 1 از 11

پیش‌نیازهای کلی

  • در ادمین: دسترسی ساخت بروکر و اتصال باشگاه.
  • در پنل بروکر: نام کاربری و رمز که هنگام ساخت بروکر تعریف شده.
  • ارزهای پایه (ریال، طلا، USDT و ...) از قبل در سیستم تعریف شده باشند.
  • باشگاه فقط وقتی از بروکر استفاده می‌کند که متصل شده باشد.
بخش قبلبخش بعد
2
پنل ادمینبخش 2 از 11

مدیریت بروکر در ادمین

**پنل مدیریت → بروکر ارز**

آشنایی

جدول بروکرها: نام، شناسه یکتا (slug)، وضعیت (فعال، معلق، در انتظار)، تعداد ارزها، کلاینت‌های API، معاملات.

گام‌به‌گام — ساخت بروکر

  1. بروکر ارز را از مدیریت کسب‌وکار باز کنید.
  2. بروکر جدید را بزنید.
  3. نام بروکر و شناسه (فقط حروف انگلیسی، عدد و خط تیره) را وارد کنید.
  4. نام و تلفن رابط (اختیاری).
  5. نام کاربری و رمز عبور ادمین پنل بروکر (حداقل ۶ نویسه).
  6. نام نمایشی ادمین (اختیاری).
  7. در انتخاب ارزها، ارزهای مجاز را تیک بزنید.
  8. ایجاد بروکر را بزنید.

گام‌به‌گام — ذخیره توکن API

  1. پس از ساخت موفق، توکن API یک‌بار روی صفحه نمایش داده می‌شود.
  2. فوراً کپی کنید و در جای امن نگه دارید.
  3. دیگر نمایش داده نمی‌شود؛ در صورت گم شدن باید توکن جدید صادر شود.

گام‌به‌گام — جزئیات و ویرایش

  1. آیکون مشاهده (چشم) در ردیف بروکر را بزنید.
  2. می‌توانید: تماس را ویرایش کنید، ارزها را اضافه/حذف کنید، واحد هر ارز (گرم، عدد) را تنظیم کنید، سقف هر معامله (حداکثر مجاز از side ادمین) را برای هر offering تعیین کنید، باشگاه‌های متصل را مدیریت کنید، کاربران پنل بروکر را اضافه/غیرفعال/ریست رمز کنید.

گام‌به‌گام — اتصال باشگاه

  1. در جزئیات بروکر، بخش باشگاه‌های متصل را باز کنید.
  2. از لیست باشگاه‌های در دسترس، اپ/کیف موردنظر را انتخاب کنید.
  3. اتصال را بزنید.
  4. برای قطع، حذف در ردیف باشگاه متصل.

گام‌به‌گام — تغییر وضعیت

  • فعال: قیمت‌گذاری و معامله جدید مجاز.
  • تعلیق: معاملات جدید متوقف؛ داده قبلی حفظ می‌شود.

نکات

  • فقط باشگاه‌های متصل نرخ این بروکر را در اپ/پرتال می‌بینند.
  • افزودن/حذف ارز از لیست بروکر فقط از ادمین است.
3
پنل بروکربخش 3 از 11

داشبورد پنل بروکر

**پنل بروکر → نمای کلی**

پیش‌نیاز

  • آدرس پنل بروکر (subdomain یا پورت اختصاص) و حساب کاربری.

آشنایی

کارت‌ها: حجم تسویه‌شده، معاملات موفق، در انتظار، اعتبار کلاینت‌های API. پایین صفحه: ۸ معامله اخیر.

گام‌به‌گام — ورود

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

نکات

  • معاملات «در انتظار» نیاز به موجودی یا تأیید دستی دارند.
4
پنل بروکربخش 4 از 11

ارزها و قیمت‌گذاری

**پنل بروکر → ارزها و قیمت‌گذاری**

آشنایی

  • دستی: خودتان قیمت خرید و فروش را وارد می‌کنید.
  • اوراکل: قیمت پایه از بیرون؛ شما اسپرد درصدی خرید/فروش می‌گذارید.
  • قیمت مؤثر: عددی که مشتری/API می‌بیند.

گام‌به‌گام

  1. ارزها و قیمت‌گذاری را از منو باز کنید.
  2. کارت ارز را پیدا کنید.
  3. قیمت‌گذاری (آیکون مداد) را بزنید.
  4. حالت را انتخاب کنید: دستی یا اوراکل.
  5. دستی: قیمت خرید و قیمت فروش را بنویسید.
  6. اوراکل: اسپرد خرید (%) و اسپرد فروش (%) را بنویسید.
  7. حداقل و حداکثر معامله را تنظیم کنید (حداکثر نمی‌تواند از سقف ادمین بیشتر باشد).
  8. ذخیره را بزنید.

گام‌به‌گام — فعال/غیرفعال

  • آیکون Power روی کارت → ارز غیرفعال در معاملات جدید ارائه نمی‌شود.

نکات

  • ارزی در پنل نیست → از ادمین بخواهید به بروکر اضافه شود.
5
پنل بروکربخش 5 از 11

موجودی

**پنل بروکر → موجودی**

آشنایی

هر کارت: یک ارز + موجودی فعلی + زمان آخرین به‌روزرسانی. تغییرات در دفتر موجودی ثبت می‌شود (۳۰ ردیف آخر در پایین صفحه).

گام‌به‌گام — واریز یا برداشت

  1. واریز/برداشت را بزنید.
  2. ارز را انتخاب کنید.
  3. جهت: واریز (افزایش) یا برداشت (کاهش).
  4. مقدار و یادداشت (اختیاری).
  5. ثبت را بزنید.

نکات

  • قبل از تأیید معاملات فروش، موجودی کافی داشته باشید؛ وگرنه pending می‌ماند.
6
پنل بروکربخش 6 از 11

معاملات

**پنل بروکر → معاملات**

آشنایی

فیلتر: همه، تسویه‌شده، در انتظار، لغوشده. ستون‌ها: نوع (خرید/فروش)، مقدار، قیمت واحد، ارزش، مشتری، کانال (API، پنل، ...).

گام‌به‌گام — تأیید یا لغو

  1. فیلتر در انتظار را بزنید.
  2. ردیف معامله را پیدا کنید.
  3. تأیید: معامله تسویه می‌شود؛ موجودی و اعتبار کلاینت به‌روز می‌شود.
  4. لغو: بدون تسویه بسته می‌شود.

نکات

  • معاملات کوچک ممکن است خودکار تسویه شوند؛ بسته به تنظیمات.
7
پنل بروکربخش 7 از 11

کلاینت‌های API

**پنل بروکر → کلاینت‌های API**

آشنایی

کلاینت برای اتصال اپ یا سرویس دیگر به نرخ و معاملات بروکر با اعتبار پیش‌پرداخت است.

گام‌به‌گام — ساخت

  1. کلاینت جدید را بزنید.
  2. نام (مثل «اپ باشگاه X») را وارد کنید.
  3. ایجادکلید API یک‌بار نمایش داده می‌شود → فوراً کپی کنید.

گام‌به‌گام — مدیریت

عملنتیجه
شارژ اعتبارپیش‌پرداخت کلاینت زیاد می‌شود
غیرفعالفراخوانی API مسدود
حذفکلاینت و کلید حذف می‌شود

نکات

  • هر معامله از اعتبار پیش‌پرداخت کلاینت کسر می‌شود.
  • کلید گم شد → کلاینت جدید یا درخواست از ادمین.
8
پنل بروکربخش 8 از 11

تنظیمات

**پنل بروکر → تنظیمات**

گام‌به‌گام — تغییر رمز

  1. رمز عبور فعلی را وارد کنید.
  2. رمز جدید (حداقل ۶ نویسه) و تکرار را بنویسید.
  3. ذخیره رمز جدید را بزنید.

نکات

  • ادمین می‌تواند بدون رمز فعلی، رمز کاربر بروکر را ریست کند.
9
بخش 9 از 11

جریان کامل از صفر

flowchart LR
  A[ادمین: ساخت بروکر] --> B[ادمین: ارز + باشگاه]
  B --> C[بروکر: قیمت]
  C --> D[بروکر: موجودی]
  D --> E[بروکر: کلاینت API]
  E --> F[درخواست از اپ]
  F --> G{در انتظار?}
  G -->|بله| H[تأیید معامله]
  G -->|خیر| I[تسویه]
  H --> I
  1. ادمین بروکر می‌سازد و توکن را ذخیره می‌کند.
  2. ارزها و باشگاه متصل می‌شوند.
  3. بروکر وارد پنل می‌شود، قیمت و موجودی را تنظیم می‌کند.
  4. (اختیاری) کلاینت API برای اپ.
  5. معامله از اپ می‌آید → در صورت نیاز تأیید در معاملات.
10
بخش 10 از 11

خطاهای رایج

مشکلکار پیشنهادی
ارز در پنل بروکر نیستادمین ارز را اضافه کند
سقف معامله رد شدحداکثر را کم کنید یا سقف ادمین را بالا ببرید
معامله pendingموجودی شارژ + تأیید دستی
توکن گم شدتوکن/کلاینت جدید
باشگاه نرخ نمی‌بینداتصال باشگاه در ادمین