发起进件请求

接口功能描述：提交商户资料，开通商户号以收款或接收分账。

注意事项

如果传入 sub_merchant_id 请保证其唯一。

接口地址

请求URL	https://developer.toutiao.com/api/apps/ecpay/saas/create_merchant
请求方式	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	number	是	-	进件类型枚举值： 1: 开发者给小程序收款商户进件 2: 开发者给小程序合作方进件 3: 服务商为自己进件 4: 服务商给小程序收款商户进件 5: 服务商给小程序的合作方进件注意：2、3、5类型的商户号只能接收分账，没有收款权限	1
sub_merchant_id	string	条件选填	128	商户 id，用于接入方自行标识并管理进件方。由开发者自行分配管理。在服务商给自己进件也就是 type=3的时候不需传	69560302266147330860
callback_url	string	是	256	进件结果通知接口（开发者自己的https服务）；如果不传默认用支付设置中的回调地址（路径：小程序开发者平台-功能管理-支付-支付产品-支付设置- URL）
channels	string[]	是	256	进件渠道 [ wx , alipay , hz ], 支持一次进件多渠道。进件渠道枚举值：wx: 微信支付alipay: 支付宝支付hz: 抖音支付	[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	BusinessLicense	是	-	经营地址，参照下面business_license参数	参照示例
legal_person	LegalPerson	是	-	法人信息，参照下面legal_person参数	参照示例
merchant_card_info	MerchantCardInfo	是	-	结算账户信息信息，参照下面merchant_card_info参数	参照示例
merchant_operation_info	MerchantOperationInfo	是	-	商户管理员信息参照下面merchant_operation_info参数	参照示例
industry_code	string[]	是	256	行业类型code，	1520
ext_evidences	string[]	条件选填	256	补充材料图片，图片id，通过图片上传接口获取	ext.jpeg
industry_info_pic_urls	string[]	条件选填	256	特殊行业时必填，	industry.jpeg
sign	string	条件选填	344	开发者请求参数的签名串。签名方式签名	c639b06f45e74c7b8025acbb45f04bb1
out_order_id	string	是	256	外部单号，必须保证唯一，用来标识本次进件请求	s90219201291021920121212
create_name	string	是	64	姓名	张三
beneficiary_type	string	条件选填	20	受益人类型枚举 LEGAL: 法人, BENEFICIARY: 其他受益人当所选渠道包含微信、商户类型为企业时，必填	LEGAL
beneficiary	Beneficiary	条件选填	-	受益人信息当所选渠道包含微信、商户类型为企业时，且最终受益人不是法人，必填	参照示例

business_license 参数

参数	类型	是否必填	最大长度	描述	示例值
business_license_type	number	是	-	证件类型枚举值1: 个人身份证2: 营业执照3: 统一社会信用代码4: 民办非企业登记证书5: 社会团体法人登记证书6: 事业单位法人证书7: 党政及国家机关资格证	2
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	请按照证件上住址填写，若证件上无住址则按照实际住址填写当所选渠道包含微信、商户类型为企业时，需要填写此项	浙江省杭州市

merchant_card_info 参数

参数	类型	是否必填	最大长度	描述	示例值
account_name	string	是	64	卡户名	张三
account_no	string	是	64	银行卡号	110909320120601
bank_full_name	string	是	64	开户支行名	招商银行股份有限公司北京支行
settle_type	number	是		结算类型枚举值：1: 对私2: 对公	1
card_type	string	是	20	银行卡类型枚举值：DC: 借记卡 CC: 信用卡	DC
alipay_settle_type	number	是		支付宝结算类型枚举值：1: 卡结算2: 支付宝账户结算	1
alipay_account_no	string	条件选填	64	支付宝结算账号alipay_settle_type 参数为2时必传
settlement_cert_pic	string	条件选填	256	结算证明函（）所选渠道是微信，且商户类型是党政机关/事业单位时，银行卡开户名可与商户名称不一致，不一致的情况下必填	1.jpg
relation_cert_pic	string	条件选填	256	关系证明函（）所选渠道是微信，且商户类型是党政机关/事业单位时，银行卡开户名可与商户名称不一致，不一致的情况下必填	1.jpg
other_cert_pics	string[]	条件选填	256	其他补充证明（请提供非同名结算的法律法规、政策通知、政府或上级部门公文等证明文件，以作上述材料的补充证明）所选渠道是微信，且商户类型是党政机关/事业单位时，银行卡开户名可与商户名称不一致，不一致的情况下必填	["1.jpg","2.jpg"]

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	联系人邮箱
alipay_account_no	string	条件选填	64	支付宝账号入驻支付宝必填
shop_name	string	条件选填	512	店铺名称入驻支付宝、微信必填	字节跳动
shop_url	string	条件选填	256	店铺链接入驻支付宝、微信必填
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经办人条件下必填证件照地址，人脸面电子版，是一个tos上的url地址	1.jpg
id_back_pic_url	string	条件选填	256	在manage_person_type为2经办人以及IdType 为身份证的条件下必填证件照地址，国徽面电子版，是一个tos上的url地址	1.jpg
business_authorization_letter	string	条件选填	256	在manage_person_type为2经办人以及IdType 为身份证的条件下必填	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	请按照证件上住址填写，若证件上无住址则按照实际住址填写	浙江省杭州市

请求示例

{
  "app_id": "ttcfdbb96650e33350",
  "access_token": "abc123czxhc84392s123ahdbz9213cdnzujncjznuqh12389834bhdb8bchzj8182jdsjaju123",
  "thirdparty_id": "",
  "component_access_token": "",
  "sub_merchant_id": "test_receive_92",
  "type": 2,
  "callback_url": "https://www.bytedance.com/cn",
  "channels": ["wx"],
  "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": {
      "wx": "tos-cn-i-01omznotxb/565352443d7c44b79aa135583ad64d11"
    },
    "begin_date": "20211231",
    "end_date": "99991231",
    "address": "浙江省杭州市"
  },
  "legal_person": {
    "id_type": 1,
    "id_no": "13213429731104601X",
    "name": "张三",
    "front_pic_url": {
      "wx": "tos-cn-i-01omznotxb/ad03b8461e48478c980d03f34d611625"
    },
    "back_pic_url": {
      "wx": "tos-cn-i-01omznotxb/1e19e6ba8b1e4755a886ab6a7447496c"
    },
    "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	商户号	70372492201318182840

响应示例

正常响应示例

{
  "err_no": 0,
  "err_tips": "成功",
  "apply_id": "SMA202202212156514",
  "merchant_id": "70372492201318182840"
}

异常响应示例

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

错误码

err_no	err_tips	解决方案
0	受理成功	受理成功
1000	内部错误	系统异常，请使用相同参数稍后重试
1004	未知异常	请原参数重试
2008	签名校验异常，请使用正确的签名和 json 传参	请检查参数，详见验签异常
1005	频率控制	请降低调用频率
2010	参数错误: 参数MerchantType不正确	请使用正确的参数重新调用
	参数错误: 进件渠道为空
	参数错误: 未知类型(Invalid Type)
	参数错误:maAppID或者sub_merchant_id为空
	参数错误:thirdPartyID为空
	参数错误:thirdPartyID或maAppID或sub_merchant_id为空
	参数错误:thirdPartyID或sub_merchant_id为空
	参数错误: 参数:MerchantName 为空
	参数错误: 参数:MerchantShortName 为空
	参数错误: 没有合众营业执照
	参数错误: 没有微信营业执照
	参数错误: 没有支付宝营业执照
	参数错误: 营业执照有效期起止时间错误
	参数错误: 进件微信、合众或者进件支付宝且支付宝结算类型为银行卡时,开户银行不可为空
	参数错误: 参数:店铺名称为空
	参数错误: 参数:店铺链接为空
	参数错误: 参数:签约的支付宝账户为空
	参数错误: 参数:OutOrderId 为空
	参数错误:当管理员类型为法人时,管理员姓名和身份证号需要和法人的姓名和身份证号一致
7001	存在流程进行中的申请单或者已经进件成功	可通过查询申请单状态查看此申请单的申请状态，或更换business_code提交新的申请单
7002	申请单不存在	确认入参，传入正确的申请单编号
7003	商户重复入驻	商户更换文件后，重新调用

点击纠错

该文档是否对你的开发有所帮助？

有帮助

没帮助

该文档是否对你的开发有所帮助？

有帮助

没帮助

发起进件请求
注意事项
接口地址
请求头
请求参数
响应参数
错误码