পিওএস ও রিটেইলের এসএমএস: রিসিট, লয়্যালটি ও বাকির রিমাইন্ডার

curl https://sms-api.bitcommerz.com/v1/messages \
  -H "Authorization: Bearer $BITSMS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-5521-shipped" \
  -d '{"to": "01712345678", "text": "Your order #5521 has shipped."}'

// Node.js 18+ (built-in fetch)
const res = await fetch("https://sms-api.bitcommerz.com/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BITSMS_API_KEY}`,
    "Content-Type": "application/json",
    // Same key on a retry = no duplicate SMS, no double charge.
    "Idempotency-Key": "order-5521-shipped",
  },
  body: JSON.stringify({ to: "01712345678", text: "Your order #5521 has shipped." }),
});
const msg = await res.json();
console.log(res.status, msg.id, msg.status); // 202 "0192…" "queued"

<?php
$ch = curl_init("https://sms-api.bitcommerz.com/v1/messages");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("BITSMS_API_KEY"),
        "Content-Type: application/json",
        "Idempotency-Key: order-5521-shipped",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "to" => "01712345678",
        "text" => "আপনার অর্ডার #5521 পাঠানো হয়েছে।",
    ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 202
echo $body["id"], " ", $body["parts"], " part(s)\n";

import os, requests

res = requests.post(
    "https://sms-api.bitcommerz.com/v1/messages",
    headers={
        "Authorization": f"Bearer {os.environ['BITSMS_API_KEY']}",
        "Idempotency-Key": "order-5521-shipped",
    },
    json={"to": "01712345678", "text": "Your order #5521 has shipped."},
    timeout=10,
)
msg = res.json()
print(res.status_code, msg["id"], msg["status"])  # 202 ... queued

body, _ := json.Marshal(map[string]string{
	"to":   "01712345678",
	"text": "Your order #5521 has shipped.",
})
req, _ := http.NewRequest("POST", "https://sms-api.bitcommerz.com/v1/messages", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("BITSMS_API_KEY"))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Idempotency-Key", "order-5521-shipped")

res, err := http.DefaultClient.Do(req)
if err != nil {
	log.Fatal(err) // safe to retry with the same Idempotency-Key
}
defer res.Body.Close()
var msg struct{ ID, Status string }
json.NewDecoder(res.Body).Decode(&msg)
fmt.Println(res.StatusCode, msg.ID, msg.Status) // 202 ... queued