README

Introduction
Initialization
Completion
Resend
Get Balance
Error Responses

Introduction:

Vereafy is an SMS based 2-factor authentication services that uses machine learning to understand the causes of OTP delivery failures and resolves them instantly to ensure your login and sign up OTPs deliver.

The Vereafy Laravel Library Project was created to enable Laravel Developers integrate seamlessly with the Vereafy API.

To use the Vereafy Laravel library, you just need to clone this repo into your existing project directory and do composer install in other to install the dependency

How to Get API Key

Your API Key is first generated when you register an app. To register an app, Login to the Developers Dashboard, Navigate to Apps > Add, Type the name of your app and click Submit. The app will be registered and a new API Key will be generated. Copy the API key into your project

or

Click developer.cecula.com to get started

To Integrate Differently

Place this at the top of your file :

require 'vendor/autoload.php'; //Require php autoload
use Illuminate\Guzzlehttp\guzzle;
use GuzzleHttp\Client;    // Initialize Guzzle client
use GuzzleHttp\Psr7\Request;

$client = new \GuzzleHttp\Client();

$method = 'POST';
$url = 'https://api.cecula.com/twofactor/init';
$header = Array(
    'Content-Type' => 'application/json',
    'authorization' => 'Bearer' // Paste your key here
);

Initialization

The Vereafy 2FA initialization can be as simple as the following lines of code:

     $body = Array( 
    'mobile' => ''

);
$response = $client->request($method, $url, [
    'headers'        => $header,
    'json'  => $body,
]);
    echo $response->getBody();

The initialization method returns a response that should look like this:

         {
            "status":"success",
             "pinRef": "1293488527"
         }

Completion

The Vereafy 2FA completion can be as simple as the following lines of code:

     $body = Array( 
    'pinRef' => '',
    'token' => ''
);

$response = $client->request($method, $url, [
    'headers'        => $header,
    'json'  => $body,
]);

    echo $response->getBody();

The completion method returns a response that should look like this if the parameters are correct:

         {
            "response":"success"
         }

Resend

In a case where your app users get impatient and hits the retry link on your app form, just call the resend method this way:

     $body = Array( 
    'pinRef' => '',
    'mobile' => ''
);

$response = $client->request($method, $url, [
    'headers'        => $header,
    'json'  => $body,
]);

    echo $response->getBody();

The resend method returns a response that should look like this:

         {
             "status": "success",
             "pinRef": 1293488527
         }

Get Balance

To get your balance on Vereafy, the getbalance method is used this way:

        $response = $client->request($method, $url, [
    'headers'        => $header,
]);

    echo $response->getBody();

The method requires no parameter, and the returned response should look like this:

        {
             "balance":1507
        }

Error Responses

In a case where the request fails due to one reason or another you should get an error response from the requested endpoint that looks like this:

        {
            "error":"Invalid PIN Ref",
            "code":"CE2000"
        }

The table below shows a list of error codes and their descriptions

Error Code	Description
CE1001	Missing Fields
CE1002	Empty Fields
CE1006	Not a Nigerian Number
CE2000	Invalid PIN Ref
CE2002	PIN does not reference any verification request
CE2003	Mobile number does not match original request
CE2001	Invalid PIN
CE2004	Request Not Found
CE7000	Verification already succeeded
CE7001	Verification already failed
CE6000	Insufficient Balance
CE5000	Invalid Template ID
CE5001	Could not find referenced template

cecula / vereafy-laravel

Maintainers

Details