PHPackages                             gitdevstar/laravel-otp-validate - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. gitdevstar/laravel-otp-validate

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

gitdevstar/laravel-otp-validate
===============================

Laravel package for OTP validation with built-in features like retry and resend mechanism. Built in max retry and max resend blocking. OTP/Security Code can be send over SMS or Email of your choice with user-defined template.

1.4.4(3y ago)015MITPHPPHP ^7.1.8|^8.0

Since Feb 23Pushed 3y ago1 watchersCompare

[ Source](https://github.com/gitdevstar/laravel-otp-validate)[ Packagist](https://packagist.org/packages/gitdevstar/laravel-otp-validate)[ Docs](https://github.com/gitdevstar/laravel-otp-validate)[ RSS](/packages/gitdevstar-laravel-otp-validate/feed)WikiDiscussions main Synced 4w ago

READMEChangelog (4)Dependencies (4)Versions (5)Used By (0)

OTP Validate Package in Laravel
===============================

[](#otp-validate-package-in-laravel)

This package is for easy setup for OTP validation process. No hassle, just plug and play. Following the steps mentioned below and you will be able to get a fully working OTP Validation system. You can use this later for authentication or e-commerce production selling, order confirmation.

[![Laravel 8|9](https://camo.githubusercontent.com/39142204fa5a1482caa848a603524184abaca3b21be50ffb66d5c9f1817f6022/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d37253743382d6f72616e67652e737667)](http://laravel.com)

[![Latest Stable Version](https://camo.githubusercontent.com/55f50a18f12602a28d7f875c96b10d59ff8cb8dd248d750ca6409cfc5384b43c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646576737461722f6c61726176656c2d6f74702d76616c69646174652e737667)](https://packagist.org/packages/devstar/laravel-otp-validate)

[![Total Downloads](https://camo.githubusercontent.com/0d4ac21ca273222d4993c005c24eba679d6ccb7cf1697099692be932d9fcadd9/68747470733a2f2f706f7365722e707567782e6f72672f646576737461722f6c61726176656c2d6f74702d76616c69646174652f646f776e6c6f6164732e706e67)](https://packagist.org/packages/devstar/laravel-otp-validate)

[![License](https://camo.githubusercontent.com/850eae1099d2b05f53383473d7cd51f9bc1ab09b7d0d9e5122f1dd930efdcc6d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6173686170652f6170697374617475732e737667)](https://packagist.org/packages/devstar/laravel-otp-validate)

Requirements
------------

[](#requirements)

- [PHP &gt;= 7](http://php.net/)
- [Laravel Framework](https://github.com/laravel/framework)

Installation
------------

[](#installation)

### Install Package

[](#install-package)

Require this package with composer:

```
composer require devstar/laravel-otp-validate

```

### Add Service Provider &amp; Facade

[](#add-service-provider--facade)

#### For Laravel 5.5+

[](#for-laravel-55)

Once the package is added, the service provider and facade will be auto discovered.

#### For Older versions of Laravel

[](#for-older-versions-of-laravel)

Add the ServiceProvider to the providers array in `config/app.php`:

```
Ferdous\OtpValidator\OtpValidatorServiceProvider::class
```

Add the Facade to the aliases array in `config/app.php`:

```
'OtpValidator' => Ferdous\OtpValidator\OtpValidatorServiceProvider::class
```

Publish Config
--------------

[](#publish-config)

Once done, publish the config to your config folder using:

```
php artisan vendor:publish --provider="Ferdous\OtpValidator\OtpValidatorServiceProvider"

```

This command will create a `config/otp.php` file.

### Email Configs

[](#email-configs)

From the `.env` file the email configs are setup. No other changes required.

### SMS Configs

[](#sms-configs)

As the SMS Gateways use different methods and also extra headers and params, you may need to update the sms configs in the `otp.php` file.

Migrate Database
----------------

[](#migrate-database)

Run the following command to create the otps table.

```
php artisan migrate

```

It will create a otps table with the required columns.

Environment
-----------

[](#environment)

Add the following Key-Value pair to the `.env` file in the Laravel application

```
# Basic OTP Configs
OTP_SERVICE='enabled'
OTP_TABLE_NAME='otps'
OTP_TIMEOUT=120
OTP_DIGIT=5
OTP_RESEND_SERVICE='enabled'
OTP_MAX_RETRY=2
OTP_MAX_RESEND=1
# Company and Service
OTP_SERVICE_NAME=
OTP_COMPANY_NAME=
# OTP via Email / SMS
OTP_SEND_BY_EMAIL=1
OTP_SEND_BY_SMS=1
# Email Configurations
OTP_EMAIL_FROM=
OTP_EMAIL_FROM_NAME=
OTP_EMAIL_SUBJECT=
# SMS Configurations
OTP_SMSC_URL='https://sms'
OTP_SMSC_METHOD=
OTP_COUNTRY_CODE=
OTP_SMSC_OVER_JSON=
OTP_SMSC_PARAM_TO_NAME=
OTP_SMSC_PARAM_MSG_NAME=
OTP_SMSC_USER=
OTP_SMSC_PASS=
AWS_SNS_VERSION=
AWS_SNS_KEY=
AWS_SNS_SECRET=
AWS_SNS_REGION=

```

Definitions
-----------

[](#definitions)

Definition of the features in config are:

- service : enable/disable OTP Service
- timeout: timeout for OTP
- digit: OTP Digit
- resend-service: enable/disable resend Service
- max-retry: max retry for a single request
- max-resend: max resend for a single request
- service-name: for which the service is used
- company-name: for which company
- send-by: there are 3 ways to share otp (Email/SMS/AWS SNS)
- email: this key specifies the required information for email (e.g. from, name, subject etc.)
- sms: configure with SMS gateway to send SMS. (Universal Configurator)

Defining Send By on Runtime
---------------------------

[](#defining-send-by-on-runtime)

The config method can be used to set send-by \[ SMS / Email / SNS \] at runtime.

```
config('otp.send-by.email', 1);
config('otp.send-by.sms', 0);

```

OTP Request Templates
---------------------

[](#otp-request-templates)

Once the template files are published, open `resources/views/vendor/template-otp/`

Sample Controller
-----------------

[](#sample-controller)

Run the following command to create a controller.

`php artisan make:controller OtpController`

Below is a sample for calling the OTP Validator in OtpController.

```
namespace App\Http\Controllers;

use Ferdous\OtpValidator\Object\OtpRequestObject;
use Ferdous\OtpValidator\OtpValidator;
use Ferdous\OtpValidator\Object\OtpValidateRequestObject;

class OtpController extends Controller
{
    /**
     * @return array
     */
    public function requestForOtp()
    {
        return OtpValidator::requestOtp(
            new OtpRequestObject('1432', 'buy-shirt', '01711084714', 'ferdousul.haque@gmail.com')
        );
    }

    /**
     * @param Request $request
     * @return array
     */
    public function validateOtp(Request $request)
    {
        $uniqId = $request->input('uniqueId');
        $otp = $request->input('otp');
        return OtpValidator::validateOtp(
            new OtpValidateRequestObject($uniqId,$otp)
        );
    }

    /**
     * @param Request $request
     * @return array
     */
    public function resendOtp(Request $request)
    {
        $uniqueId = $request->input('uniqueId');
        return OtpValidator::resendOtp($uniqueId);
    }

}
```

Add the following to the `routes/web.php` file.

```
Route::get('/test/otp-request', 'OtpController@requestForOtp');
Route::get('/test/otp-validate', 'OtpController@validateOtp');
Route::get('/test/otp-resend', 'OtpController@resendOtp');

```

Response/Error Descriptions
---------------------------

[](#responseerror-descriptions)

The below table describes the error codes generated in the response and their corresponding meanings.

```
{
  "code": 201,
  "message": "OTP Sent to the recipient",
  "uniqueId": 1432,
  "type": "buy-shirt"
}
```

#### Request OTP Response Codes

[](#request-otp-response-codes)

CodeMeanings201Successfully Generated OTP and shared.400Bad request.501Resend Service Disabled.503Service Unavailable.#### OTP Validate Response Codes

[](#otp-validate-response-codes)

CodeMeanings200Correct OTP.400Invalid OTP.404OTP Expired/Not Found.413Max Retry Exceeded.License
-------

[](#license)

MIT

Special Thanks
--------------

[](#special-thanks)

- [Nahid Bin Azhar](https://github.com/nahid) For the Feedback.

Support
-------

[](#support)

- For any bugs, please help to create an issue.
- For any problem installing or configurations, feel free to knock me.

Featured Article
----------------

[](#featured-article)

- [How to create a laravel OTP/Security code verification for e-commerce website](https://medium.com/@ferdousul.haque/how-to-create-a-laravel-otp-security-code-verification-for-e-commerce-website-55de8161cfb8)

Example SMS Gateways Configuration
----------------------------------

[](#example-sms-gateways-configuration)

### [Muthofun](https://www.muthofun.com/)

[](#muthofun)

If you are trying to integrate one of most popular SMS gateway of Bangladesh, muthofun is a popular Bulk SMS Gateway in our country. Here is a sample configuration for the Muthofun SMS Gateway

```
'smsc' => [
    'url' => env('OTP_SMSC_URL'),
    'method' => env('OTP_SMSC_METHOD', 'GET'),
    'add_code' => env('OTP_COUNTRY_CODE',null),
    'json' => env('OTP_SMSC_OVER_JSON',1),
    'headers' => [],
    'params' => [
        'send_to_param_name' => env('OTP_SMSC_PARAM_TO_NAME','number'),
        'msg_param_name' => env('OTP_SMSC_PARAM_MSG_NAME','msg'),
        'others' => [
            'user' => env('OTP_SMSC_USER'),
            'password' => env('OTP_SMSC_PASS'),
            'unicode' => 1
        ],
    ]
];
```

.env file will be as the following

```
OTP_SMSC_URL='http://clients.muthofun.com:8901/esmsgw/sendsms.jsp?'
OTP_SMSC_METHOD='GET'
OTP_COUNTRY_CODE='88'
OTP_SMSC_OVER_JSON=0
OTP_SMSC_PARAM_TO_NAME='mobiles'
OTP_SMSC_PARAM_MSG_NAME='sms'
OTP_SMSC_USER='YourUserName'
OTP_SMSC_PASS='YourPassWord'

```

### [Infobip](https://www.infobip.com/)

[](#infobip)

Example for integrating with the infobip SMS platform, renowned SMS Gateway.

using GET method

```
'smsc' => [
    'url' => env('OTP_SMSC_URL'),
    'method' => env('OTP_SMSC_METHOD', 'GET'),
    'add_code' => env('OTP_COUNTRY_CODE',null),
    'json' => env('OTP_SMSC_OVER_JSON',1),
    'headers' => [],
    'params' => [
        'send_to_param_name' => env('OTP_SMSC_PARAM_TO_NAME','number'),
        'msg_param_name' => env('OTP_SMSC_PARAM_MSG_NAME','msg'),
        'others' => [
            'username' => env('OTP_SMSC_USER'),
            'password' => env('OTP_SMSC_PASS'),
            'from' => 'InfoSMS',
            'flash' => true
        ],
    ]
];
```

.env file will be as the following

```
OTP_SMSC_URL='https://{baseUrl}/sms/1/text/query?'
OTP_SMSC_METHOD='GET'
OTP_COUNTRY_CODE='88'
OTP_SMSC_OVER_JSON=0
OTP_SMSC_PARAM_TO_NAME='to'
OTP_SMSC_PARAM_MSG_NAME='text'
OTP_SMSC_USER='YourUserName'
OTP_SMSC_PASS='YourPassWord'

```

### [msg91](https://msg91.com)

[](#msg91)

Sample for integrating with the msg91 SMS gateway.

using GET method

```
'smsc' => [
        'url' => env('OTP_SMSC_URL'),
        'method' => env('OTP_SMSC_METHOD', 'GET'),
        'add_code' => env('OTP_COUNTRY_CODE',null),
        'json' => env('OTP_SMSC_OVER_JSON',1),
        'headers' => [],
        'params' => [
            'send_to_param_name' => env('OTP_SMSC_PARAM_TO_NAME','number'),
            'msg_param_name' => env('OTP_SMSC_PARAM_MSG_NAME','msg'),
            'others' => [
                'authkey' => 'YourAuthKey',
                'sender' => 'YourSenderId',
                'route' => '1',
                'country' => '88',
            ],
        ],
        'wrapper' => 'sms',
    ];
```

.env file will be as the following

```
OTP_SMSC_URL='https://control.msg91.com/api/v2/sendsms?'
OTP_SMSC_METHOD='POST'
OTP_COUNTRY_CODE='88'
OTP_SMSC_OVER_JSON=1
OTP_SMSC_PARAM_TO_NAME='to'
OTP_SMSC_PARAM_MSG_NAME='text'
OTP_SMSC_USER='YourUserName'
OTP_SMSC_PASS='YourPassWord'

```

### [Using AWS Simple Notification Service (SNS)](https://aws.amazon.com/sns/)

[](#using-aws-simple-notification-service-sns)

Sample steps for integrating with the AWS SNS.

Create a IAM user with the appropriate policy permissions. Go to the IAM service and create your application’s user; be sure to capture its AWS Key and AWS Secret values and put this into your environment file. From there add the following policy to the user or its group.

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowSendingSMSMessages",
            "Effect": "Allow",
            "Action": [
                "sns:Publish",
                "sns:SetSMSAttributes",
                "sns:CheckIfPhoneNumberIsOptedOut"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

```

Here we set the ability to publish, set SMS attributes and check for opt-outs and apply this across a wildcard resource instead of a specific topic as we will be sending notifications directly to phone numbers and not an SNS topic.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 70% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

4

Last Release

1166d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c2a3fc16c7d86e578efe072d417c5c38087fea0f4a3c361e9929407628048fa6?d=identicon)[gitdevstar](/maintainers/gitdevstar)

---

Top Contributors

[![dwarhn](https://avatars.githubusercontent.com/u/132841461?v=4)](https://github.com/dwarhn "dwarhn (7 commits)")[![devstar0209](https://avatars.githubusercontent.com/u/56650395?v=4)](https://github.com/devstar0209 "devstar0209 (3 commits)")

---

Tags

emaillaravelotpotp-validationphpresendsecurity-codesmsphplaravelotpemailsmsresendretrysecurity-codeotp-validation

### Embed Badge

![Health badge](/badges/gitdevstar-laravel-otp-validate/health.svg)

```
[![Health](https://phpackages.com/badges/gitdevstar-laravel-otp-validate/health.svg)](https://phpackages.com/packages/gitdevstar-laravel-otp-validate)
```

###  Alternatives

[ferdous/laravel-otp-validate

Laravel package for OTP validation with built-in features like retry and resend mechanism. Built in max retry and max resend blocking. OTP/Security Code can be send over SMS or Email of your choice with user-defined template.

7124.4k](/packages/ferdous-laravel-otp-validate)[ellaisys/aws-cognito

AWS Cognito package that allows Auth and other related features using the AWS SDK for PHP

120220.7k1](/packages/ellaisys-aws-cognito)[juanparati/brevosuite

Complete Brevo integration with Laravel

1010.8k](/packages/juanparati-brevosuite)[djunehor/laravel-sms

Send SMS from your laravel application

385.3k1](/packages/djunehor-laravel-sms)[martian/spammailchecker

A laravel package that protect users from entering non-existing/spam email addresses.

422.0k](/packages/martian-spammailchecker)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
