Account — creator rewards

The dealer Creator Rewards program loads a landing page (action_type=status), a public prize pool and leaderboard (action_type=pool), and accepts a Join application via action_type=apply. Credit payout (payout_pref=credit) is the usual integrator path; cash payout requires bank fields.

Use your registration domain in every form body — not the API hostname.

Playground & Profile

Playground — Home feed → Platform → Creator Rewards when running npm run docs:stack. Profile → Account can load a status preview when signed in.

Application status

Prefer program.application?.status (e.g. pending) over can_join alone when the UI shows “Awaiting review”.

Integrator scope

In scope for your app: load the program landing (action_type=status), show the public pool (action_type=pool), and submit Join (action_type=apply with payout_pref=credit). Reflect program.application?.status in the UI.

Out of scope: operator approval, referral dashboards after approval, submit-post workflows, linked channels, and monthly close — not documented for integrators until verified from capture. Do not assume extra action_type values.

Status (landing)

POST https://api.gommo.net/api/apps/go-mmo/users/creator_rewards
Content-Type: application/x-www-form-urlencoded

Field	Required	Notes
access_token	yes	User session token
domain	yes	Registration domain
action_type	yes	status
language	optional	e.g. EN, VI
device_id, device_name, device_info	optional	Same as login

Typical success shape (fields vary by dealer):

{
  "success": true,
  "program": { "rules": "", "offers": [], "platforms": [] },
  "runtime": 0.05
}

Pool (leaderboard)

Same URL with action_type=pool. Same auth and domain fields.

Typical success includes pool (e.g. total_earned, top[], claims_recent[]) and runtime.

Apply (Join form)

Same URL with action_type=apply.

Field	Required	Notes
payout_pref	yes	credit (default UX) or cash
contact	yes	Contact channel
email	yes	Email
reason	yes	Why join
accept_rules	yes	Must be 1
bank_name, account_name, account_number	cash only	Required when payout_pref=cash
bank_extra	optional	Branch / extra info (cash)
access_token, domain	yes
language, device_*	optional

Success (verified capture):

{
  "success": true,
  "message": "…",
  "program": { "application": { "status": "pending" } },
  "runtime": 0.04
}

Mode B (optional gateway)

Operation	Gateway (Bearer + JSON)	Upstream
Status	POST {gateway}/gateway/creator-rewards with { "action_type": "status" }	…/users/creator_rewards
Pool	Same path with { "action_type": "pool" }	Same
Apply	Same path with { "action_type": "apply", "payout_pref": "credit", … }	Same

JSON camelCase aliases: payoutPref, bankName, accountName, accountNumber, bankExtra, acceptRules.

OpenAPI: openapi.yaml.

SDK: @ai-gateway/client — auth.getCreatorRewardsStatus(), getCreatorRewardsPool(), applyCreatorRewards(). See SDK authentication.

→ Partner program · Support tickets · Session devices · Endpoint map · Deploy → Self-host (advanced)