---
title: Authentication
slug: authentication
docTags: 
createdAt: 2024-01-31T08:46:45.836Z
---

## How To Add Authentication?

In the digital world, customer verification, legal compliance, and information collection are imperative. Authentication settings fulfill these roles by guaranteeing security, ensuring legal adherence, and obtaining essential user information. They contribute to making your platform secure, compliant, and user-friendly simultaneously.

***

## How to access the Authentication Page

- On the Admin panel, click on "Settings."

::Image[]{src="https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/1fZSvvUWQmh9JuQdMhrG5_image.png" size="80" width="625" height="349" position="center" darkWidth="625" darkHeight="349" showCaption="false"}

- Then click on the "Authentication" section

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/LX7LTgcdMU_LsMtZdTEFx_image.png)

***

## User Registration

The **User Registration&#x20;**&#x73;etting controls whether new users are allowed to create accounts on your platform. When enabled, your platform becomes open for new customer onboarding. When disabled, no new accounts can be created.

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/3GsD_FSqVroUMjdXesII8_image.png)

***

## Login via OTP

Make logging in extra safe by letting customers use a one-time verification code sent to their phone or email. It's like an extra secret handshake to make sure it's really them.

:::hint{type="warning"}
***Note:****&#x20;Configure Email and SMS service accounts from the [Notification settings](https://help.hyperzod.com/notification) to use this feature.*
:::

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/gxq6j9qtZN1JBL2NGpuSQ_image.png)

***

## User Agreement at Registration

Add a checkbox when customers sign up to agree to the platform's terms and conditions. It's like asking, "Hey, do you agree to abide by the platform's rules?" before granting access.

:::hint{type="info"}
**Note:&#x20;**&#x59;ou can customize the consent text displayed during registration. To modify it, navigate to **Admin Panel > Language Settings > Signup Fields**, update the wording as required, and save your changes.
:::

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/OQXJJsvmZX11IsLUE5LEA_image.png)

***

## User Register Custom Fields

Get the info you need during sign-up by adding extra fields. It's like customizing a form so you can learn more about the customers joining your platform.

- You can enable or disable these additional fields from customer sign-up anytime.

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/gYruyLUYcoD1l2WW-mfMc_enabling-a-feature-and-creating-a-new-item-step-5-1.png)

### How to create a custom registration Field

- To create a custom registration field, click the **“Create”** button.

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/eMKbColrTMdbAWr-gDc7R_enabling-a-feature-and-creating-a-new-item-step-6.png)

### Language Selection&#x20;

- "Select Preferred Languages" to tailor this information to customer choices.&#x20;

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/SgYdGNixFBJBLvetVE0wG_change-language-to-english-step-3.png)

### Select the Field You Want to Add&#x20;

- Drag and drop the type of field&#x20;

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/q8wfbM29hEuula9jlQViJ_how-to-create-and-save-an-order-type-with-id-verification-step-11.png)

### Configure Field Settings&#x20;

- **Required:** Whether it should be mandatory for customers to fill in during checkout
- **Label:** Heading of the field
- **Placeholder:** Any note added under the heading

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/tlGctN6BNja85MFdsAU60_how-to-create-and-save-an-order-type-with-id-verification-step-23.png)

- Similarly, you can add more fields and click "Save".&#x20;

Now your Authentication settings are successfully configured.&#x20;

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/FZLXkybKDNp43Ux3z8k8H_image.png)

***

# Google reCAPTCHA

Google reCAPTCHA v3 helps protect your store from automated and potentially malicious activity by distinguishing genuine customers from bots. It can be used to protect customer login, registration, and password reset, helping reduce fake or bot-generated account registrations.

:::hint{type="warning"}
**Note:&#x20;**&#x47;enuine customer registrations are a normal part of the customer journey, and Hyperzod does not control who chooses to register on your store. Google reCAPTCHA v3 is intended to help prevent **automated or malicious sign-ups**.
:::



## How to Enable Google reCAPTCHA

To configure Google reCAPTCHA v3:

- From the Admin panel, go to **Settings > Authentication**.&#x20;
- Locate **Google reCAPTCHA** and enable the toggle.&#x20;
- Enter your **Site Key and** **Secret Key**.&#x20;
- Set the **Score Threshold** according to your requirements and save the configuration.

:::hint{type="info"}
**How to Get Your reCAPTCHA Keys**

- Go to the Google reCAPTCHA Admin Console and sign in with your Google account.
- Select the **reCAPTCHA type** you want to use (such as reCAPTCHA v3)
- Add your website's **Domain** name (without http\:// or paths, like example.com).
- Accept the terms of service and click **Submit**.
- Copy your newly generated **Site Key** and **Secret Key**
:::

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/tRtFA40nKGGCkjlq5btvK_image.png)

***

## Merchant Auth

The Merchant Signup Link feature allows you to add a custom URL that merchants can access directly from the **Merchant App**. This can be used to provide merchants with an external registration form, onboarding form, application page, or any other third-party resource.

For example, you can add a **third-party merchant signup form** where new merchants can:

- Register their business&#x20;
- Submit their merchant details&#x20;
- Provide required documentation&#x20;
- Complete the onboarding process&#x20;
- Access any other information required before joining the platform



### How to configure Merchant Auth

- Go to **Admin Panel > Settings > Authentication**.&#x20;
- Select the **Merchant Auth** tab.&#x20;
- Locate **Signup Link**.&#x20;
- Enable the **Signup Link** toggle.&#x20;
- Add the required URL and save the configuration.

![](https://api.archbee.com/api/optimize/A6k4A417O1V2DGm4H5kN0/m0Ffx__gBY7QLqChEYPIA_image.png)

***

## Frequently Asked Questions (FAQs)



:::ExpandableHeading
**How can I add additional fields to collect extra information during user registration?**

Please navigate to **Admin panel >** **Authentication Settings > User Registration Custom Fields** to add custom fields to the registration page.
:::

***

:::ExpandableHeading
**How can I make a custom registration field mandatory?**

To make a custom registration field required:

- Go to **Admin Panel > Authentication**.&#x20;
- Under **User Register Custom Fields**, locate the field you created.&#x20;
- Click the **Edit&#x20;**&#x6F;ption next to the field.&#x20;
- Enable the **“Required”** checkbox.&#x20;
- Click **Save**.&#x20;

Once marked as required, users will not be able to complete registration unless they fill out that field.
:::

***

:::ExpandableHeading
**How can I add clickable policy links (e.g., Privacy Policy or Terms & Conditions) in the registration consent checkbox so users can review them before signing up?**

To add the terms and policy or any other policy links:

- Go to **Admin Panel > Settings > Language**.&#x20;
- Scroll to the **“Sign-Up”** section.&#x20;
- Locate the **“Agreement Text”** field.&#x20;
- Insert your policy link(s) using an HTML \<a> tag.&#x20;
- Save the changes.&#x20;

The policy text will now appear as a clickable link in the registration consent checkbox.
:::

***

:::ExpandableHeading
**How can I enable user login via OTP?**

Please navigate to **Authentication Settings > Login via Verification Code** to enable OTP login. Also, make sure that you have configured the Email or SMS service for the users to recieve OTP.

Users must have a working notification provider to receive OTPs.

- Navigate to **Admin Panel > Settings > Notifications**.&#x20;
- Choose your preferred **Email** and/or **SMS** provider.&#x20;
- Complete the provider configuration and save the settings.

Also, make sure the OTP notification toggle is enabled under **Admin Panel > Template Settings > Customer Notifications&#x20;**&#x73;o users can receive the verification code via **Email&#x20;**&#x6F;r **SMS**, depending on your selected delivery method.
:::

***

:::ExpandableHeading
**How can I configure OTP delivery so that users receive verification codes via email only?**

If you want OTPs to be sent **only via email**, please follow these steps:

- Go to **Admin Panel > Settings > Notifications > Template Settings > Customer Notifications** and enable the toggle for **Email OTP**.&#x20;
- Make sure the **SMS OTP** toggle is disabled. &#x20;

After completing these steps, users will receive OTPs via **email only**.
:::



