📨 BZ TOPUP SMS API

Endpoint

https://www.sms.bztechlabs.com/sms_api.php

Method: POST (GET-ও চলে) · Auth: Authorization: Bearer YOUR_API_KEY

প্রতি SMS: আপনার account-এর price (default 0.50 BDT)। Price ও balance দেখতে নিচের Balance endpoint ব্যবহার করুন।

cURL

curl -X POST "https://www.sms.bztechlabs.com/sms_api.php" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: order-1001-sms" \
  --data-urlencode "number=01XXXXXXXXX" \
  --data-urlencode "message=Your OTP is 123456"

PHP

<?php
$ch = curl_init('https://www.sms.bztechlabs.com/sms_api.php');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Idempotency-Key: ' . uniqid('sms-', true),
    ],
    CURLOPT_POSTFIELDS => http_build_query([
        'number'  => '01XXXXXXXXX',
        'message' => 'Your OTP is 123456',
    ]),
    CURLOPT_TIMEOUT => 40,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($res);

Python

import requests, uuid

r = requests.post(
    "https://www.sms.bztechlabs.com/sms_api.php",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    data={"number": "01XXXXXXXXX", "message": "Your OTP is 123456"},
    timeout=40,
)
print(r.status_code, r.json())

JavaScript

const res = await fetch("https://www.sms.bztechlabs.com/sms_api.php", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/x-www-form-urlencoded",
  },
  body: new URLSearchParams({ number: "01XXXXXXXXX", message: "Your OTP is 123456" }),
});
console.log(res.status, await res.json());

Success response

{
  "success": true,
  "status": "SUBMITTED",
  "message": "SMS submitted successfully; delivery confirmation depends on provider DLR support",
  "log_id": "SMS-XXXXXXXXXX",
  "message_id": "...",
  "recipients": 1,
  "segments": 1,
  "encoding": "GSM7",
  "sms_count": 1,
  "price_per_sms": 0.5,
  "charged": 0.5,
  "balance": 99.5
}

SUBMITTED মানে provider SMS গ্রহণ করেছে; handset-এ Delivered নিশ্চিত নয়।

SMS length & charge

প্রতিটি মেসেজ অক্ষর-সংখ্যা অনুযায়ী এক বা একাধিক SMS অংশে ভাগ হয়। চার্জ = price_per_sms × SMS অংশ × প্রাপক।

• একটি বাংলা বা ইমোজি অক্ষর থাকলেই পুরো মেসেজ Unicode হিসেবে গোনা হয়।
• ^ { } \ [ ~ ] | € ইংরেজিতে ২ অক্ষর গোনা হয়; ইমোজি ২ অক্ষর।
• সর্বোচ্চ 10 অংশ; বেশি হলে 400 MESSAGE_TOO_LONG।

পাঠানোর আগে খরচ জানতে action=estimate (কিছু পাঠানো বা charge হয় না):

curl -X POST "https://www.sms.bztechlabs.com/sms_api.php?action=estimate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "message=আপনার OTP: 123456" \
  -d "number=01XXXXXXXXX,01YYYYYYYYY"

উত্তরে encoding, segments, sms_count (= অংশ × প্রাপক), estimated_charge ও fits থাকে।

Balance check

curl "https://www.sms.bztechlabs.com/sms_api.php?action=balance" \
  -H "Authorization: Bearer YOUR_API_KEY"

Status & error codes

Best practices

• প্রতিটি আলাদা SMS-এর জন্য নতুন Idempotency-Key দিন; network error-এ একই key দিয়ে retry করুন।
• 202 PROVIDER_RESULT_UNCERTAIN পেলে সাথে সাথে আবার পাঠাবেন না।
• Key leak হলে bot-এ 🔄 Replace API Key চাপুন।