In-person check-ins with a code

Check members in at a booth, a door or a stage with a printed QR code that carries the station's secret code. Members scan it with their phone's camera, sign in, and complete the quest for that station. No wallet needed.

Print a QR code at each station of an event, such as a booth, a door or a stage. A member scans it with their phone's camera, which opens your app's scan page, and the quest completes for that station. Members need no wallet and pay nothing.

Each station has a secret code that Domino keeps, and the printed QR code carries it. Domino checks the code, limits guessing, and pays each member once per station. Your app serves the scan page, and Domino draws the QR codes for it.

This is experimental: a minor release can change it. For members who check in with a mobile wallet instead, see In-person quests with Solana Pay.

What members see

  1. The member scans the station's QR code with their phone's camera, and it opens your app's scan page.
  2. If they aren't signed in, the page asks them to sign in first, then checks them in.
  3. The page says "You're checked in at North gate", and the quest shows as complete for that station.

Set it up

Declare the code stations

List the stations on the quest, each with a key, a label and proof: "code", and optional opening and closing times. Deploy it to test. Stations a code proves has each rule.

Set each station's code

Codes aren't part of the quest. Each environment keeps its own code for each station, so test codes never check anyone in to live, and a code you print for live stays out of your test project.

In Console, open the quest and select the environment. Its Check-in stations section shows Code: Set or Code: Not set on each code station, never the code itself. With publish permission:

  1. Choose Set code, then Generate code. Domino makes a code and shows it once, with Copy secret. Or choose Choose a code and type one, 6 to 64 letters, digits, - or _.
  2. Once a station has a code, the menu reads Rotate code. Clear code removes it, and the station takes no check-ins in that environment until it gets another.

Serve the scan page from your app

The scan page is the page of your app the QR codes open, such as https://your-app.example/check-in. It reads the station and code from the link, signs the member in if needed, and checks them in. It takes the code out of the address bar as soon as it reads it, so a screenshot of the page or a link someone shares doesn't show it.

Or check codes in your app's server. If your app keeps members' sessions itself, such as a hosted app with its own sign-in, its server can send the check-in for the member it signed in.

Print the QR codes

  1. In Console, open the quest and select the environment. Enter your scan page in Scan page URL, an https address. Console remembers it in your browser for that quest and environment.
  2. Use Download QR on a station for an SVG to print, or a PNG. Domino draws it from the station's code: it links to your scan page with the quest, the station and the code added, and prints the station's label under it.

Download needs publish permission, because the QR code carries the code. Keep the files private until they're printed.

Test it

  1. In test, download a station's QR code and scan it with your phone. Sign in when the page asks: the quest completes for that station.
  2. Scan it again: the quest stays complete once for that station.
  3. Change a letter of the code in the link and open it: the page reports a wrong code.

Go live

  1. Promote the quest. The promotion carries the stations, never their codes, and it warns about each code station that has no code in live.
  2. Set or generate each station's code in live, as in step 2.
  3. Print the live QR codes, as in step 4, with live selected. QR codes from test don't check anyone in to live.

At the event

Time windows. A station takes check-ins between its opening and closing times. A code carries no time of its own, so Domino judges the window when the check-in arrives. Open each station only while the event runs: it's the best guard against a code shared after the event.

Once per member per station. A member who scans the same station twice completes it once. A quest with several stations completes once for each.

Guess limits. Domino counts only wrong codes. Each member has 10 wrong codes an hour at a station, which leaves room for typos, and a station takes 600 wrong codes in 10 minutes from all members together. While either is spent, the station refuses every check-in that limit covers, right codes included, until it ends. The scan page tells the member to wait and try again.

A leaked code. If a station's QR code is photographed and shared, open the quest in Console and choose Revoke on the station, with a reason. From then on Domino refuses every check-in at that station in that environment. Completions it already gave stay. Revoking isn't a change to the quest, so it takes effect in live at once, without a promotion.

Rotating a code and reprinting. To replace a leaked code, choose Rotate code on the station, then download and print its QR code again. The old printed codes stop working at once. Then Restore the station if you revoked it. To retire a station for good, give it a closing time, or add a station with a new key.

Where next

On this page