提交实名更新 - EasyPay API

请求参数

Path 参数

必需

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

legal_entity

object (LegalEntity)

必需

type

enum<string>

实体类型

必需

枚举值:

PERSONCOMPANY

region

string

必需

国家地区代码（填写值请参考 ISO 3166-1 alpha-2）

name

string

姓名或企业名称

必需

company_name_en

string

必需

[企业] 企业英文名
支持 a-z, A-Z, 0-9 / - ? : ( ) . , + 空格

dob

string

必需

出生日期或企业成立日期（格式为 2020-01-01）

gender

enum<string> | enum<null>

[个人] 性别

可选

枚举值:

MALEFEMALE

string

邮箱

必需

phone_country

string | null

可选

填写值请参考 Country Calling Codes

phone

string

联系方式

必需

address

string

必需

居住地址或企业注册地址

address_en

string

必需

注册地址若是英文和注册地址一致,若是中文请翻译成英文填写(2025-04-28 起会强制校验必填)

address_proof_image

string

地址证明

可选

occupation

enum<string> | enum<null>

[个人] 职业

可选

枚举值:

党的机关、国家机关、群众团体和社会组织、企事业单位负责人专业技术人员办事人员和有关人员社会生产服务和生活服务人员农、林、牧、渔业生产及辅助人员生产制造及有关人员军人不便分类的其他从业人员

company_type

enum<string> | enum<null>

[企业] 企业类型

可选

枚举值:

有限责任公司合资企业外资企业国有企业私营企业股份制企业集体所有制企业个体工商户其他

business_scope

string

[企业] 经营范围

可选

industry

enum<string> | enum<null>

可选

[企业必输] 所属行业

枚举值:

农、林、牧、渔业采矿业制造业电力、热力、燃气及水生产和供应业建筑业批发和零售业交通运输、仓储和邮政业住宿和餐饮业信息传输、软件和信息技术服务业金融业房地产业租赁和商务服务业科学研究和技术服务业水利、环境和公共设施管理业居民服务、修理和其他服务业教育卫生和社会工作文化、体育和娱乐业公共管理、社会保障和社会组织国际组织

website

string | null

[企业] 公司网址

可选

id_type

enum<string> | enum<null>

[个人] 证件类型

可选

枚举值:

ID_CARDPASSPORT

id_card_number

string | null

[个人] 身份证号

可选

id_card_front_image

string | null

可选

[个人] 身份证正面图片

id_card_back_image

string | null

可选

[个人] 身份证背面图片

id_card_handheld_image

string | null

可选

[个人] 身份证手持图片

passport_number

string | null

[个人] 护照号

可选

passport_front_image

string | null

可选

[个人] 护照正面图片

passport_handheld_image

string | null

可选

[个人] 护照手持图片

license_number

string | null

可选

[大陆企业] 营业执照号

license_image

string | null

可选

[大陆企业] 营业执照图片

br_number

string | null

可选

[香港企业] 商业登记证编号

br_image

string | null

可选

[香港企业] 商业登记证

cr_number

string | null

可选

[非大陆企业] 公司注册证明书编号

cr_image

string | null

可选

[非大陆企业] 公司注册证明书照片

nc1_images

array[string] | null

可选

[非大陆企业] 法团成立表格

ownership_structure_image

string | null

可选

[企业] 企业股权架构图

aoa

string | null

可选

[香港企业] 公司章程（文件）

issue_date

string

证件发行日期

必需

expiry_date

string

证件失效日期

必需

issue_agency

string

必需

[个人] 证件发行机构

documents

array[string] | null

[企业] 补充材料

可选

owner

object (Owner)

可选

[企业] 法人或董事

shareholders

array[object (Shareholder) {32}] | null

[企业] 股东

可选

示例

{
  "legal_entity": {
    "type": "PERSON",
    "region": "string",
    "name": "string",
    "company_name_en": "string",
    "dob": "string",
    "gender": "MALE",
    "email": "string",
    "phone_country": "string",
    "phone": "string",
    "address": "string",
    "address_en": "string",
    "address_proof_image": "string",
    "occupation": "党的机关、国家机关、群众团体和社会组织、企事业单位负责人",
    "company_type": "有限责任公司",
    "business_scope": "string",
    "industry": "农、林、牧、渔业",
    "website": "string",
    "id_type": "ID_CARD",
    "id_card_number": "string",
    "id_card_front_image": "string",
    "id_card_back_image": "string",
    "id_card_handheld_image": "string",
    "passport_number": "string",
    "passport_front_image": "string",
    "passport_handheld_image": "string",
    "license_number": "string",
    "license_image": "string",
    "br_number": "string",
    "br_image": "string",
    "cr_number": "string",
    "cr_image": "string",
    "nc1_images": [
      "string"
    ],
    "ownership_structure_image": "string",
    "aoa": "string",
    "issue_date": "string",
    "expiry_date": "string",
    "issue_agency": "string",
    "documents": [
      "string"
    ],
    "owner": {
      "type": "PERSON",
      "region": "CN",
      "name": "string",
      "dob": "string",
      "address": "string",
      "address_proof_image": "string",
      "id_type": "ID_CARD",
      "id_card_number": "string",
      "id_card_front_image": "string",
      "id_card_back_image": "string",
      "id_card_handheld_image": "string",
      "passport_number": "string",
      "passport_front_image": "string",
      "passport_handheld_image": "string",
      "issue_date": "string",
      "expiry_date": "string",
      "issue_agency": "string"
    },
    "shareholders": [
      {
        "type": "PERSON",
        "region": "string",
        "name": "string",
        "dob": "string",
        "address": "string",
        "address_proof_image": "string",
        "company_type": "有限责任公司",
        "business_scope": "string",
        "industry": "农、林、牧、渔业",
        "id_type": "ID_CARD",
        "id_card_number": "string",
        "id_card_front_image": "string",
        "id_card_back_image": "string",
        "id_card_handheld_image": "string",
        "passport_number": "string",
        "passport_front_image": "string",
        "passport_handheld_image": "string",
        "license_number": "string",
        "license_image": "string",
        "br_number": "string",
        "br_image": "string",
        "cr_number": "string",
        "cr_image": "string",
        "nc1_images": [
          "string"
        ],
        "ownership_structure_image": "string",
        "aoa": "string",
        "issue_date": "string",
        "expiry_date": "string",
        "issue_agency": "string",
        "ratio": "string",
        "documents": [
          "string"
        ],
        "shareholders": [
          {}
        ]
      }
    ]
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://demo-api.easypayx.com/v3/legal_entity_requests//submit' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "legal_entity": {
        "type": "PERSON",
        "region": "string",
        "name": "string",
        "company_name_en": "string",
        "dob": "string",
        "gender": "MALE",
        "email": "string",
        "phone_country": "string",
        "phone": "string",
        "address": "string",
        "address_en": "string",
        "address_proof_image": "string",
        "occupation": "党的机关、国家机关、群众团体和社会组织、企事业单位负责人",
        "company_type": "有限责任公司",
        "business_scope": "string",
        "industry": "农、林、牧、渔业",
        "website": "string",
        "id_type": "ID_CARD",
        "id_card_number": "string",
        "id_card_front_image": "string",
        "id_card_back_image": "string",
        "id_card_handheld_image": "string",
        "passport_number": "string",
        "passport_front_image": "string",
        "passport_handheld_image": "string",
        "license_number": "string",
        "license_image": "string",
        "br_number": "string",
        "br_image": "string",
        "cr_number": "string",
        "cr_image": "string",
        "nc1_images": [
            "string"
        ],
        "ownership_structure_image": "string",
        "aoa": "string",
        "issue_date": "string",
        "expiry_date": "string",
        "issue_agency": "string",
        "documents": [
            "string"
        ],
        "owner": {
            "type": "PERSON",
            "region": "CN",
            "name": "string",
            "dob": "string",
            "address": "string",
            "address_proof_image": "string",
            "id_type": "ID_CARD",
            "id_card_number": "string",
            "id_card_front_image": "string",
            "id_card_back_image": "string",
            "id_card_handheld_image": "string",
            "passport_number": "string",
            "passport_front_image": "string",
            "passport_handheld_image": "string",
            "issue_date": "string",
            "expiry_date": "string",
            "issue_agency": "string"
        },
        "shareholders": [
            {
                "type": "PERSON",
                "region": "string",
                "name": "string",
                "dob": "string",
                "address": "string",
                "address_proof_image": "string",
                "company_type": "有限责任公司",
                "business_scope": "string",
                "industry": "农、林、牧、渔业",
                "id_type": "ID_CARD",
                "id_card_number": "string",
                "id_card_front_image": "string",
                "id_card_back_image": "string",
                "id_card_handheld_image": "string",
                "passport_number": "string",
                "passport_front_image": "string",
                "passport_handheld_image": "string",
                "license_number": "string",
                "license_image": "string",
                "br_number": "string",
                "br_image": "string",
                "cr_number": "string",
                "cr_image": "string",
                "nc1_images": [
                    "string"
                ],
                "ownership_structure_image": "string",
                "aoa": "string",
                "issue_date": "string",
                "expiry_date": "string",
                "issue_agency": "string",
                "ratio": "string",
                "documents": [
                    "string"
                ],
                "shareholders": [
                    {}
                ]
            }
        ]
    }
}'

返回响应

🟢200OK

application/json

Body

data

object (LegalEntityRequest)

必需

string

实名更新请求 ID

必需

account_id

string

账户 ID

必需

reason

array [object {2}]

原因

必需

status

enum<string>

状态

必需

枚举值:

INITSUBMITTEDREJECTEDSUCCESS

reject_reason

string | null

驳回原因

可选

create_time

string

创建时间

必需

update_time

string

更新时间

必需

completed_time

string | null

完成时间

可选

示例

{
  "data": {
    "id": "string",
    "account_id": "string",
    "reason": [
      {
        "code": "string",
        "message": "string"
      }
    ],
    "status": "INIT",
    "reject_reason": "string",
    "create_time": "string",
    "update_time": "string",
    "completed_time": "string"
  }
}