发起进件请求

更新时间 2024-07-24 02:58:49

我的收藏

提交商户资料，开通商户号以收款或接收分账。

使用限制

接入前，请先查看接入前准备是否完成

接口说明

如果进件接口没有返回 merchant_id，请使用原参数重新进件。

基本信息

基本信息
HTTP URL	https://developer.toutiao.com/api/apps/ecpay/saas/create_merchant
HTTP Method	POST
接口频次	20QPS(小程序app_id维度或thirdparty_id维度)

请求头

名称	类型	必填	描述
Content-Type	string	是	固定值 "application/json"

请求参数

名称	类型	是否必填	最大长度	描述	示例值
app_id	string	条件选填	64	小程序的 app_id 在给小程序或小程序合作方进件必填	tt07e3715e98c9aac0
access_token	string	条件选填	64	小程序token 在开发者身份下必填获取链接	567234784
thirdparty_id	string	条件选填	64	小程序第三方平台应用 id 在服务商身份下必填	ttc4a8b2155b82682f
component_access_token	string	条件选填	64	服务商绑定的token 在进件类型type=3服务商的身份下必填获取链接
type	number	是	-	进件类型枚举值： 1: 开发者给小程序收款商户进件 2: 开发者给小程序合作方进件 3: 服务商为自己进件 4: 服务商给小程序收款商户进件 5: 服务商给小程序的合作方进件注意：2、3、5类型的商户号只能接收分账，没有收款权限	1
sub_merchant_id	string	条件选填	128	商户id，用于接入方自行标识并管理进件方，需要保证在app_id下唯一 type=3时不需传，其他情况必填	69560302266147330860
callback_url	string	否	256	进件结果通知接口（开发者自己的https服务）；如果不传默认用支付设置中的回调地址（路径：小程序开发者平台-功能管理-支付-支付产品-支付设置- URL）	http://www.bytedace.com/cn
channels	string[]	是	256	进件渠道枚举值： •抖音支付：hz •支付宝：alipay •微信支付：wx	•开通支付宝和抖音支付：[ "alipay" , "hz"] •开通支付宝、抖音支付、微信：[ "wx" , "alipay" , "hz"]
merchant_type	number	是	-	商户类型枚举值： 1: 个人 2: 企业 3: 个体工商户 4: 小微商户 5: 事业单位 6: 民办非企业组织 7: 社会团体 8: 党政及国家机关	2
merchant_name	string	是	128	商户名称和营业执照/身份证上的一致	北京字节跳动有限公司
merchant_short_name	string	是	64	商户简称	字节跳动
province_code	string	是	10	注册的省编码，获取链接	110000
city_code	string	是	10	注册的市编码，获取链接	110100
district_code	string	是	10	注册的区编码，获取链接	110107
registered_addr	string	是	256	注册详细地址	北京市海淀区知春路甲48号2号楼10A室
business_license	object	是	-	经营地址，参照下面business_license参数	参照示例
legal_person	object	是	-	法人信息，参照下面legal_person参数	参照示例
merchant_card_info	object	是	-	结算账户信息信息，参照下面merchant_card_info参数	参照示例
merchant_operation_info	object	是	-	商户管理员信息参照下面merchant_operation_info参数	参照示例
industry_code	string[]	是	256	行业类型code，获取链接	["1520"]
ext_evidences	object[]	条件选填	256	补充材料图片，图片id，通过图片上传接口获取	[{"hz": "1.jpeg","wx":"2.jpeg","alipay":"3.jpeg"}]
industry_info_pic_urls	object[]	条件选填	256	1.特殊行业需要额外补充对应材料，具体如下：特殊行业补充材料说明 2.最多可上传 5 张图片，图片仅支持 BMP、JPG、JPEG、PNG 格式，大小不超过 2MB 3.图片ID通过图片上传接口获取	[{"hz": "1.jpeg","wx":"2.jpeg","alipay":"3.jpeg"}]
sign	string	条件选填	344	开发者请求参数的签名串。详见签名DEMO	c639b06f45e74c7b8025acbb45f04bb1
out_order_id	string	是	256	外部单号，必须保证唯一，用来标识本次进件请求	s90219201291021920121212
create_name	string	是	64	姓名	张三
beneficiary_type	string	条件选填	20	受益人类型枚举: LEGAL: 法人 BENEFICIARY: 其他受益人当所选渠道包含微信、商户类型merchant_type=2为企业时，必填	LEGAL
beneficiary	object	条件选填	-	受益人信息当所选渠道包含微信，商户类型merchant_type=2为企业，且受益人类型beneficiary_type不是法人时必填，参照下面beneficiary参数描述	参照示例

business_license 参数

名称	类型	是否必填	最大长度	描述	示例值
business_license_type	number	是	-	根据商户类型传入对应的证件类型商户类型-证件类型对应关系个人/小微：个人身份证企业：营业执照（三证合一）个体工商户：营业执照（三证合一）事业单位：事业单位法人证书民办非企业组织：民办非企业登记证书社会团体：社会团体法人登记证书党政及国家机关：党政及国家机关资格证证件类型枚举值 1: 个人身份证 3: 营业执照（三证合一） 4: 民办非企业登记证书 5: 社会团体法人登记证书 6: 事业单位法人证书 7: 党政及国家机关资格证	3
business_license_code	string	是	128	证件号，身份证号/营业执照号	410724198302151234
business_license_picurl	string	是	256	证件照主照片，图片id, 通过图片上传接口获取	{"hz": "1.jpeg","wx":"2.jpeg","alipay":"3.jpeg"}
business_license_back_picurl	string	条件选填	256	证件照副照片部分, 身份证的话，是国徽面营业照可以不传副照 ,图片id, 通过图片上传接口获取	{"hz": "1.jpeg","wx":"2.jpeg","alipay":"3.jpeg"}
begin_date	string	是	64	证件照开始时间, 格式 yyyymmdd	20211231
end_date	string	是	64	证件照结束时间, 格式yyyymmdd, 长期填 99991231	20221221

legal_person 参数

名称	类型	是否必填	最大长度	描述	示例值
id_type	number	是	-	证件类型枚举值 1: 身份证 2: 户口本 3: 护照 4: 军官证 5: 士兵证 6: 香港居民来往内地通行证 7: 台湾同胞来往内地通行证 8: 临时身份证 9: 外国人居留证 10: 警官证 11: 澳门同胞来往内地通行证 12: 港澳居住证 13: 台湾居住证 100: 其他证件类型（上面没有枚举的）	1
id_no	string	是	20	证件号与id_type对应	110000199001011234
name	string	是	64	证件人名字	张三
front_pic_url	string	是	256	证件照主照片, 图片id, 通过图片上传接口获取	{"hz": "1.jpeg","wx":"1.jpeg","alipay":"1.jpeg"}
back_pic_url	string	条件选填	256	证件照副照片部分, 身份证的话，是国徽面营业照可以不传副照 ,图片id, 通过图片上传接口获取	{"hz": "2.jpeg","wx":"2.jpeg","alipay":"2.jpeg"}
begin_date	string	是	64	证件照开始时间yyyymmdd 20211231	20211231
exp_date	string	是	64	证件照过期时间yyyymmdd 20211231 长期填: 99991231	20211231
address	string	否	256	请按照证件上住址填写，若证件上无住址则按照实际住址填写当所选渠道包含微信、商户类型=2为企业时，需要填写此项	浙江省杭州市

merchant_card_info 参数

名称	类型	是否必填	最大长度	描述	示例值
account_name	string	是	64	卡户名	张三
account_no	string	是	20	银行卡号	110909320120601
bank_full_name	string	是	128	开户支行名	招商银行股份有限公司北京支行
settle_type	number	是	-	结算类型枚举值： 1: 对私 2: 对公	1
card_type	string	是	-	银行卡类型枚举值： DC: 借记卡 CC: 信用卡	DC
alipay_settle_type	number	是	-	支付宝结算类型枚举值： 1: 卡结算 2: 支付宝账户结算	1
alipay_account_no	string	条件选填	128	支付宝结算账号 alipay_settle_type 参数为2时必传	bytedance@163.com

merchant_operation_info 参数

名称	类型	是否必填	最大长度	描述	示例值
manage_name	string	是	128	联系人名称	李四
manage_mobile	string	是	20	联系人手机号	18688888888
manage_person_type	number	是	-	联系人类型枚举值： 1: 法人 2: 非法人	1
manage_id_no	string	是	20	身份证号	110000199001011234
manage_email	string	是	128	联系人邮箱	bytedance@163.com
alipay_account_no	string	条件选填	64	支付宝账号入驻支付宝必填	bytedance@163.com
shop_name	string	条件选填	512	店铺名称入驻支付宝、微信必填	字节跳动
shop_url	string	条件选填	256	店铺链接入驻支付宝、微信必填	www.bytedance.com
id_type	number	条件选填	-	在manage_person_type为2非法人条件下必填证件类型枚举值: 1: 身份证 2: 户口本 3: 护照 4: 军官证 5: 士兵证 6: 香港居民来往内地通行证 7: 台湾同胞来往内地通行证 8: 临时身份证 9: 外国人居留证 10: 警官证 11: 澳门同胞来往内地通行证 12: 港澳居住证 13: 台湾居住证 100: 其他证件类型（上面没有枚举的）	1
id_begin_date	string	条件选填	64	在manage_person_type为2非法人条件下必填证件有效期开始时间，格式为yyyyMMdd	20220617
id_exp_date	string	条件选填	64	在manage_person_type为2非法人条件下必填证件有效期过期时间，格式为yyyyMMdd, 长期 99991231	20220617
id_front_pic_url	string	条件选填	256	在manage_person_type为2非法人条件下必填证件照地址，人脸面电子版，图片id通过图片上传接口获取	1.jpg
id_back_pic_url	string	条件选填	256	在manage_person_type为2非法人以及IdType 为身份证的条件下必填证件照地址，国徽面电子版，图片id通过图片上传接口获取	1.jpg
business_authorization_letter	string	条件选填	256	当所选渠道包含微信，且manage_person_type为2非法人的条件下必填示例	1.jpg

beneficiary 参数

名称	类型	是否必填	最大长度	描述	示例值
id_type	number	是	-	证件类型枚举值 1: 身份证 2: 户口本 3: 护照 4: 军官证 5: 士兵证 6: 香港居民来往内地通行证 7: 台湾同胞来往内地通行证 8: 临时身份证 9: 外国人居留证 10: 警官证 11: 澳门同胞来往内地通行证 12: 港澳居住证 13: 台湾居住证 100: 其他证件类型（上面没有枚举的）	1
id_no	string	是	20	证件号与id_type对应	110000199001011234
name	string	是	64	证件人名字	张三
front_pic_url	string	是	256	证件照主照片, 图片id, 通过图片上传接口获取	"1.jpeg"
back_pic_url	string	条件选填	256	证件照副照片部分, 身份证的话，是国徽面营业照可以不传副照 ,图片id, 通过图片上传接口获取	"2.jpeg"
begin_date	string	是	64	证件照开始时间yyyymmdd 20211231	20211231
exp_date	string	是	64	证件照过期时间yyyymmdd 20211231 长期填: 99991231	20211231
address	string	条件选填	256	1.当所选渠道包含微信、商户类型为企业时，需要填写此项 2.请按照证件上住址填写，若证件上无住址则按照实际住址填写	浙江省杭州市

请求示例

json复制
{
    "app_id": "app_id123112121",
    "access_token": "abc123czxhc84392s123ahdbz9213cdnzujncjznuqh12389834bhdb8bchzj8182jdsjaju123",
    "thirdparty_id": "",
    "component_access_token": "",
    "sub_merchant_id": "test_receive_92",
    "type": 2,
    "callback_url": "https://www.bytedance.com/cn",
    "channels": [
        "alipay",
        "hz"
    ],
    "merchant_type": 2,
    "merchant_name": "北京字节跳动有限公司",
    "merchant_short_name": "字节跳动",
    "province_code": "110000",
    "city_code": "110100",
    "district_code": "110107",
    "registered_addr": "北京市海淀区北三环西路43号2号楼三层303室",
    "business_license": {
        "business_license_type": 3,
        "business_license_code": "130429199205274617",
        "business_license_picurl": {
            "hz": "tos-cn-i-01omznotxb/565352443d7c44b79aa135583ad64d11",
            "alipay": "tos-cn-i-01omznotxb/565352443d7c44b79aa135583ad64d23"
        },
        "begin_date": "20211231",
        "end_date": "99991231",
        "address": "浙江省杭州市"
    },
    "legal_person": {
        "id_type": 1,
        "id_no": "13213429731104601X",
        "name": "张三",
        "front_pic_url": {
            "hz": "tos-cn-i-01omznotxb/565352443d7c44b79aa135583ad64d11",
            "alipay": "tos-cn-i-01omznotxb/565352443d7c44b79aa135583ad64d23"
        },
        "back_pic_url": {
            "hz": "tos-cn-i-01omznotxb/565352443d7c44b79aa135583ad64d11",
            "alipay": "tos-cn-i-01omznotxb/565352443d7c44b79aa135583ad64d23"
        },
        "begin_date": "20211231",
        "exp_date": "99991231",
        "address": "北京市海淀区北三环西路43号2号楼三层303室"
    },
    "merchant_card_info": {
        "account_name": "北京字节跳动有限公司",
        "account_no": "110932121411301",
        "bank_full_name": "招商银行股份有限公司北京首体支行",
        "settle_type": 2,
        "card_type": "DC",
        "settlement_cert_pic": "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c",
        "relation_cert_pic": "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c",
        "other_cert_pics": [
            "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c",
            "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c"
        ]
    },
    "merchant_operation_info": {
        "manage_name": "张三",
        "manage_mobile": "18388888888",
        "manage_person_type": 2,
        "manage_id_no": "110101199003078531",
        "manage_email": "bytedance@163.com",
        "shop_name": "字节跳动",
        "shop_url": "http://www.bytedance.com",
        "id_type": 1,
        "id_begin_date": "20211231",
        "id_exp_date": "99991231",
        "id_front_pic_url": "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c",
        "id_back_pic_url": "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c",
        "business_authorization_letter": "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c"
    },
    "industry_code": [
        "1520"
    ],
    "sign": "5ee5474aff4e5623f464fd6bf12322bf",
    "out_order_id": "s90219201291021920121212x-02",
    "create_name": "李四",
    "beneficiary_type": "LEGAL"
}

响应参数

公共响应参数

名称	类型	是否必填	最大长度	描述	示例值
error_no	number	是	-	返回码，详见错误码及错误描述	2008
error_tips	string	是	-	返回码描述，详见错误码及错误描述	签名校验异常，请使用正确的签名和 json 传参

业务响应参数

名称	类型	是否必填	最大长度	描述	示例值
apply_id	string	是	64	申请单id	SMA202202212153514
merchant_id	string	是	64	商户号	M70372492201318182840

响应示例

正常响应示例

json复制
{
  "err_no": 0,
  "err_tips": "成功",
  "apply_id": "SMA202202212156514",
  "merchant_id": "M70372492201318182840"
}

异常响应示例

json复制
{
  "err_no": 2008,
  "err_tips": "签名校验异常，请使用正确的签名和 json 传参",
  "apply_id": "",
  "merchant_id": ""
}

错误码

错误码 err_code	描述 err_tips	排查建议
0	受理成功	受理成功
1000	内部错误	系统异常，请使用相同参数稍后重试
1004	未知异常	请原参数重试
1005	频率控制	请降低调用频率
1007	参数错误：channels参数不合法，请检查	channels传参说明：开通支付宝和抖音支付：[ "alipay" , "hz"] 开通支付宝、抖音支付、微信：[ "wx" , "alipay" , "hz"]
2008	签名校验异常，请使用正确的签名和 json 传参	请检查参数，详见签名DEMO
2010	参数错误: 参数MerchantType不正确	请使用正确的参数重新调用
	参数错误: 进件渠道为空
	参数错误: 未知类型(Invalid Type)
	参数错误:maAppID或者sub_merchant_id为空
	参数错误:thirdPartyID为空
	参数错误:thirdPartyID或maAppID或sub_merchant_id为空
	参数错误:thirdPartyID或sub_merchant_id为空
	参数错误: 参数:MerchantName 为空
	参数错误: 参数:MerchantShortName 为空
	参数错误: 没有抖音支付营业执照
	参数错误: 没有微信营业执照
	参数错误: 没有支付宝营业执照
	参数错误: 营业执照有效期起止时间错误
	参数错误: 进件微信、抖音支付或者进件支付宝且支付宝结算类型为银行卡时,开户银行不可为空
	参数错误: 参数:店铺名称为空
	参数错误: 参数:店铺链接为空
	参数错误: 参数:签约的支付宝账户为空
	参数错误: 参数:OutOrderId 为空
	参数错误:当管理员类型为法人时,管理员姓名和身份证号需要和法人的姓名和身份证号一致
7001	存在流程进行中的申请单或者已经进件成功	可通过查询申请单状态查看此申请单的申请状态
7002	申请单不存在	确认入参，传入正确的申请单编号
7003	商户重复入驻	商户更换文件后，重新调用
7025	当前小程序所归属的服务类目，暂不支持开通支付功能	详情请查看小程序交易能力接入规范