开发
API

发起进件请求

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

注意事项

  1. 如果传入 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

商户重复入驻

商户更换文件后,重新调用

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助