Documentation
Install, configure and integrate age and country verification for your store.
Getting started
Account
Install
- WooCommerceInstalling the eIDAS Verify plugin, connecting your API key, choosing which products are gated, and testing the flow before it meets a shopper.
- ShopifyHow the Shopify app gates checkout through a Checkout UI Extension, where the API key lives, how to scope which products are checked, and the order-level backstop.
- JavaScript widgetEmbedding the widget on any stack, the server-side proxy it requires, its configuration and callbacks, and why the callback is not a gate.
Concepts
- How a verification worksThe session lifecycle from init to verdict, which calls are authenticated and which cannot be, and exactly what the merchant learns at the end.
- Layered verificationThe three-layer model, the two independent conditions a layer must satisfy to run, and which layers have a working path today.
Troubleshooting
API reference
- AuthenticationHow merchant API keys authenticate the verification API, which three routes require one, and why the rest are deliberately open.
- Create a verification sessionPOST /api/verification/init — the request body, the verification types, the supported countries, the session the call returns, and the ways it fails.
- Poll a session's statusGET /api/verification/:sessionId/status — the polling fallback the shopper's browser uses, the five session states, and why it needs no API key.
- Stream session eventsGET /api/verification/:sessionId/events — the Server-Sent Events stream, what it sends, how reconnection behaves, and when to prefer it over polling.
- Read a session's resultGET /api/verification/:sessionId/result — the authenticated, boolean-only verdict your server acts on, and why it returns no personal data.
- Errors and status codesThe error envelope, every code the verification API returns, and why your integration should branch on code rather than message.