Store and tips

Turn on sales

1. Complete payout onboarding in Earnings. Onboarding runs through Stripe, and your payout account must be active before a Game can sell or accept tips.
2. Define SKUs with set_game_skus. You can save definitions before onboarding finishes; nothing is for sale until the Store is enabled.
3. Enable the Store, tips, or both with set_game_monetization or the Game's dashboard page. Enabling fails until your payout account is active.

// set_game_skus (MCP). Replaces the complete list.
{
  "slug": "space-miner",
  "skus": [
    { "sku": "level-pack-2", "name": "Level pack 2", "kind": "access", "priceCents": 299 },
    { "sku": "gold-skin", "name": "Gold ship", "kind": "item", "priceCents": 99 },
    { "sku": "extra-life", "name": "Extra life", "kind": "consumable", "priceCents": 50, "sortOrder": 3 }
  ]
}

// set_game_monetization (MCP). Requires an active payout account to enable.
{ "slug": "space-miner", "shop": true, "donations": true }

A Game can be free, free with tips, paid SKUs only, or paid SKUs plus tips. When the Store or tips are unavailable, MiraDock.capabilities.shop and MiraDock.capabilities.donate are false and the play page shows nothing for sale.

SKU kinds

Use the Store from your Game

const ctx = await MiraDock.ready();
let owned = ctx.entitlements;              // [{ sku, kind, quantity, grantedAt }]
await MiraDock.on("entitlements", (list) => { owned = list; render(); });

if (MiraDock.capabilities.shop) {
  const items = await MiraDock.shop.list(); // [{ sku, name, description, kind, priceCents, owned, quantity }]
  const result = await MiraDock.shop.purchase("level-pack-2");
  // { status: "purchased", entitlement } | { status: "cancelled" } | { status: "signin_required" }
  const left = await MiraDock.shop.consume("extra-life", 1); // { ok: true, quantity }
}

if (MiraDock.capabilities.donate) {
  await MiraDock.tip.open({ suggestedCents: 300 }); // { status: "donated" | "cancelled" | "signin_required" }
}

Purchases open a checkout sheet on top of your Game. Your Game receives pause when it opens and resume when it closes. Like every SDK call, a purchase or tip times out after 10 seconds: if the Player has not confirmed by then, the sheet closes and the call rejects with timeout. A payment the Player already confirmed still completes, and the entitlements event delivers it.

What Players see

Players pay from a prepaid MiraDock balance in US dollars. They add $5, $10, or $25 by card from their balance page; the checkout sheet links there when the balance is too low. Purchases and tips require a signed-in Player, so guests get { status: "signin_required" } and a sign-in prompt. Balances are non-refundable and cannot be cashed out; only MiraDock can refund a purchase, and refunds return to the Player's balance. See the Balance terms.

When tips are on, the play page shows a Tip the creator button outside your Game, with the line “Tips are for the game you're playing.” The tip sheet names you and the Game, lets Players choose $1, $3, $5, or $10 or enter any amount from $1.00 to $500.00, and shows the split: the creator receives the tip rate on the Balance terms page and MiraDock keeps the rest. Creators cannot buy from or tip their own Games.

Fees and payouts

MiraDock keeps a platform fee on each purchase and tip, set per kind. The current rates are published on the Balance terms page and shown in your dashboard. The fee is rounded down to a whole cent and you receive the rest.

• New earnings are pending for 7 days, then become available.
• Every Monday at 14:00 UTC, available earnings of $10 or more transfer to your connected Stripe account. Stripe then pays your bank on its own schedule.
• Payouts are skipped while your payout account is inactive, on hold, or your account is suspended.
• get_game_stats reports plays, Players, leaderboard sizes, and seven-day purchase and tip counts. Its revenue field is currently null; use Earnings for money totals.

Limits

The full contract, including every error code, is in the Game SDK specification.