POST /apiv2/screening
Tạo một yêu cầu sàng lọc AML cho một địa chỉ blockchain: một cấu trúc phản hồi duy nhất cho mọi nhà cung cấp và mọi trạng thái của đơn hàng, các số thập phân dưới dạng chuỗi, và một định dạng lỗi duy nhất.
URL endpoint
POST https://netts.io/apiv2/screeningHeader của request
| Header | Bắt buộc | Mô tả |
|---|---|---|
| Content-Type | Có | application/json |
| X-API-KEY | Có | Khóa API của bạn từ trang tổng quan Netts |
| X-Idempotency-Key | Không | Khóa riêng của bạn để thử lại an toàn. Xem Tính bất biến (Idempotency) |
Body của request
{
"address": "YOUR_ADDRESS_HERE",
"network": "trx",
"provider": "elliptic",
"wait_for_result": true
}Tham số request
| Tham số | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| address | string | Có | Địa chỉ cần sàng lọc, 10–128 ký tự |
| network | string | Có | Mã mạng (ticker). Các mạng được từng nhà cung cấp hỗ trợ được liệt kê bởi GET /apiv2/screening/providers |
| provider | string | Có | elliptic hoặc bitok. Không có giá trị mặc định |
| wait_for_result | boolean | Không | true sẽ chờ kết quả tối đa 15 giây. Mặc định false |
| language | string | Không | Ngôn ngữ báo cáo. Chỉ hỗ trợ en |
Các trường không xác định sẽ bị từ chối. Phần thân chứa trường không có trong bảng trên sẽ trả về lỗi 400 với mã 4001.
provider là bắt buộc và không có giá trị mặc định. Bạn luôn chọn nhà cung cấp mà bạn thanh toán.
provider là một chuỗi tự do trong lược đồ, không phải là enum. Hiện tại có hai giá trị được chấp nhận; nhà cung cấp thứ ba sẽ không làm phát sinh thay đổi đột ngột (breaking change) cho bất kỳ ai xác thực phản hồi dựa trên lược đồ. Danh sách hiện tại, các mạng mà từng nhà cung cấp hỗ trợ và thang điểm đánh giá được cung cấp từ GET /apiv2/screening/providers.
Ví dụ
cURL — chờ kết quả
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 — tiếp nhận và thăm dò
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"
}'Phản hồi là 202 Accepted với tiêu đề Location trỏ đến đơn hàng.
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"])Mã response
| Tình huống | Mã | Headers |
|---|---|---|
| Đơn hàng đã được tạo, sàng lọc đang chạy ở chế độ nền | 202 Accepted | Location: /apiv2/screening/{client_order_id} |
Kết quả nằm trong phản hồi (wait_for_result) | 200 OK | — |
| Kết quả được tái sử dụng từ lần kiểm tra gần đây, không bị tính phí | 200 OK | — |
| Địa chỉ không có hoạt động blockchain, không bị tính phí | 200 OK | — |
| Lỗi | xem Lỗi | Content-Type: application/problem+json |
Các phản hồi mang kết quả sàng lọc được gửi cùng với tiêu đề Cache-Control: private, no-store.
Response
{
"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": { }
}Bộ trường dữ liệu không bao giờ thay đổi
Mọi khối được liệt kê ở trên đều xuất hiện trong mọi phản hồi, bất kể nhà cung cấp là ai và đơn hàng ở trạng thái nào. Những gì nhà cung cấp không cung cấp sẽ là null; danh sách không có dữ liệu sẽ là [], không phải null; khối chưa có dữ liệu sẽ được điền các giá trị null thay vì bị lược bỏ. Một bộ phân tích cú pháp duy nhất có thể xử lý cả lượt kiểm tra vừa được tiếp nhận và chính lượt kiểm tra đó khi đã hoàn tất.
Hai điểm cần lưu ý đối với mã nguồn của bạn:
- bỏ qua các trường bạn không biết. Các trường mới được thêm vào các khối này mà không phát hành phiên bản mới. Việc từ chối một trường không xác định là lỗi từ phía bạn, không phải từ phía chúng tôi;
provider_datakhông thuộc về hợp đồng cam kết. Cấu trúc của nó phụ thuộc vào nhà cung cấp và thay đổi khi nhà cung cấp thay đổi. Mọi thứ mà hợp đồng cam kết đảm bảo đều nằm trong các khối phía trên.
order
| Trường | Loại | Mô tả |
|---|---|---|
| client_order_id | string | Mã định danh đơn hàng, được sử dụng để đọc kết quả sau này |
| status | string | pending, processing, completed, skipped, failed |
| api_version | string | Hợp đồng đã tạo đơn hàng |
| cache_hit | boolean | true khi kết quả gần đây được tái sử dụng và không tính phí |
| created_at | string | RFC 3339, UTC, microgiây |
| started_at | string | null | Thời điểm lệnh gọi đến nhà cung cấp bắt đầu. null đối với skipped |
| completed_at | string | null | Thời điểm nhận được kết quả |
| error | string | Chỉ dành cho failed: lý do thất bại |
| reason | string | Chỉ dành cho skipped: address_inactive |
Mọi mốc thời gian đều theo định dạng UTC, RFC 3339, với hậu tố Z và độ chính xác tới microgiây.
billing
| Trường | Loại | Mô tả |
|---|---|---|
| charged | boolean | Cho biết có bị trừ tiền hay không |
| price_usdt | string | Giá niêm yết của nhà cung cấp tính bằng USDT |
| base_amount | string | Giá đơn hàng bằng loại tiền tính phí, chưa bao gồm phụ phí người dùng phụ |
| markup_amount | string | Phụ phí người dùng phụ. "0" đối với tài khoản trực tiếp |
| charged_amount | string | Số tiền thực tế đã bị trừ khỏi số dư |
| charged_currency | string | TRX |
| exchange_rate | string | null | Tỷ giá được sử dụng để quy đổi |
| payment_status | string | paid, pending, failed, not_charged, postpaid |
payment_status sẽ ở trạng thái pending trong một thời gian ngắn sau khi kiểm tra thành công: khoản phí được tạm giữ trước và quyết toán trong vòng một giờ. failed nghĩa là tiền đã được hoàn trả. not_charged nghĩa là không có khoản phí nào được tạo — kết quả được tái sử dụng hoặc địa chỉ bị bỏ qua. postpaid — xem Tài khoản trả sau.
precheck
Trước khi thực hiện sàng lọc tính phí, địa chỉ sẽ được kiểm tra hoạt động trên blockchain. Địa chỉ không có hoạt động sẽ không được gửi tới nhà cung cấp và không bị tính phí.
| Trường | Loại | Mô tả |
|---|---|---|
| activity_checked | boolean | Cho biết quá trình kiểm tra đã chạy hay chưa. false trên các mạng không hỗ trợ tính năng này |
| activity_status | string | active, inactive, unknown |
| source | string | null | Tên cơ chế kiểm tra |
unknown không ngăn cản việc sàng lọc tính phí: nếu dịch vụ kiểm tra hoạt động không khả dụng, địa chỉ sẽ được xử lý như trạng thái đang hoạt động.
check
| Trường | Loại | Mô tả |
|---|---|---|
| provider | string | Nhà cung cấp đã thực hiện việc kiểm tra |
| provider_check_id | string | null | Mã định danh riêng của nhà cung cấp — trích dẫn mã này khi khiếu nại kết quả với họ |
| checked_at | string | null | Thời điểm nhà cung cấp đưa ra kết quả |
| status | string | Xem bảng dưới đây |
| provider_status | string | null | Từ ngữ nguyên bản của nhà cung cấp, không bị chỉnh sửa |
order.status | check.status | Ý nghĩa |
|---|---|---|
pending | pending | Đơn hàng đã tiếp nhận, chưa bắt đầu |
processing | running | Nhà cung cấp đang xử lý |
completed | completed | Đã nhận được kết quả |
failed | failed | Bị từ chối trước hoặc trong quá trình gọi nhà cung cấp |
skipped | not_performed | Địa chỉ không có hoạt động; nhà cung cấp chưa từng được gọi và không bị tính phí |
risk
| Trường | Loại | Mô tả |
|---|---|---|
| score | string | null | Điểm số riêng của nhà cung cấp, dưới dạng chuỗi thập phân |
| scale | object | min và max của thang điểm nhà cung cấp đó |
| level | string | none, low, medium, high, severe |
| level_source | string | computed — chúng tôi tính toán mức độ từ điểm số; provider — do nhà cung cấp công bố |
| provider_level | string | null | Từ ngữ riêng của nhà cung cấp, khi họ có trả về |
| policy | string | Tên của chính sách ngưỡng rủi ro, netts-risk-v1 |
| by_direction | object | Điểm số được chia theo source và destination, khi nhà cung cấp có phân chia |
Điểm số không bao giờ được quy đổi lại theo thang khác. Elliptic sử dụng thang 0–10 và BitOK sử dụng thang 0–1, và điểm 7 trên thang này không đồng nghĩa với 0.7 trên thang kia theo bất kỳ nghĩa thực tế nào. Thang điểm được đưa vào phản hồi để hệ thống tích hợp cho một nhà cung cấp không hiểu sai về nhà cung cấp khác chỉ sau một thay đổi cấu hình.
Mức độ rủi ro sử dụng một bộ từ vựng thống nhất trên toàn bộ API. Khi nhà cung cấp nêu rõ mức độ riêng, chúng tôi sẽ chuyển tiếp giá trị đó và ghi rõ trong level_source; nếu không, chúng tôi sẽ tính toán mức độ từ điểm số dựa trên các ngưỡng của netts-risk-v1 và thông báo tương ứng. Cùng một từ sẽ xuất hiện trong phản hồi API, trang tổng quan và báo cáo PDF cho cùng một lượt kiểm tra.
exposure[], rules[], entities[]
exposure[] phân tích dòng tiền theo danh mục đối tác. rules[] liệt kê các quy tắc của nhà cung cấp đã được kích hoạt. entities[] liệt kê các thực thể mà chính địa chỉ đó trực thuộc; primary_entity chọn một trong số đó theo quy tắc cố định — thực thể mà nhà cung cấp đánh dấu là chính, nếu không có thì chọn thực thể đầu tiên, nếu không có nữa thì là null. sanctioned_entities[] chứa các thực thể trong entities[] bị gắn cờ hoạt động sau ngày bị áp đặt lệnh trừng phạt.
Tỷ lệ là phân số, không bao giờ là phần trăm
Mọi tỷ lệ trong phản hồi đều là một trường duy nhất, share_fraction, một chuỗi thập phân giữa "0" và "1".
Elliptic reports 31.574732212596924 % -> "share_fraction": "0.31574732212596924"
BitOK reports 0.8488 -> "share_fraction": "0.8488"Các nhà cung cấp không đồng nhất về đơn vị: cùng một phần ba mức độ phơi nhiễm nhưng một bên trả về 31.57 còn bên kia trả về 0.3157. Một trường duy nhất mang cả hai kiểu sẽ không thể đọc được nếu không biết rõ nhà cung cấp. Con số riêng của nhà cung cấp với đơn vị gốc của họ được lưu trong provider_data.
Số được định dạng dưới dạng chuỗi
Mọi con số đến từ nhà cung cấp — điểm số, tỷ lệ, khối lượng USD và mọi số tiền trong billing — đều là chuỗi thập phân.
"score": "0.9634087310611608"Việc phân tích cú pháp giá trị đó thành số JSON trong JavaScript, Go hoặc bất kỳ ngôn ngữ nào sử dụng dấu phẩy động nhị phân sẽ tạo ra sai số làm tròn, và giá trị bạn in ra sẽ không còn khớp với giá trị nhà cung cấp đã ban hành. Hãy phân tích các trường này bằng kiểu số thập phân chính xác: Decimal trong Python, BigDecimal trong Java, decimal.Decimal hoặc dạng chuỗi trong JavaScript.
Các trường do chúng tôi tự tính toán chứ không phải từ nhà cung cấp — scale.min, scale.max, hops — là các số JSON thông thường.
Tái sử dụng kết quả gần đây
Khi bạn sàng lọc lại cùng một địa chỉ, cùng mạng và cùng nhà cung cấp trong vòng 60 giây, kết quả trước đó sẽ được trả về và không bị tính phí.
Mỗi yêu cầu vẫn tạo đơn hàng riêng với client_order_id riêng; đơn hàng được tái sử dụng được đánh dấu "cache_hit": true và khối billing của nó sẽ báo cáo "charged": false với "payment_status": "not_charged". Mã định danh của đơn hàng gốc tạo ra kết quả đó sẽ không được tiết lộ — vì nó có thể thuộc về tài khoản khác.
Việc tái sử dụng chỉ xảy ra trong phạm vi một tài khoản. Kết quả do người khác sàng lọc sẽ không bao giờ được trả về cho bạn.
Tính bất biến (Idempotency)
Gửi X-Idempotency-Key với giá trị tùy chọn của bạn để việc thử lại được an toàn: cùng một khóa với cùng phần thân yêu cầu sẽ trả về phản hồi đã lưu thay vì tạo thêm lệnh kiểm tra thứ hai.
| Tình huống | Mã | Phản hồi |
|---|---|---|
| Yêu cầu đầu tiên với khóa này vẫn đang chạy | 409 | 4090 |
| Cùng khóa, nhưng phần thân yêu cầu khác | 409 | 4093 |
| Cùng khóa, cùng phần thân, đã xử lý xong | mã đã lưu | phản hồi đã lưu |
Nếu bạn không gửi tiêu đề này, một khóa sẽ được tạo tự động cho bạn từ khóa API, địa chỉ, nhà cung cấp và địa chỉ IP của bạn trong khoảng thời gian hai giây. Cơ chế này giúp chống lại việc nhấn đúp chuột và cổng mạng tự động thử lại, chứ không chống lại việc gửi lặp lại sau một phút: yêu cầu đó được tính là đơn hàng mới hoàn toàn và sẽ bị tính phí.
Phản hồi lỗi
Mọi lỗi do ứng dụng phát sinh đều sử dụng chuẩn RFC 9457 với Content-Type: application/problem+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 và instance là các trường chuẩn. Mã số code là trường mở rộng: hãy dùng nó cho việc xử lý lỗi trong mã nguồn của bạn. Các trường bổ sung tùy thuộc vào từng loại lỗi và phải được bỏ qua nếu bạn không rõ về chúng.
| Mã | HTTP | Ý nghĩa |
|---|---|---|
4000 | 400 | Phần thân không phải JSON hợp lệ |
4001 | 400 | Một trường không vượt qua xác thực, hoặc trường không xác định đã được gửi |
4002 | 403 | Nhà cung cấp không khả dụng cho tài khoản của bạn |
4003 | 400 | Định danh đơn hàng sai định dạng |
4004 | 400 | Nhà cung cấp không hỗ trợ mạng được yêu cầu |
4010 | 401 | Không có khóa API |
4011 | 401 | Khóa API hoặc địa chỉ IP không được chấp nhận |
4040 | 404 | Không tìm thấy đơn hàng |
4041 | 404 | Không tìm thấy tài khoản |
4090 | 409 | Yêu cầu với khóa tính bất biến này vẫn đang chạy |
4091 | 409 | Yêu cầu bị trùng lặp |
4093 | 409 | Khóa tính bất biến này đã được sử dụng với phần thân khác |
1004 | 403 | Không đủ số dư |
5000 | 500 | Lỗi nội bộ |
5001 | 500 | Khoản thanh toán không thành công |
5002 | 500 | Đơn hàng không được tạo |
5030 | 503 | Nhà cung cấp không khả dụng |
Các lỗi không sử dụng định dạng này
Một số lỗi xảy ra ngay tại cổng mạng (gateway), trước khi đến được ứng dụng, và chúng sẽ giữ nguyên định dạng riêng của cổng mạng. Hãy xử lý bất kỳ phản hồi nào có Content-Type không phải là application/problem+json như các lỗi sau:
| Tình huống | HTTP | Body |
|---|---|---|
| Không có khóa API, hoặc khóa không được chấp nhận | 401 | {"detail":{"code":-1,"msg":"Invalid or missing API key"}} |
| Vượt quá giới hạn tần suất | 429 | {"message":"API rate limit exceeded"} |
| Đường dẫn không xác định, hoặc phương thức không được hỗ trợ bởi tuyến đường | 404 / 405 | {"detail":"Method Not Allowed"} |
Giới hạn tần suất
5 yêu cầu mỗi giây và 150 yêu cầu mỗi phút, dùng chung cho tất cả các đường dẫn sàng lọc.
Tài khoản trả sau
Tài khoản sử dụng thanh toán trả sau sử dụng cùng endpoint, URL, tiêu đề và phần thân yêu cầu như tất cả các tài khoản khác. Điểm khác biệt là cách thức thanh toán lượt kiểm tra:
- Không bị trừ tiền vào tiền nạp của bạn. Giá của mỗi lượt kiểm tra hoàn tất tính bằng đô la Mỹ (ví dụ: 0,98 USD cho Elliptic) được cộng vào số dư nợ của tài khoản theo loại tiền quyết toán đã thỏa thuận trong hợp đồng của bạn. Bạn thanh toán số tiền này theo hóa đơn, căn cứ vào thỏa thuận đã ký.
- Tài khoản của bạn có một hạn mức tín dụng. Khi số tiền nợ vẫn nằm trong hạn mức, các lượt kiểm tra vẫn được chấp nhận ngay cả khi số dư tiền nạp bằng 0.
- Chỉ các lượt kiểm tra hoàn tất mới bị lập hóa đơn. Lượt kiểm tra thất bại, địa chỉ không có hoạt động (
skipped) và kết quả gần đây được tái sử dụng đều hoàn toàn miễn phí.
Thanh toán trả sau được Netts kích hoạt cho tài khoản theo yêu cầu.
Khối billing của lượt kiểm tra trả sau
"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"
}| Trường | Mô tả |
|---|---|
| charged | false: không bị trừ tiền từ số dư nạp |
| price_usdt | Giá của lượt kiểm tra tính bằng đô la Mỹ. Đây là số tiền được cộng vào số dư nợ của bạn |
| charged_amount | Cùng mức giá đó tính bằng TRX, dùng để tham khảo |
| payment_status | postpaid. Đối với lượt kiểm tra thất bại hoặc bị bỏ qua — not_charged |
Đạt hạn mức tín dụng (402)
{
"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"
}Lượt kiểm tra không được khởi tạo và không bị tính phí. Các lượt kiểm tra mới sẽ được tiếp nhận trở lại sau khi khoản thanh toán của bạn được ghi nhận hoặc hạn mức của bạn được nâng lên.
Mã lỗi trả sau
| Mã | HTTP | Mô tả |
|---|---|---|
1004 | 402 | Đã đạt hạn mức tín dụng trả sau |
5032 | 503 | Giá tạm thời không khả dụng |
5034 | 503 | Hệ thống thanh toán tạm thời không khả dụng — lượt kiểm tra không được tiếp nhận |
5036 | 503 | Kiểm tra tín dụng tạm thời không khả dụng — vui lòng thử lại sau |
Đối với tất cả các phản hồi trên, không có lượt kiểm tra nào được khởi tạo và không có khoản phí nào được tính.
Ghi chú
- Giá cả: mỗi nhà cung cấp có một mức giá cố định cho mỗi lần kiểm tra, xem GET /apiv2/screening/providers; được trừ từ số dư TRX theo tỷ giá tại thời điểm trừ tiền.
- Thời gian xử lý: hầu hết các lượt kiểm tra hoàn tất trong vài giây; một địa chỉ có lịch sử dài có thể mất tối đa ba phút. Hãy sử dụng chế độ bất đồng bộ và đọc kết quả bằng GET /apiv2/screening/{client_order_id}.
- Địa chỉ không hoạt động trả về
skippedvà không bị tính phí. - Phản hồi thô của nhà cung cấp không bao giờ được trả về.
provider_datalà một góc nhìn đã qua xử lý; các trường thuộc về tài khoản của chúng tôi với nhà cung cấp chứ không liên quan đến địa chỉ được sàng lọc sẽ không được công khai cho bất kỳ ai.
Báo cáo
Endpoint này chỉ trả về JSON và không có gì khác. Không có định dạng PDF và không có Markdown.
Mọi thứ cấu thành một báo cáo đều đã có sẵn trong phản hồi: khối thống nhất và provider_data. Việc hiển thị báo cáo ở phía bạn sẽ giúp bạn có được tài liệu thực sự mong muốn — thương hiệu của bạn, ngôn ngữ của bạn, bố cục của bạn — điều này đặc biệt có ý nghĩa nếu bạn bán lại dịch vụ kiểm tra, bởi vì một báo cáo mang tên chúng tôi sẽ không phù hợp để bàn giao cho khách hàng của chính bạn.
Nếu bạn cần báo cáo làm bằng chứng cho bên thứ ba — ngân hàng, cơ quan quản lý, đối tác — hãy lưu ý rằng bản PDF không có chữ ký số sẽ không được xem là bằng chứng dù do bất kỳ ai tạo ra: nó có thể bị chỉnh sửa bằng trình soạn thảo văn bản chỉ trong một phút. Một chứng từ có thể xác minh được cần có chữ ký số hoặc trang xác minh công khai, và đó là một tính năng khác. Nếu trường hợp của bạn thuộc diện này, hãy cho chúng tôi biết yêu cầu cụ thể từ đối tác của bạn.
Các báo cáo PDF trực quan cho con người đọc vẫn được cung cấp cho cùng các lượt kiểm tra trên trang tổng quan Netts, hỗ trợ mười bảy ngôn ngữ.
Xem thêm
- GET /apiv2/screening/{client_order_id} — đọc thông tin lượt kiểm tra
- GET /apiv2/screening/history — danh sách các lượt kiểm tra của bạn, phân trang bằng con trỏ
- GET /apiv2/screening/providers — nhà cung cấp, giá cả, mạng lưới, thang điểm
- GET /apiv2/screening/price — giá của một nhà cung cấp
- Sanctions in an AML result — ý nghĩa của
sanctionsvà cờ cảnh báo của nhà cung cấp