post
https://sandboxapi.legendtrading.com/v2/app/kyc/entity/general
该接口用于企业级客户的KYB(Know Your Business,了解你的企业)基本信息收集。通过提交企业的注册信息、联系方式、地址等多维度数据,完成企业身份信息的初步采集与验证。
请求参数字段说明
数据来源字典 表示读取字典接口数据,参数名 field 为当前字段名,字段存储之为字典的code。
| 字段名 | 类型 | 必填 | 说明 | 数据来源 |
|---|---|---|---|---|
| uid | string | 是 | 用户ID | |
| account_email | string | 是 | 账户电子邮箱 | |
| entity_type | string | 是 | 公司类型 | 字典 |
| entity_legal_name | string | 是 | 企业法定全称 | |
| entity_legal_identifier | string | 是 | 企业法定注册号/识别码 | |
| trade_name | string | 否 | 企业商号/经营用名称 | |
| tax_identification_number | string | 否 | 税号,仅注册国家(country_of_formation)是US的需要,其他即使传递了,也不会保存。 | |
| country_of_formation | string | 是 | 企业注册国家/地区,ISO2 country code,两位字符串,例如: | 国家接口 |
| date_of_formation | string | 是 | US企业成立日期,格式:YYYY-MM-DD | |
| phone_country_code | string | 是 | 电话国家代码(带+号),可以读取国家接口的phone_calling_code字段 | 国家接口 |
| phone_country_code_short | string | 是 | 电话国家代码(短格式,如US),可以读取国家接口的country_iso2_code字段 | 国家接口 |
| phone_number | string | 是 | 联系电话号码 | |
| company_website | string | 否 | 企业官网地址 | |
| num_of_employees | string | 否 | 员工规模区间 | 字典 |
| telegram | string | 是 | Telegram联系方式 | |
| registered_country | string | 是 | 注册地址国家,ISO2 country code,两位字符串,例如: | 国家接口 |
| registered_city | string | 是 | 注册地址城市 | |
| registered_state | string | 是 | 注册地址州/省,纽约禁止注册 | 州接口 |
| registered_zipcode | string | 是 | 注册地址邮政编码 | |
| registered_address1 | string | 是 | 注册地址第一行,最少5个字符 | |
| registered_address2 | string | 否 | 注册地址第二行 | |
| business_country | string | 是 | 实际经营地址国家,ISO2 country code,两位字符串,例如: | 国家接口 |
| business_city | string | 是 | 实际经营地址城市 | |
| business_state | string | 是 | 实际经营地址州/省 | 州接口 |
| business_zipcode | string | 是 | 实际经营地址邮政编码 | |
| business_address1 | string | 是 | 实际经营地址第一行,最少5个字符 | |
| business_address2 | string | 否 | 实际经营地址第二行 |
请求示例
{
"uid": "123456",
"account_email": "[email protected]",
"entity_type": "holding_company",
"entity_legal_name": "Acme Corporation Ltd",
"entity_legal_identifier": "ACM123456789",
"trade_name": "Acme Corp",
"tax_identification_number": "12-3456789",
"country_of_formation": "FI",
"date_of_formation": "2020-01-15",
"phone_country_code": "+1",
"phone_country_code_short": "US",
"phone_number": "4155550123",
"company_website": "https://www.acmecorp.com",
"num_of_employees": "51_100_employees",
"telegram": "@acmecorp123",
"registered_country": "US",
"registered_city": "test city name",
"registered_state": "American Samoa",
"registered_zipcode": "94102",
"registered_address1": "123 Main Street, Suite 100, Downtown",
"registered_address2": "Building A, Floor 5",
"business_country": "AT",
"business_city": "test city name",
"business_state": "Bundesland Tirol",
"business_zipcode": "94103",
"business_address1": "456 Market Street, Office Tower",
"business_address2": "Suite 200"
}