API keys & integrations

The outside services the product can use, and where to get a key for each.

Admin → Settings → APIs

Map keys, reCAPTCHA, social sign-in and analytics — each stays off until you supply a key.

The APIs tab
The APIs tab. Click to enlarge.

Everything here is optional

The product runs with none of these configured. Each one adds something; none is required to take an order, and with no keys saved the application makes no outside requests at all.

The integrations

ServiceWhat it addsGet a key
reCAPTCHAProtects sign-in, sign-up, contact and reservation forms from bots.reCAPTCHA admin
Google sign-inLets customers sign in with a Google account.Google Cloud credentials
Mapbox / Google MapsMaps, delivery areas and live tracking.See Maps & location
Location lookupWorks out roughly where a visitor is, to show nearby restaurants.Your chosen IP-lookup provider
Menu importBuilds a menu from a file or a photographed menu.Uses your AI key

Creating your reCAPTCHA keys

  1. Open the reCAPTCHA admin console and choose + to register a site.
  2. Pick the type: v2 "I'm not a robot" shows a checkbox; v3 runs silently and scores the visitor.
  3. Add your domain. Add localhost too if you are testing locally.
  4. Accept the terms and submit. Google shows a Site key and a Secret key.
  5. Paste both into Settings → APIs, under the version you chose.
v2 and v3 keys are not interchangeable. They are separate pairs, registered separately. Switching version means generating a new pair — the old one will not work with the other version, which is the usual reason a working captcha suddenly fails.

Where the other keys live

Not every credential is on this tab, which is the usual reason people cannot find one:

Restrict every key you create. Both Google and Mapbox let you limit a key to your own domain. An unrestricted key found in your page source can be used by anyone, billed to you.

When it doesn't work

reCAPTCHA blocks real customers

Check you are using the right version's keys — a v2 key in a v3 field fails for everyone. The version selector is on this tab.

Google sign-in returns an error

The redirect address registered with Google must match your site exactly, including https:// and any trailing path.