/kyc/individual/tin

查询个人用户的税号(TIN)收集状态


接口详情

查询个人用户的税号(TIN)收集状态:已收集的税号、收集状态、提交时间,以及该账户当前是否必须提供税号。

适用范围

税号收集适用于账户区域为 EU 的个人用户,不适用于 Non-EU 账户或企业(KYB)账户。账户区域以账户本身为准,而不是请求中传入的国家——账户无法通过传入其他国家的代码来规避或触发该要求。

返回字段

字段说明
tin已收集的税号,始终以 ****** 返回;尚未收集时为字符串 ''。任何查询类接口都不会返回明文税号
tin_status收集状态:not_provided(尚未收集)、submitted(已收集)。收集仅代表已记录该值,不代表税号已通过核验
tin_submitted_at税号收集的 UTC 时间;尚未收集时为 null
tin_required该账户是否必须提供税号:EU 个人账户且尚未收集时为 true,其余情况为 false
⚠️

税号对调用方而言是只写的。所有查询与保存响应中,已收集的值一律返回 ******——不存在返回明文税号的接口,也不提供部分位数回显。

相关接口

Query Params
string
required

用户唯一标识

Responses

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