Skip to main content

enable_mobile_verification

Enable Mobile Verification controls whether CMP triggers SMS OTP verification for customer mobile numbers during registration and when updating mobile numbers from the customer profile.

Path: Admin Panel → Global Settings

SettingValue
Flag nameenable_mobile_verification
Typical valuestrue / false
Defaultfalse
UI labelEnable Mobile Verification

Behaviour​

ValueResult
true (Enabled)CMP activates the mobile verification subsystem. Users are prompted to verify their mobile number via OTP during registration step 1 (Verify Email & Mobile Number) and whenever they change their mobile number in their profile.
false (Disabled)Mobile verification is turned off. Registration progresses without sending OTP SMS to mobile numbers.
Prerequisite

Before enabling this flag, ensure that SMS gateway credentials (MSG91, Twilio, or Spinning Disk) have been added to the backend .env file by the StackConsole deployment team. See SMS Gateways & Verification.

Also verify that enable_phone_input is set to true so that phone input fields are visible across registration and profile forms.

Interaction with enforce_mobile_verification​

While enable_mobile_verification enables the feature, enforce_mobile_verification determines whether completing mobile verification is compulsory or optional:

enable_mobile_verificationenforce_mobile_verificationRegistration Verification Flow
falsefalse / trueMobile verification is disabled. No OTP sent.
truefalseOptional: Customer receives an OTP to verify mobile number, but can skip or proceed without completing mobile verification.
truetrueCompulsory: Customer must verify their mobile number via OTP before they can advance to Step 2 (Complete Payment) or finish onboarding.

Where it applies​

  1. Customer Registration Wizard (Step 1 — Verify Email & Mobile No): Displays the Verify Mobile Number pane with country selector, phone number field, 6-digit OTP input, and Verify OTP button.

    Screenshot: CMP Registration — Verify Email and Mobile Number

  2. Customer Portal Profile (Personal Details): When updating the mobile number via Change mobile, an OTP is dispatched and must be verified before the profile is updated.

    Screenshot: CMP Customer Portal — Change Mobile Number Modal

Configure​

  1. Go to Admin Panel → Global Settings.
  2. Search for enable_mobile_verification.
  3. Use the row Actions menu to set the value to true.
  4. Configure enforce_mobile_verification to choose whether verification is required (true) or optional (false).
  5. Save and test the signup flow on the Customer Portal.