SafeCaller

Developers

Enterprise Risk API

Payout, onboarding বা callback-এর আগে একটি ফোন নম্বরের spam ঝুঁকি ও business verification যাচাই করুন — একটি signed request, milliseconds-এ উত্তর।

Signed & scoped

HMAC-signed requests, একবারই ব্যবহারযোগ্য nonces, IP allowlists এবং প্রতি client-এর scopes।

একবারে একটি নম্বর

সিদ্ধান্তের জন্য — data mining-এর জন্য নয়। Batch input নেই, directory export নেই।

Privacy by design

শুধু verified ব্যবসার নাম দেওয়া হয়। আপনি যে নম্বর যাচাই করেন তা আমরা সংরক্ষণ করি না।

Request
import hashlib, hmac, json, secrets, time, requests

path = "/enterprise/v1/risk-check"
body = json.dumps({"number": "+918041234567"})
ts, nonce = str(int(time.time())), secrets.token_hex(16)
canonical = "\n".join([ts, nonce, "POST", path,
                        hashlib.sha256(body.encode()).hexdigest()])
sig = hmac.new(SECRET.encode(), canonical.encode(),
               hashlib.sha256).hexdigest()

r = requests.post("https://api.synsafecaller.com" + path, data=body,
    headers={"Content-Type": "application/json", "X-SSC-Key": KEY_ID,
             "X-SSC-Timestamp": ts, "X-SSC-Nonce": nonce,
             "X-SSC-Signature": sig})
200 OKResponse~40 ms
{
  "request_id": "5b1f0c2e-8c4d-4a6e-9d51-2f7c3a9e1b20",
  "number": "+918041234567",
  "verification": {
    "status": "verified_business",
    "business_name": "Acme Bank",
    "purpose": "support"
  },
  "risk": { "level": "low", "confidence": "high", "category": null },
  "ttl_seconds": 3600,
  "v": 1
}

আপনি যা পাবেন

verification.status
verified_business, claimed বা unverified
verification.business_name
শুধু verified ব্যবসার জন্য — কোনো ব্যক্তির নাম কখনও নয়
risk.level
unknown, low, medium, elevated বা high — community reports ও burst detection থেকে
risk.category
সবচেয়ে বেশি report হওয়া বিভাগ, যেমন loan_fraud বা telemarketing

Limits & নিরাপত্তা

  • প্রতি client-এর জন্য default 10 requests / second
  • Contract অনুযায়ী মাসিক quota
  • ±5 মিনিটের timestamp window, nonces পুনরায় ব্যবহার করা যায় না
  • জরুরি নম্বর (112, 100, 108…) কখনও score হয় না

কাদের জন্য

  • ব্যাংক ও NBFC — অ্যাকাউন্টের তথ্য দেওয়ার আগে কলার verify করুন
  • Fintech & payments — payout ও refund নম্বরের ঝুঁকি যাচাই
  • Collections & support teams — callback নম্বরটি আসল কিনা নিশ্চিত করুন

API access নিন

উদ্দেশ্যের সীমাসহ contract-এর মাধ্যমেই access। আপনার use case ও প্রত্যাশিত volume জানান।

আমাদের সাথে কথা বলুন — contact@synsafecaller.com

Python, Node.js ও PHP উদাহরণসহ integration guide অনুমোদিত clients-কে দেওয়া হয়।