sendchamp-verify-send-otp

Sendchamp Verify — Send OTP

Overview

Sendchamp Verification API manages OTP generation, multi-channel delivery, and confirmation. One API covers SMS, email, WhatsApp, and voice — change only the channel parameter.

Channel	Best for
sms	Phone verification, 2FA (widest reach in Africa)
whatsapp	Lower cost where WhatsApp is primary
email	Account verification
voice	Accessibility / SMS delivery issues

For SMS routing rules in Nigeria, pair with skill sendchamp-sms-send-message.

Prerequisites

• Sendchamp account with funded wallet
• Approved sender ID (for SMS/WhatsApp channels)
• SENDCHAMP_ACCESS_KEY environment variable

Quickstart

Step 1 — Send OTP

curl

curl -X POST https://api.sendchamp.com/api/v1/verification/send \
  -H "Authorization: Bearer $SENDCHAMP_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "sms",
    "customer_mobile_number": "+2348012345678",
    "sender": "MyBrand",
    "token_type": "numeric",
    "token_length": 6,
    "expiration_time": 10
  }'

Node.js

const sendRes = await fetch("https://api.sendchamp.com/api/v1/verification/send", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SENDCHAMP_ACCESS_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    channel: "sms",
    customer_mobile_number: "+2348012345678",
    sender: "MyBrand",
    token_type: "numeric",
    token_length: 6,
    expiration_time: 10,
  }),
});
const { data } = await sendRes.json();
// Save data.reference server-side — do NOT send data.token to client

Step 2 — Confirm OTP

curl -X POST https://api.sendchamp.com/api/v1/verification/confirm \
  -H "Authorization: Bearer $SENDCHAMP_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "verification_code": "482910",
    "verification_reference": "MN-OTP-abc123"
  }'

const confirmRes = await fetch("https://api.sendchamp.com/api/v1/verification/confirm", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SENDCHAMP_ACCESS_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    verification_code: userCode,
    verification_reference: storedReference,
  }),
});
const confirm = await confirmRes.json();
if (confirm.data?.status === "verified") {
  // User verified — grant access
}