POST /apiv2/screening

ब्लॉकचेन पते के लिए AML स्क्रीनिंग का ऑर्डर दें: प्रत्येक प्रदाता और ऑर्डर की प्रत्येक स्थिति के लिए एक समान रिस्पॉन्स प्रारूप, स्ट्रिंग के रूप में दशमलव संख्याएं, और एक एकल त्रुटि प्रारूप।

एंडपॉइंट URL

POST https://netts.io/apiv2/screening

अनुरोध हेडर

Header	Required	Description
Content-Type	हाँ	application/json
X-API-KEY	हाँ	Netts डैशबोर्ड से आपकी API कुंजी
X-Idempotency-Key	नहीं	सुरक्षित पुनः प्रयासों के लिए आपकी अपनी कुंजी। देखें Idempotency

अनुरोध बॉडी

json

{
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic",
    "wait_for_result": true
}

पैरामीटर

Parameter	Type	Required	Description
address	string	हाँ	स्क्रीन किया जाने वाला पता, 10–128 वर्ण
network	string	हाँ	नेटवर्क टिकर। प्रत्येक प्रदाता किन टिकरों को कवर करता है, यह GET /apiv2/screening/providers द्वारा सूचीबद्ध है
provider	string	हाँ	`elliptic` या `bitok`। कोई डिफ़ॉल्ट नहीं है
wait_for_result	boolean	नहीं	`true` अधिकतम 15 सेकंड तक परिणाम की प्रतीक्षा करता है। डिफ़ॉल्ट `false`
language	string	नहीं	रिपोर्ट की भाषा। केवल `en`

अज्ञात फ़ील्ड अस्वीकार कर दिए जाते हैं। ऐसा बॉडी जिसमें कोई फ़ील्ड हो जो उपरोक्त तालिका में नहीं है, कोड 4001 के साथ 400 लौटाता है।

provider आवश्यक है और इसका कोई डिफ़ॉल्ट नहीं है। आप हमेशा उस प्रदाता को चुनते हैं जिसके लिए आप भुगतान करते हैं।

provider स्कीमा में एक मुक्त-प्रारूप स्ट्रिंग है, कोई गणना (enumeration) नहीं। आज दो मान स्वीकार किए जाते हैं; कोई तीसरा प्रदाता जुड़ने पर स्कीमा के विरुद्ध प्रतिक्रियाओं को मान्य करने वाले किसी भी व्यक्ति के लिए यह एक ब्रेकिंग बदलाव नहीं होना चाहिए। वर्तमान सूची, प्रत्येक प्रदाता द्वारा कवर किए जाने वाले नेटवर्क और जिस पैमाने पर प्रत्येक स्कोर करता है, वह GET /apiv2/screening/providers से आते हैं।

उदाहरण

cURL — परिणाम की प्रतीक्षा करें

bash

curl -X POST https://netts.io/apiv2/screening \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic",
    "wait_for_result": true
  }'

cURL — स्वीकार करें और पोल करें

bash

curl -X POST https://netts.io/apiv2/screening \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -d '{
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "bitok"
  }'

रिस्पॉन्स Location हेडर के साथ 202 Accepted है जो ऑर्डर की ओर इशारा करता है।

Python

python

import requests
from decimal import Decimal

url = "https://netts.io/apiv2/screening"
headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
}
payload = {
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic",
    "wait_for_result": True,
}

response = requests.post(url, headers=headers, json=payload)

if response.status_code in (200, 202):
    body = response.json()
    print("Order:", body["order"]["client_order_id"])
    print("Status:", body["order"]["status"])
    if body["risk"]["score"] is not None:
        # Parse provider numbers as Decimal, never as float
        print("Score:", Decimal(body["risk"]["score"]), "of", body["risk"]["scale"]["max"])
    print("Level:", body["risk"]["level"], "-", body["risk"]["level_source"])
    print("Charged:", body["billing"]["charged_amount"], body["billing"]["charged_currency"])
else:
    problem = response.json()
    print(problem["code"], problem["title"], "-", problem["detail"])

प्रतिक्रिया कोड

Situation	Code	Headers
ऑर्डर बनाया गया, स्क्रीनिंग पृष्ठभूमि में चल रही है	`202 Accepted`	`Location: /apiv2/screening/{client_order_id}`
परिणाम रिस्पॉन्स में है (`wait_for_result`)	`200 OK`	—
हाल की जांच से परिणाम पुनः उपयोग किया गया, कोई शुल्क नहीं लिया गया	`200 OK`	—
पते पर कोई ब्लॉकचेन गतिविधि नहीं है, कोई शुल्क नहीं लिया गया	`200 OK`	—
त्रुटि	देखें त्रुटियां	`Content-Type: application/problem+json`

स्क्रीनिंग परिणाम ले जाने वाले रिस्पॉन्स Cache-Control: private, no-store के साथ भेजे जाते हैं।

प्रतिक्रिया

json

{
  "schema_version": 2,
  "order": {
    "client_order_id": "A90D21F68C9AEA2",
    "status": "completed",
    "api_version": "v2",
    "cache_hit": false,
    "created_at": "2026-09-13T08:14:29.614988Z",
    "started_at": "2026-09-13T08:14:30.288251Z",
    "completed_at": "2026-09-13T08:14:34.993174Z"
  },
  "request": {
    "address": "YOUR_ADDRESS_HERE",
    "network": "trx",
    "provider": "elliptic"
  },
  "billing": {
    "charged": true,
    "price_usdt": "0.98",
    "base_amount": "2.882421",
    "markup_amount": "0",
    "charged_amount": "2.882421",
    "charged_currency": "TRX",
    "exchange_rate": "0.33999200",
    "payment_status": "pending"
  },
  "precheck": {
    "activity_checked": true,
    "activity_status": "active",
    "source": "tron-address-checker"
  },
  "check": {
    "provider": "elliptic",
    "provider_check_id": "b4903a5d-9f22-4075-b51b-beb40b419b97",
    "checked_at": "2026-09-13T08:14:32.144000Z",
    "status": "completed",
    "provider_status": "complete"
  },
  "risk": {
    "score": "0.9634087310611608",
    "scale": { "min": 0, "max": 10 },
    "level": "low",
    "level_source": "computed",
    "provider_level": null,
    "policy": "netts-risk-v1",
    "by_direction": {
      "source": "0.12332156899576921",
      "destination": "0.9634087310611608"
    }
  },
  "sanctions": {
    "self": false,
    "self_entities": null,
    "exposure": {
      "entity": "HTX (formerly Huobi) - Post-Sanctions - UK Sanctions List - 26 May 2026",
      "category": "Exchange",
      "share_fraction": "0.004409451392423414",
      "proximity": "indirect",
      "hops": 3,
      "direction": "source",
      "rule_name": "Sanctioned, TF & CSAM"
    },
    "items": []
  },
  "exposure": [
    {
      "category": "Exchange",
      "share_fraction": "0.1888065152442461",
      "direction": "source",
      "hops": 2,
      "is_screened_address": false,
      "entities": [
        { "name": "Binance", "category": "Exchange", "is_vasp": true,
          "is_primary": true, "is_after_sanction_date": null }
      ]
    }
  ],
  "rules": [
    { "name": "Sanctioned, TF & CSAM", "type": "exposure", "level": null,
      "score": "0.061426483114820525", "share_fraction": null, "category": null,
      "proximity": null, "direction": "source", "detected_at": null }
  ],
  "entities": [
    { "name": "Unknown", "category": "Unknown", "is_vasp": null,
      "is_primary": true, "is_after_sanction_date": false }
  ],
  "primary_entity": {
    "name": "Unknown", "category": "Unknown", "is_vasp": null,
    "is_primary": true, "is_after_sanction_date": false
  },
  "sanctioned_entities": [],
  "wallet": {
    "inflow_usd": "354663.6116669158",
    "outflow_usd": "80248.63081808022"
  },
  "provider_data": { }
}

फ़ील्ड सेट कभी नहीं बदलता है

ऊपर सूचीबद्ध प्रत्येक ब्लॉक हर रिस्पॉन्स में मौजूद होता है, चाहे कोई भी प्रदाता हो और ऑर्डर की स्थिति कुछ भी हो। जो प्रदाता प्रदान नहीं करता है वह null होता है; एक सूची जिसमें कुछ नहीं है वह null के बजाय [] होती है; एक ब्लॉक जिसमें अभी तक कोई डेटा नहीं है, उसे छोड़ने के बजाय nulls से भरा जाता है। एक ही पार्सर उस जांच को संभालता है जिसे अभी-अभी स्वीकार किया गया है और उसी जांच को जब वह समाप्त हो जाती है।

आपके कोड के लिए दो परिणाम:

उन फ़ील्ड्स को अनदेखा करें जिन्हें आप नहीं जानते हैं। बिना किसी नए संस्करण के इन ब्लॉकों में नए फ़ील्ड जोड़े जाते हैं। किसी अज्ञात फ़ील्ड को अस्वीकार करना आपका बग है, हमारा नहीं;
provider_data अनुबंध का हिस्सा नहीं है। इसका आकार प्रदाता का अनुसरण करता है, और प्रदाता बदलने पर यह बदल जाता है। अनुबंध द्वारा गारंटीकृत सब कुछ उपरोक्त ब्लॉकों में रहता है।

`order`

Field	Type	Description
client_order_id	string	ऑर्डर पहचानकर्ता, बाद में परिणाम पढ़ने के लिए उपयोग किया जाता है
status	string	`pending`, `processing`, `completed`, `skipped`, `failed`
api_version	string	अनुबंध जिसने ऑर्डर बनाया
cache_hit	boolean	`true` जब हाल के परिणाम का पुनः उपयोग किया गया और कोई शुल्क नहीं लिया गया
created_at	string	RFC 3339, UTC, माइक्रोसेकंड
started_at	string \| null	जब प्रदाता कॉल शुरू हुई। `skipped` के लिए `null`
completed_at	string \| null	जब परिणाम आया
error	string	केवल `failed` के लिए: यह क्यों विफल हुआ
reason	string	केवल `skipped` के लिए: `address_inactive`

सभी टाइमस्टैम्प UTC, RFC 3339 हैं, जिनमें Z प्रत्यय और माइक्रोसेकंड सटीकता होती है।

`billing`

Field	Type	Description
charged	boolean	क्या पैसे काटे गए थे
price_usdt	string	USDT में प्रदाता की सूची मूल्य
base_amount	string	उप-उपयोगकर्ता मार्कअप के बिना, चार्ज की गई मुद्रा में ऑर्डर मूल्य
markup_amount	string	उप-उपयोगकर्ता मार्कअप। सीधे खाते के लिए `"0"`
charged_amount	string	शेष राशि से वास्तव में क्या काटा गया
charged_currency	string	`TRX`
exchange_rate	string \| null	रूपांतरण के लिए उपयोग की गई दर
payment_status	string	`paid`, `pending`, `failed`, `not_charged`, `postpaid`

एक सफल जांच के बाद थोड़े समय के लिए payment_status pending रहता है: शुल्क पहले होल्ड पर रखा जाता है और एक घंटे के भीतर निपटारा किया जाता है। failed का अर्थ है कि पैसे वापस कर दिए गए थे। not_charged का अर्थ है कि कभी कोई शुल्क नहीं बनाया गया — एक पुनः उपयोग किया गया परिणाम या एक छोड़ा गया पता। postpaid — देखें Postpaid Accounts।

`precheck`

सशुल्क स्क्रीनिंग से पहले ब्लॉकचेन गतिविधि के लिए पते की जांच की जाती है। बिना किसी गतिविधि वाला पता प्रदाता को नहीं भेजा जाता है और कोई शुल्क नहीं लिया जाता है।

Field	Type	Description
activity_checked	boolean	क्या जांच चली थी। उन नेटवर्कों पर `false` जहां यह मौजूद नहीं है
activity_status	string	`active`, `inactive`, `unknown`
source	string \| null	तंत्र का नाम

unknown सशुल्क स्क्रीनिंग को नहीं रोकता है: यदि गतिविधि सेवा अनुपलब्ध है तो पते को सक्रिय माना जाता है।

`check`

Field	Type	Description
provider	string	प्रदाता जिसने जांच की
provider_check_id	string \| null	प्रदाता का अपना पहचानकर्ता — उनके साथ परिणाम पर विवाद करते समय इसे उद्धृत करें
checked_at	string \| null	जब प्रदाता ने परिणाम दिया
status	string	नीचे दी गई तालिका देखें
provider_status	string \| null	प्रदाता के अपने शब्द, अपरिवर्तित

`order.status`	`check.status`	Meaning
`pending`	`pending`	ऑर्डर स्वीकार कर लिया गया, अभी शुरू नहीं हुआ
`processing`	`running`	प्रदाता इस पर काम कर रहा है
`completed`	`completed`	परिणाम प्राप्त हुआ
`failed`	`failed`	प्रदाता कॉल से पहले या उसके दौरान अस्वीकार कर दिया गया
`skipped`	`not_performed`	पते पर कोई गतिविधि नहीं है; प्रदाता को कभी कॉल नहीं किया गया और कोई शुल्क नहीं लिया गया

`risk`

Field	Type	Description
score	string \| null	प्रदाता का अपना स्कोर, दशमलव स्ट्रिंग के रूप में
scale	object	उस प्रदाता के पैमाने का `min` और `max`
level	string	`none`, `low`, `medium`, `high`, `severe`
level_source	string	`computed` — हमने स्कोर से स्तर प्राप्त किया है; `provider` — प्रदाता ने इसे निर्दिष्ट किया है
provider_level	string \| null	प्रदाता का अपना शब्द, जब वह कोई लौटाता है
policy	string	थ्रेशोल्ड नीति का नाम, `netts-risk-v1`
by_direction	object	स्कोर को `source` और `destination` में विभाजित किया गया है, जब प्रदाता इसे विभाजित करता है

स्कोर को कभी भी रीस्केल नहीं किया जाता है। Elliptic 0–10 और BitOK 0–1 पर चलता है, और एक पैमाने पर 7 किसी भी सार्थक अर्थ में दूसरे पर 0.7 नहीं है। पैमाना रिस्पॉन्स में आता है ताकि एक प्रदाता के विरुद्ध लिखा गया एकीकरण एक कॉन्फ़िगरेशन परिवर्तन के बाद दूसरे को गलत न समझे।

स्तर पूरे API में एक शब्दावली है। जहां प्रदाता अपना स्तर बताता है, हम उसे पास करते हैं और level_source में ऐसा कहते हैं; जहां यह ऐसा नहीं करता है, हम netts-risk-v1 सीमाओं के साथ स्कोर से स्तर प्राप्त करते हैं और इसके बजाय वह कहते हैं। एक ही जांच के लिए API रिस्पॉन्स, डैशबोर्ड और PDF रिपोर्ट में वही शब्द दिखाई देता है।

`exposure[]`, `rules[]`, `entities[]`

exposure[] फंड्स को काउंटरपार्टी श्रेणी के अनुसार विभाजित करता है। rules[] उन प्रदाता के नियमों को सूचीबद्ध करता है जो सक्रिय हुए थे। entities[] उन संस्थाओं को सूचीबद्ध करता है जिनसे पता स्वयं संबंधित है; primary_entity एक निश्चित नियम द्वारा उनमें से एक को चुनता है — वह इकाई जिसे प्रदाता ने प्राथमिक के रूप में चिह्नित किया है, अन्यथा पहली, अन्यथा null। sanctioned_entities[] में entities[] में से वे संस्थाएं शामिल होती हैं जिन्हें प्रतिबंध तिथि के बाद सक्रिय के रूप में चिह्नित किया गया है।

शेयर भिन्न (fractions) हैं, प्रतिशत कभी नहीं

रिस्पॉन्स में प्रत्येक शेयर एक एकल फ़ील्ड, share_fraction है, जो "0" और "1" के बीच एक दशमलव स्ट्रिंग है।

text

Elliptic reports 31.574732212596924 %  ->  "share_fraction": "0.31574732212596924"
BitOK reports    0.8488                ->  "share_fraction": "0.8488"

प्रदाता इकाइयों पर असहमत हैं: एक्सपोजर का वही एक तिहाई हिस्सा एक से 31.57 और दूसरे से 0.3157 के रूप में आता है। प्रदाता को जाने बिना दोनों को ले जाने वाले एकल फ़ील्ड को पढ़ना असंभव होगा। प्रदाता की अपनी इकाइयों में प्रदाता का अपना नंबर provider_data में रहता है।

संख्याएं स्ट्रिंग्स हैं

प्रदाता से आने वाली प्रत्येक संख्या — स्कोर, शेयर, USD वॉल्यूम, और billing में प्रत्येक राशि — एक दशमलव स्ट्रिंग है।

json

"score": "0.9634087310611608"

JavaScript, Go या बाइनरी फ़्लोटिंग पॉइंट वाली किसी भी अन्य भाषा में इसे JSON संख्या के रूप में पार्स करने पर एक सन्निकटन (approximation) मिलता है, और आपके द्वारा प्रिंट किया जाने वाला मान प्रदाता द्वारा जारी किए गए मान से मेल खाना बंद कर देता है। इन फ़ील्ड्स को दशमलव प्रकार के साथ पार्स करें: Python में Decimal, Java में BigDecimal, JavaScript में decimal.Decimal या एक स्ट्रिंग।

वे फ़ील्ड जो प्रदाता के बजाय हमारे हैं — scale.min, scale.max, hops — सामान्य JSON संख्याएं हैं।

हाल के परिणाम का पुनः उपयोग करना

जब आप 60 सेकंड के भीतर उसी पते, नेटवर्क और प्रदाता को फिर से स्क्रीन करते हैं, तो पुराना परिणाम लौटा दिया जाता है और कुछ भी चार्ज नहीं किया जाता है।

प्रत्येक अनुरोध अभी भी अपने स्वयं के client_order_id के साथ अपना स्वयं का ऑर्डर बनाता है; पुनः उपयोग किए गए को "cache_hit": true के रूप में चिह्नित किया गया है और इसका billing ब्लॉक "payment_status": "not_charged" के साथ "charged": false की रिपोर्ट करता है। जिस ऑर्डर से परिणाम आया है उसके पहचानकर्ता का खुलासा नहीं किया जाता है — यह किसी अन्य खाते का हो सकता है।

पुनः उपयोग केवल एक खाते के भीतर होता है। किसी अन्य द्वारा स्क्रीन किया गया परिणाम आपको कभी वापस नहीं किया जाता है।

Idempotency

पुनः प्रयास को सुरक्षित बनाने के लिए अपने स्वयं के मान के साथ X-Idempotency-Key भेजें: समान बॉडी वाली वही कुंजी दूसरी जांच का आदेश देने के बजाय संग्रहीत रिस्पॉन्स लौटाती है।

Situation	Code	Response
इस कुंजी के साथ पहला अनुरोध अभी भी चल रहा है	`409`	`4090`
वही कुंजी, एक भिन्न अनुरोध बॉडी	`409`	`4093`
वही कुंजी, वही बॉडी, पहले ही समाप्त हो चुकी है	संग्रहीत कोड	संग्रहीत रिस्पॉन्स

यदि आप हेडर नहीं भेजते हैं, तो दो सेकंड की विंडो में API कुंजी, पते, प्रदाता और आपके IP पते से आपके लिए एक कुंजी उत्पन्न की जाती है। यह डबल क्लिक और गेटवे पुनः प्रयास से सुरक्षा करता है, एक मिनट बाद दोहराव के खिलाफ नहीं: वह एक वास्तविक नया ऑर्डर है और चार्ज किया जाता है।

त्रुटि प्रतिक्रियाएं

एप्लिकेशन द्वारा उठाई जाने वाली प्रत्येक त्रुटि Content-Type: application/problem+json के साथ RFC 9457 का उपयोग करती है:

json

{
  "type": "https://doc.netts.io/api/v2/errors/insufficient-funds",
  "title": "Insufficient funds",
  "status": 403,
  "detail": "Insufficient funds. Required: 2.888742 TRX, Available: 1.203000 TRX",
  "instance": "/apiv2/screening",
  "code": 1004,
  "required_trx": "2.888742",
  "available_trx": "1.203000"
}

type, title, status, detail और instance मानक फ़ील्ड हैं। संख्यात्मक code एक एक्सटेंशन है: अपने त्रुटि प्रबंधन को इस पर मैच करें। अतिरिक्त फ़ील्ड त्रुटि पर निर्भर करते हैं और जब आप उन्हें नहीं जानते हैं तो उन्हें अनदेखा किया जाना चाहिए।

Code	HTTP	Meaning
`4000`	400	बॉडी मान्य JSON नहीं है
`4001`	400	एक फ़ील्ड सत्यापन में विफल रहा, या एक अज्ञात फ़ील्ड भेजा गया था
`4002`	403	यह प्रदाता आपके खाते के लिए उपलब्ध नहीं है
`4003`	400	विकृत ऑर्डर पहचानकर्ता
`4004`	400	प्रदाता अनुरोधित नेटवर्क का समर्थन नहीं करता है
`4010`	401	कोई API कुंजी नहीं
`4011`	401	API कुंजी या IP पता स्वीकार नहीं किया गया
`4040`	404	ऑर्डर नहीं मिला
`4041`	404	खाता नहीं मिला
`4090`	409	इस idempotency कुंजी के साथ एक अनुरोध अभी भी चल रहा है
`4091`	409	डुप्लिकेट अनुरोध
`4093`	409	इस idempotency कुंजी का उपयोग एक अलग बॉडी के साथ किया गया था
`1004`	403	पर्याप्त शेष राशि नहीं है
`5000`	500	आंतरिक त्रुटि
`5001`	500	शुल्क पूरा नहीं हुआ
`5002`	500	ऑर्डर नहीं बनाया गया था
`5030`	503	प्रदाता अनुपलब्ध है

त्रुटियां जो इस प्रारूप का उपयोग नहीं करती हैं

कुछ विफलताएं एप्लिकेशन तक पहुंचने से पहले गेटवे पर होती हैं, और वे गेटवे का अपना आकार बनाए रखती हैं। ऐसे किसी भी रिस्पॉन्स को इनमें से एक मानें जिसका Content-Type application/problem+json नहीं है:

Situation	HTTP	Body
कोई API कुंजी नहीं, या ऐसी कुंजी जो स्वीकार नहीं की गई है	401	`{"detail":{"code":-1,"msg":"Invalid or missing API key"}}`
दर सीमा पार हो गई	429	`{"message":"API rate limit exceeded"}`
अज्ञात पथ, या एक ऐसी विधि जिसे रूट सेवा नहीं देता है	404 / 405	`{"detail":"Method Not Allowed"}`

दर सीमाएं

5 अनुरोध प्रति सेकंड और 150 प्रति मिनट, सभी स्क्रीनिंग पथों द्वारा साझा किए जाते हैं।

पोस्टपेड खाते

पोस्टपेड बिलिंग पर मौजूद खाते अन्य सभी की तरह समान एंडपॉइंट, URL, हेडर और अनुरोध बॉडी का उपयोग करते हैं। अंतर यह है कि जांच का भुगतान कैसे किया जाता है:

आपकी जमा राशि से कुछ भी नहीं काटा जाता है। अमेरिकी डॉलर में प्रत्येक पूर्ण जांच की कीमत (उदाहरण के लिए, Elliptic के लिए $0.98) आपके अनुबंध में सहमत निपटान मुद्रा में आपकी देय खाता शेष राशि में जोड़ दी जाती है। आप अपने समझौते के अनुसार चालान (invoice) द्वारा इसका भुगतान करते हैं।
आपके खाते की एक क्रेडिट सीमा है। जब तक देय राशि सीमा के भीतर है, शून्य जमा राशि के साथ भी जांच स्वीकार की जाती है।
केवल पूर्ण की गई जांचों का ही बिल भेजा जाता है। विफल रही जांच, बिना किसी गतिविधि वाला पता (skipped) और हाल ही में पुनः उपयोग किए गए परिणाम के लिए कुछ भी खर्च नहीं होता है।

अनुरोध पर Netts द्वारा किसी खाते के लिए पोस्टपेड बिलिंग सक्षम की जाती है।

पोस्टपेड जांच की `billing`

json

"billing": {
    "charged": false,
    "price_usdt": "0.98",
    "base_amount": "2.960725",
    "markup_amount": "0",
    "charged_amount": "2.960725",
    "charged_currency": "TRX",
    "exchange_rate": "0.33100000",
    "payment_status": "postpaid"
}

Field	Description
charged	`false`: जमा राशि से कुछ भी नहीं लिया जाता है
price_usdt	अमेरिकी डॉलर में जांच की कीमत। यह आपके देय शेष में जोड़ी गई राशि है
charged_amount	संदर्भ के लिए TRX में समान कीमत
payment_status	`postpaid`। विफल या छोड़ी गई जांच के लिए — `not_charged`

क्रेडिट सीमा समाप्त (402)

json

{
  "type": "https://doc.netts.io/api/v2/errors/credit-limit-reached",
  "title": "Postpaid credit limit reached",
  "status": 402,
  "detail": "Postpaid credit limit reached.",
  "instance": "/apiv2/screening",
  "code": 1004,
  "payment_mode": "postpaid",
  "reason": "limit_reached"
}

जांच का आदेश नहीं दिया जाता है और कुछ भी बिल नहीं किया जाता है। आपका भुगतान पंजीकृत होने या आपकी सीमा बढ़ाए जाने के बाद नई जांच फिर से स्वीकार की जाती हैं।

पोस्टपेड त्रुटि कोड

Code	HTTP	Description
`1004`	402	पोस्टपेड क्रेडिट सीमा समाप्त हो गई
`5032`	503	कीमत अस्थायी रूप से अनुपलब्ध है
`5034`	503	बिलिंग अस्थायी रूप से अनुपलब्ध है — जांच स्वीकार नहीं की गई थी
`5036`	503	क्रेडिट जांच अस्थायी रूप से अनुपलब्ध है — बाद में पुनः प्रयास करें

ऊपर दिए गए सभी रिस्पॉन्स के लिए कुछ भी ऑर्डर नहीं किया गया है और कुछ भी बिल नहीं किया गया है।

नोट्स

मूल्य निर्धारण: प्रत्येक प्रदाता के लिए प्रति जाँच एक निश्चित मूल्य, देखें GET /apiv2/screening/providers; शुल्क के समय की दर पर TRX बैलेंस से लिया जाता है।
प्रसंस्करण समय: अधिकांश जांच कुछ ही सेकंड में समाप्त हो जाती हैं; लंबे इतिहास वाले पते में तीन मिनट तक का समय लग सकता है। अतुल्यकालिक (asynchronous) मोड का उपयोग करें और परिणाम को GET /apiv2/screening/{client_order_id} के साथ पढ़ें।
निष्क्रिय पते skipped लौटाते हैं और उनसे कोई शुल्क नहीं लिया जाता है।
कच्चा प्रदाता रिस्पॉन्स कभी नहीं लौटाया जाता है। provider_data एक समीक्षित प्रक्षेपण (reviewed projection) है; वे फ़ील्ड जो स्क्रीन किए गए पते के बजाय प्रदाता के पास हमारे खाते से संबंधित हैं, किसी के लिए भी प्रकाशित नहीं किए जाते हैं।

Reports

एंडपॉइंट JSON लौटाता है और कुछ नहीं। कोई PDF नहीं है और कोई Markdown नहीं है।

जिससे एक रिपोर्ट बनती है वह सब कुछ पहले से ही रिस्पॉन्स में है: एकीकृत ब्लॉक और provider_data। इसे अपनी तरफ रेंडर करने से आपको वह दस्तावेज़ मिलता है जो आप वास्तव में चाहते हैं — आपकी ब्रांडिंग, आपकी भाषा, आपका लेआउट — जो विशेष रूप से तब महत्वपूर्ण होता है जब आप जांचों को फिर से बेचते हैं, क्योंकि हमारे नाम वाली रिपोर्ट आपके अपने ग्राहक को सौंपने के लिए गलत दस्तावेज़ है।

यदि आपको किसी तीसरे पक्ष के लिए साक्ष्य — एक बैंक, एक नियामक, एक काउंटरपार्टी — के रूप में एक रिपोर्ट की आवश्यकता है, तो ध्यान दें कि एक अहस्ताक्षरित PDF साक्ष्य नहीं है, चाहे कोई भी इसे जनरेट करे: इसे एक टेक्स्ट एडिटर में एक मिनट में संपादित किया जा सकता है। एक सत्यापन योग्य आर्टिफ़ैक्ट के लिए हस्ताक्षर या सार्वजनिक सत्यापन पृष्ठ की आवश्यकता होती है, और यह एक अलग सुविधा है। यदि यह आपका मामला है, तो हमें बताएं कि आपके काउंटरपार्टी को क्या आवश्यकता है।

समान जांचों के लिए Netts डैशबोर्ड में सत्रह भाषाओं में मानव-पठनीय PDF रिपोर्ट मौजूद हैं।

यह भी देखें

GET /apiv2/screening/{client_order_id} — जांच पढ़ें
GET /apiv2/screening/history — आपकी जांचें, कर्सर पृष्ठांकित
GET /apiv2/screening/providers — प्रदाता, कीमतें, नेटवर्क, पैमाने
GET /apiv2/screening/price — एक प्रदाता की कीमत
Sanctions in an AML result — sanctions क्या कहता है और प्रदाता ध्वज क्या कहता है

POST /apiv2/screening ​

एंडपॉइंट URL ​

अनुरोध हेडर ​

अनुरोध बॉडी ​

पैरामीटर ​

उदाहरण ​

cURL — परिणाम की प्रतीक्षा करें ​

cURL — स्वीकार करें और पोल करें ​

Python ​

प्रतिक्रिया कोड ​

प्रतिक्रिया ​

फ़ील्ड सेट कभी नहीं बदलता है ​

order ​

billing ​

precheck ​

check ​

risk ​

exposure[], rules[], entities[] ​

शेयर भिन्न (fractions) हैं, प्रतिशत कभी नहीं ​

संख्याएं स्ट्रिंग्स हैं ​

हाल के परिणाम का पुनः उपयोग करना ​

Idempotency ​

त्रुटि प्रतिक्रियाएं ​

त्रुटियां जो इस प्रारूप का उपयोग नहीं करती हैं ​

दर सीमाएं ​

पोस्टपेड खाते ​

पोस्टपेड जांच की billing ​

क्रेडिट सीमा समाप्त (402) ​

पोस्टपेड त्रुटि कोड ​

नोट्स ​

Reports ​

यह भी देखें ​

POST /apiv2/screening

एंडपॉइंट URL

अनुरोध हेडर

अनुरोध बॉडी

पैरामीटर

उदाहरण

cURL — परिणाम की प्रतीक्षा करें

cURL — स्वीकार करें और पोल करें

Python

प्रतिक्रिया कोड

प्रतिक्रिया

फ़ील्ड सेट कभी नहीं बदलता है

`order`

`billing`

`precheck`

`check`

`risk`

`exposure[]`, `rules[]`, `entities[]`

शेयर भिन्न (fractions) हैं, प्रतिशत कभी नहीं

संख्याएं स्ट्रिंग्स हैं

हाल के परिणाम का पुनः उपयोग करना

Idempotency

त्रुटि प्रतिक्रियाएं

त्रुटियां जो इस प्रारूप का उपयोग नहीं करती हैं

दर सीमाएं

पोस्टपेड खाते

पोस्टपेड जांच की `billing`

क्रेडिट सीमा समाप्त (402)

पोस्टपेड त्रुटि कोड

नोट्स

Reports

यह भी देखें