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 ना दिली जाते.