OTP Code

​

Overview

The OTP Code feature allows you to implement secure one-time password authentication through WhatsApp. This provides a familiar and secure way for users to verify their identity during login, registration, or sensitive operations.

​

How It Works

1. Your application requests an OTP code to be sent to a user’s WhatsApp
2. CrunchzApp generates a random code and delivers it via WhatsApp
3. The user enters this code in your application
4. Your application validates the code through the CrunchzApp API

​

Available Methods

​

Request Code

Send a one-time password to a WhatsApp contact.

use CrunchzApp\CrunchzApp;

CrunchzApp::otp('code')
  ->contact('xxx@c.us')
  ->send();

use CrunchzApp\CrunchzApp;

CrunchzApp::otp('code')
  ->contact('xxx@c.us')
  ->send();

​

Validate Code

Verify an OTP code entered by the user.

use CrunchzApp\CrunchzApp;

CrunchzApp::otp('code')
  ->contact('xxx@c.us')
  ->validate('M9TQ');

use CrunchzApp\CrunchzApp;

CrunchzApp::otp('code')
  ->contact('xxx@c.us')
  ->validate('M9TQ');

​

Common Use Cases

​

Error Handling

{
  "success": false,
  "message": "Invalid OTP code",
  "error_code": "OTP_INVALID"
}

{
  "success": false,
  "message": "Invalid OTP code",
  "error_code": "OTP_INVALID"
}

{
  "success": false,
  "message": "OTP code has expired",
  "error_code": "OTP_EXPIRED"
}

{
  "success": false,
  "message": "Too many failed attempts",
  "error_code": "OTP_MAX_ATTEMPTS"
}