/kyc/individual/tin (POST)

保存已有个人用户的税号(TIN)


接口详情

保存个人用户的税号。账户须已存在——请先通过 POST /kyc/individual/pi 创建。响应返回更新后的收集状态,与 GET /kyc/individual/tin 完全一致。

业务规则

  1. 适用范围:税号收集仅适用于 EU 个人账户。为 Non-EU 账户或企业账户保存税号会返回错误。
  2. 取值格式:去除首尾空格后为 6–20 个字符的字符串,覆盖 EU 各国的税号长度范围。请以字符串传递并保留前导零——不要转成数字。星号(*)会被拒绝。
  3. 覆盖行为:再次调用本接口会覆盖已存值。每次保存都必须携带完整的新值,不支持部分更新。
  4. 已通过 KYC 的账户:可用本接口为已通过的账户补交税号。以此方式补交不会重新触发或重置 KYC 申请,只是补上缺失的税号。
  5. 收集不等于核验:保存成功代表税号已收集,并非已校验;核验另行处理。

请求示例

{
  "uid": "example-user",
  "tin": "001234"
}

其他税号收集入口

入口方式
基本信息调用 POST /kyc/individual/pi 时传入 tin(选填)
独立接口(本接口)任意时间保存或替换税号,包括已通过 KYC 的账户
RFILegend 可能通过 RFI 流程向用户索取税号,见 RFI 集成
KYC 续填 SDK用户在 SDK 内完成税号步骤

四个入口读写的是同一份税号数据,因此通过任一入口收集的值会立刻在其他入口体现。

Body Params
string
required

用户唯一标识

string
required

税号(TIN),6–20 个字符,保留前导零。

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json