post
https://sandboxapi.legendtrading.com/v2/app/kyc/individual/tin
保存已有个人用户的税号(TIN)
接口详情
保存个人用户的税号。账户须已存在——请先通过 POST /kyc/individual/pi 创建。响应返回更新后的收集状态,与 GET /kyc/individual/tin 完全一致。
业务规则
- 适用范围:税号收集仅适用于 EU 个人账户。为 Non-EU 账户或企业账户保存税号会返回错误。
- 取值格式:去除首尾空格后为 6–20 个字符的字符串,覆盖 EU 各国的税号长度范围。请以字符串传递并保留前导零——不要转成数字。星号(
*)会被拒绝。 - 覆盖行为:再次调用本接口会覆盖已存值。每次保存都必须携带完整的新值,不支持部分更新。
- 已通过 KYC 的账户:可用本接口为已通过的账户补交税号。以此方式补交不会重新触发或重置 KYC 申请,只是补上缺失的税号。
- 收集不等于核验:保存成功代表税号已收集,并非已校验;核验另行处理。
请求示例
{
"uid": "example-user",
"tin": "001234"
}其他税号收集入口
| 入口 | 方式 |
|---|---|
| 基本信息 | 调用 POST /kyc/individual/pi 时传入 tin(选填) |
| 独立接口(本接口) | 任意时间保存或替换税号,包括已通过 KYC 的账户 |
| RFI | Legend 可能通过 RFI 流程向用户索取税号,见 RFI 集成 |
| KYC 续填 SDK | 用户在 SDK 内完成税号步骤 |
四个入口读写的是同一份税号数据,因此通过任一入口收集的值会立刻在其他入口体现。