发起进件请求

开发环境

http://dev-cn.your-api-server.com

POST

https://developer.toutiao.com/api/apps/ecpay/saas/create_merchant

提交商户资料，开通商户号以收款或接收分账。
如果进件接口没有返回 merchant_id，请使用原参数重新进件。
接口频次
20QPS(小程序app_id维度或thirdparty_id维度)

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.请按照证件上住址填写，若证件上无住址则按照实际住址填写	浙江省杭州市

错误码

错误码 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	当前小程序所归属的服务类目，暂不支持开通支付功能	详情请查看小程序交易能力接入规范

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://developer.toutiao.com/api/apps/ecpay/saas/create_merchant' \
--header 'Content-Type: application/json' \
--data-raw '{ 
  "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": ["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"
}'

响应示例

200 - 示例 1

{
  "err_no": 0,
  "err_tips": "string",
  "apply_id": "string",
  "merchant_id": "string"
}

请求参数

Header 参数

Content-Type

string

必需

Body 参数application/json

app_id

string

可选

小程序的 app_id 在给小程序或小程序合作方进件必填

access_token

string

可选

小程序token 在开发者身份下必填获取链接

thirdparty_id

string

可选

小程序第三方平台应用 id 在服务商身份下必填

component_access_token

string

可选

服务商绑定的token 在进件类型type=3服务商的身份下必填

sub_merchant_id

string

可选

商户id，用于接入方自行标识并管理进件方，需要保证在app_id下唯一 type=3时不需传，其他情况必填

type

integer

必需

进件类型枚举值： 1: 开发者给小程序收款商户进件 2: 开发者给小程序合作方进件 3: 服务商为自己进件 4: 服务商给小程序收款商户进件 5: 服务商给小程序的合作方进件注意：2、3、5类型的商户号只能接收分账，没有收款权限

callback_url

string

必需

进件结果通知接口（开发者自己的https服务）；如果不传默认用支付设置中的回调地址（路径：小程序开发者平台-功能管理-支付-支付产品-支付设置- URL）

channels

array[string]

必需

进件渠道枚举值：抖音支付：hz 支付宝：alipay 微信支付：wx

merchant_type

integer

必需

商户类型枚举值： 1: 个人 2: 企业 3: 个体工商户 4: 小微商户 5: 事业单位 6: 民办非企业组织 7: 社会团体 8: 党政及国家机关

merchant_name

string

必需

商户名称和营业执照/身份证上的一致

merchant_short_name

string

商户简称

必需

province_code

string

必需

注册的省编码，获取链接

city_code

string

必需

注册的市编码，获取链接

district_code

string

必需

注册的区编码，获取链接

registered_addr

string

注册详细地址

必需

business_license

object

必需

经营地址，参照下面business_license参数

business_license_type

integer

必需

根据商户类型传入对应的证件类型商户类型-证件类型对应关系个人/小微：个人身份证企业：营业执照（三证合一）个体工商户：营业执照（三证合一）事业单位：事业单位法人证书民办非企业组织：民办非企业登记证书社会团体：社会团体法人登记证书党政及国家机关：党政及国家机关资格证证件类型枚举值 1: 个人身份证 3: 营业执照（三证合一） 4: 民办非企业登记证书 5: 社会团体法人登记证书 6: 事业单位法人证书 7: 党政及国家机关资格证

business_license_code

string

必需

证件号，身份证号/营业执照号

business_license_picurl

object

必需

证件照主照片，图片id, 通过图片上传接口获取

begin_date

string

必需

证件照开始时间, 格式 yyyymmdd

end_date

string

必需

证件照结束时间, 格式yyyymmdd, 长期填 99991231

address

string

必需

legal_person

object

必需

法人信息，参照下面legal_person参数

id_type

integer

必需

证件类型枚举值 1: 身份证 2: 户口本 3: 护照 4: 军官证 5: 士兵证 6: 香港居民来往内地通行证 7: 台湾同胞来往内地通行证 8: 临时身份证 9: 外国人居留证 10: 警官证 11: 澳门同胞来往内地通行证 12: 港澳居住证 13: 台湾居住证 100: 其他证件类型（上面没有枚举的）

id_no

string

必需

证件号与id_type对应

name

string

证件人名字

必需

front_pic_url

object

必需

证件照主照片, 图片id, 通过图片上传接口获取

back_pic_url

object

必需

证件照副照片部分, 身份证的话，是国徽面营业照可以不传副照 ,图片id, 通过图片上传接口获取

begin_date

string

必需

证件照开始时间yyyymmdd 20211231

exp_date

string

必需

证件照过期时间yyyymmdd 20211231 长期填: 99991231

address

string

可选

请按照证件上住址填写，若证件上无住址则按照实际住址填写当所选渠道包含微信、商户类型=2为企业时，需要填写此项

merchant_card_info

object

必需

结算账户信息信息，参照下面merchant_card_info参数

account_name

string

卡户名

必需

account_no

string

银行卡号

必需

bank_full_name

string

开户支行名

必需

settle_type

integer

必需

结算类型枚举值： 1: 对私 2: 对公

card_type

string

必需

银行卡类型枚举值： DC: 借记卡 CC: 信用卡

settlement_cert_pic

string

必需

relation_cert_pic

string

必需

other_cert_pics

array[string]

必需

merchant_operation_info

object

必需

商户管理员信息参照下面merchant_operation_info参数

manage_name

string

联系人名称

必需

manage_mobile

string

联系人手机号

必需

manage_person_type

integer

必需

联系人类型枚举值： 1: 法人 2: 非法人

manage_id_no

string

身份证号

必需

manage_email

string

联系人邮箱

必需

shop_name

string

可选

店铺名称入驻支付宝、微信必填

shop_url

string

可选

店铺链接入驻支付宝、微信必填

id_type

integer

可选

在manage_person_type为2非法人条件下必填证件类型枚举值: 1: 身份证 2: 户口本 3: 护照 4: 军官证 5: 士兵证 6: 香港居民来往内地通行证 7: 台湾同胞来往内地通行证 8: 临时身份证 9: 外国人居留证 10: 警官证 11: 澳门同胞来往内地通行证 12: 港澳居住证 13: 台湾居住证 100: 其他证件类型（上面没有枚举的）

id_begin_date

string

可选

在manage_person_type为2非法人条件下必填证件有效期开始时间，格式为yyyyMMdd

id_exp_date

string

可选

在manage_person_type为2非法人条件下必填证件有效期过期时间，格式为yyyyMMdd, 长期 99991231

id_front_pic_url

string

可选

在manage_person_type为2非法人条件下必填证件照地址，人脸面电子版，图片id通过图片上传接口获取

id_back_pic_url

string

可选

在manage_person_type为2非法人以及IdType 为身份证的条件下必填证件照地址，国徽面电子版，图片id通过图片上传接口获取

business_authorization_letter

string

可选

当所选渠道包含微信，且manage_person_type为2非法人的条件下必填

industry_code

array[string]

必需

行业类型code，获取链接

sign

string

可选

开发者请求参数的签名串。详见签名DEMO

out_order_id

string

必需

外部单号，必须保证唯一，用来标识本次进件请求

create_name

string

姓名

必需

beneficiary_type

string

可选

受益人类型枚举: LEGAL: 法人 BENEFICIARY: 其他受益人当所选渠道包含微信、商户类型merchant_type=2为企业时，必填

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

返回码，详见错误码及错误描述

err_tips

string

必需

返回码描述，详见错误码及错误描述

apply_id

string

申请单id

必需

merchant_id

string

商户号

必需

🟠400请求有误

进件状态回调

图片上传接口

发起进件请求

错误码#

请求参数

返回响应

错误码