New — the DCMS Voluntary Code for prize-draw operators is now in effect. Here's what independent draw verification means for UK competitions.Read the guide →
Documentation

Verified Draws documentation

Pick the path that fits you. Developers get the technical integration contract — plugin, endpoints, verify links. Operators get a plain-language, step-by-step walkthrough of running a provably-fair competition end to end.

Developers

Technical integration. Install and connect the plugin with a site token, register each competition against a sealed seed commitment, allocate provably-fair ticket numbers instantly per order, reveal the seed at close, pull results back through POST /api/plugin/results, and render the stored verify links in your own theme. Every example is a copiable code block — PHP, curl, and the [vd_results] shortcode.

  • Connecting the plugin (site token)
  • The register → allocate → close contract
  • Instant ticket allocation & the seed reveal
  • Results pull-back endpoint contract
  • The _vd_results meta key + JSON shape
  • Rendering links in a custom template
Operators

No code required. A numbered, plain-language walkthrough of the whole process: install the plugin, connect it with your site key, select your ended competitions and push ticket numbers, run the provably-fair draw, pull the verification results back with one click, and watch the winner and verify links appear on your competition page.

  1. 1Install the plugin
  2. 2Connect with the site key
  3. 3Select competitions & push ticket numbers
  4. 4Run the provably-fair draw
  5. 5Pull results back in one click
  6. 6Links show on your competition page
What Verified Draws gives you

Two distinct, independently-verifiable artefacts. Every order is assigned ticket numbers the instant it is paid — sealed by a commitment published before selling starts and revealed when the competition closes, so nobody can quietly re-allocate them after the fact. And when a competition closes, the winner draw is committed to a public randomness beacon and produces a shareable code anyone can re-run. Buyers verify their tickets at /verify/order/<slug> and a winning draw at /verify/<code>.

Plugin

Connects your site server-to-server with a locally generated site key, registers competitions, and pushes the final roster for the draw.

Ticket numbers

Each order gets a deterministic, seed-bound block of ticket numbers the moment it's paid — no waiting — plus a per-order link a buyer can check while selling and recompute offline after close.

Winner draw

When the competition closes, the draw resolves against a committed drand round and publishes a verification code.