GitHub

AgeChecker

Table of content

Free 15 min initial consultation directly with our experts.

Free consultation +49 421 438 1919–0

Introduction

The AgeChecker plugin for Shopware 6 is a powerful solution designed to help merchants enforce age verification on their online storefronts. By integrating with a trusted external age verification service, the plugin ensures that customers meet the required age criteria before they can proceed to browse products or complete a purchase.

This plugin is particularly valuable for businesses selling age-restricted products such as alcohol, tobacco, or adult content, as it provides a reliable, legally compliant layer of protection for both merchants and customers. AgeChecker is highly configurable, allowing store owners to tailor the verification process to their specific requirements, while maintaining a smooth and user-friendly shopping experience.

Seamlessly integrating with Shopware’s sales channels, the plugin automatically enforces age verification at key points in the customer journey, including product pages, the cart, and checkout. By implementing AgeChecker, merchants can reduce legal risks, improve compliance, and provide a professional and trustworthy shopping environment that reassures customers while safeguarding the business.

Key Features

1.Sales Channel Integration
Add API keys per sales channel for flexible configuration.
2.Age Verification Options
Customers can verify their age by entering their date of birth.
3.Retry Management
Users have 3 attempts by default to verify their age.
4.Temporary Denial Logic
Block users temporarily after 3 failed attempts.
5.Admin Panel Configuration
Easily manage settings from the Shopware admin panel.

Compatibility

  • ✅ Shopware 6.6.x

Get Started

Installation & Activation
1.Download

Git

  • Clone the Plugin Repository:

  • Open your terminal and run the following command in your Shopware 6 custom plugins directory (usually located at custom/plugins/):

git clone https://github.com/solution25com/agechecker-shopware-6-solution25.git

Packagist 

composer require solution25/age-checker

2.Install the Plugin in Shopware 6

  • Log in to your Shopware 6 Administration panel.

  • Navigate to Extensions > My Extensions.

  • Locate the newly cloned plugin and click Install.

3.Activate the Plugin

  • After installation, click Activate or toggle the plugin to activate it

4.Verify Installation

  • After activation, you will see AgeChecker in the list of installed plugins.

  • The plugin name, version, and installation date should appear as shown in the screenshot below.

438103110 719ab524 7636 45b9 966a 66670f356c47

Plugin Configuration

1.Access Plugin Settings

  • Go to Settings > System > Plugins.

  • Locate AgeChecker and click the three dots (...) icon or the plugin name to open its settings.

2.API Key Setup

  • Go to Extensions > My Extensions > AgeChecker.

  • Select the appropriate Sales Channel.

  • Enter the API Key provided by AgeChecker.net. You must create an account there to obtain your API Key.

438103364 01e9a268 1dae 4eea B6dd Db453b959765

3.Save Configuration

  • Click Save in the top-right corner to store your settings

How It Works

1.User Initiates Checkout

  • AgeChecker triggers a popup based on the configured metho

2.Verification Attempt

  • The user provides their birthdate.

438103650 Cfc8b2aa Edb9 4d43 996b E395f9223d11

  • If successful, checkout proceeds.

438103745 3f110c91 8364 4093 A441 Deab0a3385d5

  • If unsuccessful:

The user can retry up to 3 times.
After 3 failed attempts, the user is temporarily denied access.

438103809 A43fda8d 86b8 40f8 9314 707e8c6b7c9c

3.Temporary Denial Logic

  • Denied users are blocked for 24 hours before they can try again.

Age Checker Plugin - API Documentation

This document provides a detailed overview of the API endpoint for the Age Checker Plugin for Shopware 6. The plugin connects your Shopware storefront with the trusted AgeChecker.net service to verify the age of customers before they gain access to age-restricted products. By integrating directly with the API, merchants can automate the age verification process and ensure that compliance requirements are consistently met.

When a customer enters their information during the checkout or account creation process, the plugin communicates with AgeChecker.net to validate the provided date of birth. The verification result is then securely stored in the customer’s custom fields within Shopware, enabling easy tracking, reporting, and further automation within the store.

Update Customer Age Verification Status

Endpoint

POST /age-checker-user-status

Description 

custom_age_confirmed_

System Checks

  • Customer must be logged in.

  • The uuid from AgeChecker.net must be provided.

  • Calls the AgeChecker.net API to verify the result.

  • Sets the customer’s custom field custom_age_confirmed_ to true if the verification is successful (status: accepted).

Request Headers 

sw-context-token: 
Content-Type: application/json

Note: 

sw-context-token

must be obtained via the Shopware Store API authentication process or created automatically in a Storefront session.

Example Request Body 

{
  "uuid": "8e7c35e2-3f48-4fc9-9283-fb0e198b0fd5"
}

Successful Response 

{
  "message": "Customer age verification status updated"
}

Example Error Response 

{
  "message": "uuid is required"
}

Troubleshooting

Verify Functionality

  • Confirm popup appears on checkout.

  • Test both verification methods.

  • Simulate 3 failed attempts to confirm that the user is blocked afterward.

FAQ

1.Is an API key required?
Yes. Without a valid API key, age verification will not function.

2.Can I limit it to certain sales channels?
Yes. You can enable or disable the plugin per sales channel.

3.Does this plugin block checkout?
Yes, until the user passes age verification.

4.What happens after 3 failed attempts?
The user is redirected to a temporary denial page and cannot retry until the timeout expires.