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 க்கும் இயல்பாக வினாடிக்கு 10 requests
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 க்கு வழங்கப்படும்.