SuperAPI AI 工具集

sumsub-manage-wallet-address-book

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:把组织控制的加密钱包地址登记到 Sumsub 的 Wallet Address Book,并可将某个地址绑定到具体申请人,使 Sumsub 能自动回答 Travel Rule 交换中的两个问题——该钱包是否属于你、属于哪位用户。未登记的地址会落入人工处理,难以应对高频请求。

主要能力:POST /resources/kyt/walletAddress/import 批量登记组织控制的地址,请求体为 JSON 数组,单次最多 10000 条;POST /resources/api/applicants/{applicantId}/payments 以 cryptoWallet 支付方式登记单个地址到指定申请人。地址簿没有公开的列表、更新或删除接口,需在仪表盘(Transactions and travel rule → Wallet address book)查看或删除。

使用方式:先确认登记地址及其方向,尤其要问清是否包含提现地址(只登记入金地址会导致一类请求静默转人工)。选择端点:多地址、组织级归属用 import;已知申请人的单地址用 payment method。用 sumsub-check-permissions 检查 TRAVEL_RULE 权限。用 ${CLAUDE_SKILL_DIR}/scripts/build_wallet_import.py 构建导入体,再执行 ${CLAUDE_SKILL_DIR}/scripts/import_wallet_addresses.sh <payload.json> 或 ${CLAUDE_SKILL_DIR}/scripts/add_payment_method.sh <applicantId> <payload.json>。

限制与前提:组织必须已关联 VASP,否则导入返回 404 且重试无效;租户需有 Travel Rule 权限;导入端点还要求令牌主体具备 admin 角色。仅使用沙箱 App Token(sbx: 开头),脚本默认拒绝非沙箱令牌,除非设置 SUMSUB_ALLOW_PROD=1。导入返回 {successCount, errorCount, errors[]},属部分成功设计,须如实报告 errorCount 与错误原因。地址条目需提供 walletAddress 或 walletAddressHash 之一;source 字段被忽略,服务端统一标记为 api。applicantId 为 Sumsub 内部 ID,若只有 externalUserId 需先解析。认证细节见 sumsub-api-auth,流程衔接见 sumsub-integrate-travel-rule。