Verify One - OTP Verified System

Webhook Documentation

Choose between Email or SMS webhook receivers. Includes sample payloads, validation rules, and response examples.

API Docs

🔗 Endpoint

POST https://verifyone.bhanguz.com/api/webhooks/otp-response

📥 Request Parameters

Parameter	Type	Required	Description
log_id	string	Yes	Unique ID of the OTP log in your system.
to	string	Yes	Registered user email receiving the OTP.
status	string	Yes	Status of delivery: `verified` \| `failed`.

📤 Sample Request

{
  "log_id": "abc123xyz",
  "to": "user@example.com",
  "status": "verified"
}

✅ Success Response

{
  "error": 0,
  "message": "Webhook received",
  "data": {
    "log_id": "abc123xyz",
    "to": "user@example.com",
    "status": "verified"
  }
}

❌ Error Responses

{
  "error": 1,
  "message": "Log ID not found"
}

{
  "error": 2,
  "message": "Email mismatch"
}

🔗 Endpoint

POST https://verifyone.bhanguz.com/api/webhooks/otp-response

📥 Request Parameters

Parameter	Type	Required	Description
log_id	string	Yes	Unique ID of the OTP log in your system.
to	string	Yes	Registered user phone receiving the OTP.
status	string	Yes	Status of delivery: `verified` \| `failed`.

📤 Sample Request

{
  "log_id": "abc123xyz",
  "to": "9876543210",
  "status": "failed"
}

✅ Success Response

{
  "error": 0,
  "message": "Webhook received",
  "data": {
    "log_id": "abc123xyz",
    "to": "9876543210",
    "status": "failed"
  }
}

❌ Error Responses

{
  "error": 1,
  "message": "Log ID not found"
}

{
  "error": 2,
  "message": "Phone mismatch"
}

{
  "error": 3,
  "message": "OTP already used or expired"
}

🔖 General Notes

Webhook requests are always POST with Content-Type: application/json.
Validate log_id against your otp_logs table.
Use a secret header or IP restriction to ensure authenticity.
Always respond with HTTP 200 on success.
Log raw payloads for debugging (rotate logs regularly).

Webhook Documentation

API Docs

🔗 Endpoint

📥 Request Parameters

📤 Sample Request

✅ Success Response

❌ Error Responses

🔗 Endpoint

📥 Request Parameters

📤 Sample Request

✅ Success Response

❌ Error Responses

🔖 General Notes

VerifyOne is available for all devices

Our Office

Quick Links