Introduction

#What Baziness is

Baziness is the game platform of Gita Games. When your game integrates it, your players get:

• A Baziness account: they sign in with their phone number, and the same account works in every Baziness game.
• Gita coins (گیتا کوین): the platform currency. Players earn it in games and spend it on real prizes.
• Baziness pages inside your game: sign-in, profile, the «انتخاب جایزه» reward shop, and your game's own offer page.
• Baziness Pay: real-money purchases through a hosted payment page.

These come as two separate integrations. You can ship either one alone, or both together:

#How the parts fit together

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

The client calls Baziness directly in only two cases: it shows Baziness pages, and it reads the coin balance (user/get-coin) with the player's own token. Everything else goes through your server, because only your server holds the client secret.

#The five golden rules

1. The client secret never leaves your server. The browser or app gets only public settings and the player's own token.
2. The server decides and the client only displays. Account links, coin grants and purchases are always checked on the server.
3. Every Baziness page link carries packageName and sdkType=js. Without sdkType=js the page can't talk to your game, so it can't even close itself.
4. The game keeps working without Baziness. If the platform is switched off or unreachable, hide the Baziness parts and carry on.
5. Every payout has a unique, repeatable id. A retry, a double tap or a crash must never pay twice.

#Environments

Each environment has its own client id and secret.

#How this wiki is organised

Every page can be downloaded as Markdown or PDF from the buttons under its title. The sidebar has the full guide in both formats.