商户入网申请
POST
/api/v2/merch/onboard/apply
商户入网v2
请求参数
Header 参数
X-Merch-Id
string
可选
默认值:
M24061911365700670
Body 参数application/json
request_id
string
必需
>= 1 字符<= 32 字符
contact_person
object
联系人信息
phone_prefix
string
必需
>= 0 字符<= 5 字符
phone
string
必需
>= 0 字符<= 64 字符
email
string
必需
>= 0 字符<= 64 字符
license
object
企业信息
region
string
必需
>= 0 字符<= 2 字符
ent_name
string
必需
>= 0 字符<= 128 字符
ent_name_en
string
必需
>= 0 字符<= 128 字符
found_date
string <date>
成立日期
registered_currency
string
必需
>= 0 字符<= 3 字符
registered_capital
number
必需
address
object
企业注册地址信息
legal_rep_name
string
可选
>= 0 字符<= 128 字符
license_file_id
integer <int32>
可选
ent_type
string
可选
uni_social_credit
string
可选
>= 0 字符<= 18 字符
busi_from
string <date>
可选
busi_end
string <date>
可选
long_term
boolean
可选
br_no
string
可选
br_file_id
integer <int32>
可选
annual_return_file_id
integer <int32>
可选
incorporation_form_file_id
integer <int32>
可选
br_expiry_date
string <date>
可选
cr_issue_date
string <date>
可选
company_article_file_id
integer <int32>
可选
cr_file_id
integer <int32>
可选
cr_no
string
可选
share_structure_file_id
integer <int32>
可选
cr_expiry_date
string <date>
可选
other_file_ids
array[integer <int32>]
其他附件
business
object
企业经营信息
industry
integer <int32>
必需
employee_number
string
必需
address
object
企业经营地址信息
export_country
array[string]
必需
export_type
array[string]
必需
trade_volume
string
必需
website
string
可选
>= 0 字符<= 200 字符
stakeholder_list
array [object {15}]
必需
identity_type
string
必需
name
string
必需
>= 0 字符<= 128 字符
nationality
string
必需
>= 0 字符<= 2 字符
birth_date
string <date>
必需
address_proof_file_id
integer <int32>
可选
doc_type
string
必需
id_number
string
必需
>= 0 字符<= 18 字符
doc_address
string
可选
>= 0 字符<= 256 字符
doc_non_portrait_side_file_id
integer <int32>
可选
doc_portrait_side_file_id
integer <int32>
证件正面文件
eff_date_start
string <date>
必需
eff_date_end
string <date>
可选
long_term
boolean
可选
share
number
可选
resident_address
object
居住地址信息
示例
{
"request_id": "string",
"contact_person": {
"phone_prefix": "strin",
"phone": "string",
"email": "string"
},
"license": {
"region": "st",
"ent_name": "string",
"ent_name_en": "string",
"found_date": "2019-08-24",
"registered_currency": "str",
"registered_capital": 0,
"address": {
"province": "string",
"city": "string",
"zipcode": "string",
"address1": "string",
"address2": "string"
},
"legal_rep_name": "string",
"license_file_id": 0,
"ent_type": "string",
"uni_social_credit": "string",
"busi_from": "2019-08-24",
"busi_end": "2019-08-24",
"long_term": true,
"br_no": "string",
"br_file_id": 0,
"annual_return_file_id": 0,
"incorporation_form_file_id": 0,
"br_expiry_date": "2019-08-24",
"cr_issue_date": "2019-08-24",
"company_article_file_id": 0,
"cr_file_id": 0,
"cr_no": "string",
"share_structure_file_id": 0,
"cr_expiry_date": "2019-08-24",
"other_file_ids": [
0
]
},
"business": {
"industry": 0,
"employee_number": "string",
"address": {
"province": "string",
"city": "string",
"zipcode": "string",
"address1": "string",
"address2": "string"
},
"export_country": [
"string"
],
"export_type": [
"string"
],
"trade_volume": "string",
"website": "string"
},
"stakeholder_list": [
{
"identity_type": "string",
"name": "string",
"nationality": "st",
"birth_date": "2019-08-24",
"address_proof_file_id": 0,
"doc_type": "string",
"id_number": "string",
"doc_address": "string",
"doc_non_portrait_side_file_id": 0,
"doc_portrait_side_file_id": 0,
"eff_date_start": "2019-08-24",
"eff_date_end": "2019-08-24",
"long_term": true,
"share": 0,
"resident_address": {
"province": "string",
"city": "string",
"zipcode": "string",
"address1": "string",
"address2": "string"
}
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open-fat.cb.paykka.com/api/v2/merch/onboard/apply' \
--header 'X-Merch-Id: M24061911365700670' \
--header 'Content-Type: application/json' \
--data-raw '{
"request_id": "string",
"contact_person": {
"phone_prefix": "strin",
"phone": "string",
"email": "string"
},
"license": {
"region": "st",
"ent_name": "string",
"ent_name_en": "string",
"found_date": "2019-08-24",
"registered_currency": "str",
"registered_capital": 0,
"address": {
"province": "string",
"city": "string",
"zipcode": "string",
"address1": "string",
"address2": "string"
},
"legal_rep_name": "string",
"license_file_id": 0,
"ent_type": "string",
"uni_social_credit": "string",
"busi_from": "2019-08-24",
"busi_end": "2019-08-24",
"long_term": true,
"br_no": "string",
"br_file_id": 0,
"annual_return_file_id": 0,
"incorporation_form_file_id": 0,
"br_expiry_date": "2019-08-24",
"cr_issue_date": "2019-08-24",
"company_article_file_id": 0,
"cr_file_id": 0,
"cr_no": "string",
"share_structure_file_id": 0,
"cr_expiry_date": "2019-08-24",
"other_file_ids": [
0
]
},
"business": {
"industry": 0,
"employee_number": "string",
"address": {
"province": "string",
"city": "string",
"zipcode": "string",
"address1": "string",
"address2": "string"
},
"export_country": [
"string"
],
"export_type": [
"string"
],
"trade_volume": "string",
"website": "string"
},
"stakeholder_list": [
{
"identity_type": "string",
"name": "string",
"nationality": "st",
"birth_date": "2019-08-24",
"address_proof_file_id": 0,
"doc_type": "string",
"id_number": "string",
"doc_address": "string",
"doc_non_portrait_side_file_id": 0,
"doc_portrait_side_file_id": 0,
"eff_date_start": "2019-08-24",
"eff_date_end": "2019-08-24",
"long_term": true,
"share": 0,
"resident_address": {
"province": "string",
"city": "string",
"zipcode": "string",
"address1": "string",
"address2": "string"
}
}
]
}'
返回响应
🟢200成功
*/*
Body
authorize_link
string
授权链接
>= 0 字符<= 256 字符
merch_id
string
商户id
>= 1 字符<= 20 字符
示例
{
"authorize_link": "string",
"merch_id": "string"
}
🟠400请求有误
🟠401没有权限
🟠404记录不存在
🟠429429
🔴500服务器错误
修改于 2025-06-25 08:45:53