مقدمه

#بازینس چیست

بازینس پلتفرم بازی گیتا گیمز است. وقتی بازی شما به آن وصل شود، بازیکنان این‌ها را می‌گیرند:

• حساب بازینس: با شماره موبایل وارد می‌شوند و همان حساب در همه‌ی بازی‌های بازینس کار می‌کند.
• گیتا کوین: واحد پول پلتفرم. بازیکن آن را در بازی‌ها به دست می‌آورد و برای جایزه‌های واقعی خرج می‌کند.
• صفحه‌های بازینس داخل بازی شما: ورود، پروفایل، فروشگاه جایزه‌ی «انتخاب جایزه» و صفحه‌ی پیشنهاد مخصوص بازی شما.
• پرداخت بازینس: خرید با پول واقعی از طریق صفحه‌ی پرداخت بازینس.

این‌ها دو یکپارچه‌سازی جدا از هم هستند. می‌توانید هر کدام را به‌تنهایی یا هر دو را با هم اضافه کنید:

#اجزا چطور کنار هم کار می‌کنند

flowchart LR
  subgraph Device["Player device"]
    G["Your game client"]
    S["Baziness sheet<br/>iframe → baziness.com"]
    P["Payment tab<br/>pay.baziness.com/buy"]
  end
  subgraph Backend["Your backend"]
    B["Game server<br/>(holds clientId + clientSecret)"]
  end
  K[("Baziness platform API")]
  Y[("Baziness Pay API")]
  G -- "/api/platform/*" --> B
  G -- "/api/shop/purchase/*" --> B
  B -- "client/auth · create-user · add-coin …" --> K
  B -- "get_payment · verify_payment · consume" --> Y
  G -- "user/get-coin (user token)" --> K
  G -- "opens" --> S
  S -- "postMessage: login · logout · close" --> G
  G -- "opens" --> P

کلاینت فقط در دو مورد مستقیم با بازینس حرف می‌زند: صفحه‌های بازینس را نشان می‌دهد، و موجودی سکه را با توکن خود بازیکن می‌خواند (user/get-coin). همه‌ی کارهای دیگر از سرور شما می‌گذرند، چون فقط سرور شما کلید محرمانه را دارد.

#پنج قانون طلایی

1. کلید محرمانه هیچ‌وقت از سرور بیرون نمی‌رود. مرورگر یا اپ فقط تنظیمات عمومی و توکن خود بازیکن را می‌گیرد.
2. سرور تصمیم می‌گیرد و کلاینت فقط نمایش می‌دهد. اتصال حساب، دادن سکه و خرید همیشه در سرور بررسی می‌شوند.
3. هر لینک صفحه‌ی بازینس packageName و sdkType=js دارد. بدون sdkType=js صفحه نمی‌تواند با بازی حرف بزند و حتی نمی‌تواند خودش را ببندد.
4. بازی بدون بازینس هم کار می‌کند. اگر پلتفرم خاموش یا در دسترس نبود، بخش‌های بازینس را پنهان کنید و ادامه دهید.
5. هر پرداخت یک شناسه‌ی یکتا و تکرارپذیر دارد. تلاش دوباره، دو بار زدن دکمه یا کرش سرور هیچ‌وقت نباید دو بار پاداش بدهد.

#محیط‌ها

هر محیط شناسه و کلید محرمانه‌ی خودش را دارد.

#این ویکی چطور مرتب شده

هر صفحه را با دکمه‌های زیر عنوانش به‌صورت Markdown یا PDF دانلود کنید. راهنمای کامل هم در هر دو قالب در نوار کناری هست.