端點
POST
/v1/screen/transaction私有預覽提交交易、客戶、交易對手和 Travel Rule 上下文以進行配置的篩選決策。為租戶啟用的欄位取決於實施合約。
請求
curl -X POST "https://TENANT_BASE_URL/v1/screen/transaction" \
-H "Authorization: Bearer YOUR_TENANT_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: txn_8f72b1c4e5d9" \
-d '{
"transaction_id": "txn_8f72b1c4e5d9",
"sender": {"id": "cus_sender_01", "entity_type": "individual"},
"recipient": {"id": "cus_recipient_01", "entity_type": "individual"},
"amount": {"value": "50000.00", "currency": "USDT"},
"network": "ethereum",
"travel_rule": {"required": true}
}'請求欄位
| 領域 | 類型 | 要求 | 目的 |
|---|---|---|---|
| transaction_id | string | 必填 | 跨決策和證據使用穩定的業務標識符 |
| sender | object | 必填 | 發起方參考和允許的上下文 |
| recipient | object | 必填 | 受益人或交易對手的參考資料和允許的背景 |
| amount | object | 必填 | 作為字串加資產或貨幣的十進制值 |
| network | string | 有條件的 | 交易使用的網或鐵路 |
| travel_rule | object | 有條件的 | 適用性和交換環境 |
回應範例
{
"transaction_id": "txn_8f72b1c4e5d9",
"uway_reference": "scr_7d3a91c2",
"status": "review",
"risk_level": "medium",
"reason_codes": ["COUNTERPARTY_CONTEXT_REQUIRED"],
"evidence_refs": ["ev_14f2"],
"policy_version": "tenant-policy-2026-08"
}處理回應
在採取不可逆轉的操作之前，保留業務識別碼、UWAY 參考、狀態、原因代碼、證據參考和政策版本。如果分析師審查或合作夥伴交換更改了情況，則同步回應後面可能會出現 Webhook。
故障處理
- 使用相同的冪等性金鑰重試網路逾時。
- 不要將 HTTP 或解析失敗視為已核准的交易。
- 根據機構的降級服務政策路由不可用或不完整的決策。
- 保留錯誤代碼和相關參考以供支援和審核。