← Back to Documentation

Sandbox Quickstart

This site — dev.flipkey.gg — is FlipKey.gg's sandbox. It runs the real product end to end: real dashboard, real checkout flow, real on-chain records. What's fake is everything that costs money: payments use Stripe's test mode, records live on a test network, and game keys are clearly-marked sandbox strings. You can list, sell, give away, and redeem — and nobody's card is ever charged (test cards only). One real meter runs even here: sandbox giveaways and beta waves draw from the same 1,000 free promotional mints your account starts with.

What's real vs. what's simulated

  • Real: every flow — listing creation, card checkout, buyer library, giveaway claims, redemption, refunds, webhooks.
  • Simulated: money (test cards only), the blockchain (a free test network), delivered keys (sandbox strings that don't activate anywhere), and payout onboarding (a shared test account is attached for you).
  • Reset at launch: the sandbox is a proving ground. Nothing here carries over to the live marketplace — experiment freely.

1. Create your account (2 minutes)

  1. Go to flipkey.gg/register and fill in the form — any real-looking details work here.
  2. In the sandbox you don't need to check your inbox: a "verify instantly" link appears right on the page. Click it.
  3. Your account is auto-approved (the live marketplace has a human review step here). Click Go to Dashboard and connect a wallet in the popup — if you don't have one, it creates one for you with just an email. That wallet becomes your dashboard sign-in.

2. List a game (5 minutes)

Game listings deliver keys through your redemption endpoint on the live marketplace. In the sandbox, we host a stand-in for you so you can try the whole flow before writing any integration code. When the listing form asks for a redemption URL, paste:

https://dev.flipkey.gg/api/sandbox-redeem/YOUR_PUBLISHER_ID/{tokenId}

Click Test link in the form — it verifies instantly. Set a price ($0.99 minimum, or $0 for a free drop), a quantity, and publish. Your listing is live on the sandbox marketplace immediately.

3. Sell an item (2 minutes)

From Sell Item in the dashboard, create an in-game cosmetic — name, description, image, price (or free), quantity. Items are soulbound: locked to the buyer, never tradable or resellable. That's the clean lane — no grey market, no chargeback bait, final-sale.

4. Buy from yourself (3 minutes)

  1. Open the marketplace in a private/incognito window (so you're a stranger, not a signed-in publisher).
  2. Pick your listing and check out with any email — the 6-digit sign-in code appears on screen in the sandbox.
  3. Pay with Stripe's test card:
    4242 4242 4242 4242   any future expiry   any CVC   any ZIP
  4. The buyer's library shows the purchase; redeeming a game license hands over a sandbox key from the stand-in endpoint. Meanwhile your dashboard shows the sale, the mint, and the activity trail.

5. Run a giveaway (3 minutes)

Open one of your item drops and generate claim links. Each link is single-use. Send one to anyone (or open it yourself in an incognito window) — claiming works with an email code, a Kick or Twitch login, or a wallet, and the item lands in the claimer's account with zero crypto anything on their side. Watch-drops (rewards for watching a stream) are the same machinery with a watch-time gate — see Watch Drop Integration.

What changes on the live marketplace

  • Payouts: you onboard your own Stripe account (Payouts page) and receive real settlements — the sandbox's shared test account goes away.
  • Review: new publisher accounts get a human review before going live.
  • Redemption: your listings point at your own redemption endpoint delivering your real keys. The handshake is one signed GET — the same one the Test link button exercises.
  • Keys & records: real keys, and license records on the live network instead of the test one.

Questions the docs don't answer? Use the contact form on flipkey.gg — it reaches us directly.