商户线上进件

线下提交资料以后，客户拿到业务线ID，进行商户的进件。

对于微信进件，需调用资质文件上传照片，在调用进件接口时，除了通用的参数外，还需传入SalesInfo、CredentialFiles、SettleInfo，在接口调用后，会给商户业务联系人或法人发送签约短信，短信包含签约链接，客户点击链接填写详细信息。进件完成后会收到回调通知或主动查询结果。

对于微企付进件，需调用资质文件上传照片，在调用进件接口时，除了通用的参数外，还需传入CredentialFiles、SettleInfo，在接口调用后，会给商户业务联系人或法人发送签约短信，短信包含签约链接，客户点击链接填写详细信息。进件完成后会收到回调通知或主动查询结果。

对于平安见证宝进件，在调用进件接口时，除了通用的参数外，还需传入SettleInfo、InterConnectionSubMerchantData、MerchantRole、OutSubMerchantExtensionInfo的ServicePhone字段。在接口调用后银行会向结算账户转入小于等于0.5元的随机金额，并短信通知客户查看，客户查看后，需将收到的金额大小及短信序列号通过子商户进件绑定结算卡校验接口传入完成进件。见证宝的请求地址请替换成/cloudpay/v1/merchant/out/channelSubMerchant/createAndOnlineAggregatedRegistration

对于中信e管家进件，在调用进件接口时，除了通用的参数外，还需传入SettleInfo、MerchantRole、OutSubMerchantExtensionInfo的ServicePhone字段。

对于连连支付进件，在调用进件接口时，除了通用的参数外，还需传入SettleInfo、InterConnectionSubMerchantData字段、OutSubMerchantExtensionInfo 中的 ServicePhone 和 RegionCode 字段。在接口调用后，会给商户手机号发送两条短信，分别包含开户页面地址，和免密代扣协议地址，商户进入这两个页面补充信息后完成进件。

如果进件失败，可以更换外部进件申请号后重新发起新的进件。

接口说明

请求方式：

post

https://p.wecard.tencent.com/cloudpay/v1/merchant/out/channelSubMerchant/createAndOnlineAsyncAggregatedRegistration

请求参数

Request

Body 包体

OutRegistrationNo必填

string

外部进件申请号

最小长度：0 最大长度：50

OutSubMerchantId必填

string

外部子商户ID

最小长度：0 最大长度：50

ChannelMerchantId必填

string

业务线ID

最小长度：0 最大长度：50

ChannelName必填

string

渠道名称: 微信-WECHAT; 微企付-ENTPAY; 通联-ALLINPAY; 平安见证宝-PINGANJZB; 通联云商通-ALLINPAYCLOUD; 连连支付-LIANLIANPAY; 农业银行综合收银台-ABCZHSYT; 中信e管家-CITICEM

最小长度：0 最大长度：50

OutSubMerchantType必填

string

外部商户类型ENTERPRISE：企业商户
INSTITUTION：事业单位商户
INDIVIDUALBISS：个体工商户
PERSON：个人商户(小微商户)
SUBJECT_TYPE_OTHERS：其他组织

最小长度：0 最大长度：50

OutSubMerchantName必填

string

外部商户名称
再次进件可不传

OutSubMerchantShortName必填

string

外部商户简称建行渠道长度限制1到20
再次进件可不传

最小长度：0 最大长度：50

NotifyUrl选填

string

进件结果通知地址

最小长度：0 最大长度：300

OutSubMerchantDescription选填

string

外部子商户描述

PaymentMethod选填

string

支付方式 UNIFIED_PAYMENT:统一付款，C2B场景模式下，默认使用该值

StallNumber选填

string

门店档位号

ApiMode选填

string

对接模式，目前主要for农行生效 H5_MODE: H5模式 MP_MODE: 公众号模式

BusinessLicenseInfo必填

object

营业证件信息，见下文说明
再次进件可不传

OutSubMerchantExtensionInfo选填

object

外部商户扩展信息，见下文说明微信、建行、通联、通联云商通、平安见证宝、连连支付渠道必传

LegalPersonInfo必填

object

商户法人代表信息，见下文说明

NaturalPersonList选填

array

相关自然人信息列表，见下文说明

数组子类型：object

SettleInfo选填

object

商户结算信息，见下文说明

SalesInfo选填

object

经营场景信息，微信渠道需传入此信息

CredentialFiles选填

array

资质文件列表资质类型，枚举值

数组子类型：object

InterConnectionSubMerchantData选填

string

子商户进件扩展信息，转义后的json字符串，见渠道特殊说明

Action必填

string

公共参数。本接口取值：CreateOpenBankOnlineAsyncAggregatedSubMerchantRegistration

MerchantRole选填

array

平安见证宝、中信e管家必传。如果在后续调用分账接口时作为分账接收方需传入["MERCHANT","PAYEE"]，否则传入["MERCHANT"]

数组子类型：string

请求示例

{
  "Action": "CreateOpenBankOnlineAsyncAggregatedSubMerchantRegistration",
  "OutRegistrationNo": "leonarzhang20240117014",
  "ChannelMerchantId": "CM453726390617904511",
  "OutSubMerchantId": "OM20240117001",
  "ChannelName": "WECHAT",
  "StallNumber": "leonarxxx测试",
  "OutSubMerchantType": "INDIVIDUALBISS",
  "OutSubMerchantName": "深圳市龙岗区平湖信华烟酒行1",
  "ThirdSubMerchantId": "",
  "OutSubMerchantShortName": "平湖信华烟酒行1",
  "NotifyUrl": "http://127.0.0.2:8661/merchant/inner/notifyRegistration",
  "BusinessLicenseInfo": {
    "BusinessLicenseType": "CREDITCODE",
    "BusinessLicenseNumber": "92440300L608515047",
    "BusinessLicenseValidityType": "OTHER",
    "BusinessLicenseEffectiveDate": "2013-01-16",
    "BusinessLicenseExpireDate": "2033-01-16"
  },
  "OutSubMerchantExtensionInfo": {
    "RegionCode": "440302",
    "RegisterAddress": "深圳市-龙岗区",
    "MailingAddress": "深圳市龙岗区平湖街道白坭坑社区丹农路1号深圳海吉星国际农产品物流园C2036",
    "BusinessAddress": "深圳市龙岗区平湖街道白坭坑社区丹农路1号深圳海吉星国际农产品物流园C2036",
    "WebSiteUrl": "http://www.merchant.com",
    "WebName": "webname",
    "EmailAddress": "leonarxxx@tencent.com",
    "ServicePhone": "17620150000",
    "ContactMail": "leonarxxx@tencent.com"
  },
  "LegalPersonInfo": {
    "IdType": "IDCARD",
    "IdNumber": "441423199001010000",
    "PersonName": "张先生",
    "IdValidityType": "OTHER",
    "IdEffectiveDate": "2013-01-16",
    "IdExpireDate": "2033-01-16",
    "ContactPhone": "17620150000",
    "ContactAddress": "广东省惠来县葵潭镇新联管区余家寮糖间内38号"
  },
  "SalesInfo": {
    "SalesScenesType": [
      "SALES_SCENES_STORE"
    ],
    "BizStoreInfo": {
      "BizStoreName": "奶茶店",
      "BizAddressCode": "110101",
      "BizStoreAddress": "腾讯大厦",
      "BizSubAppid": ""
    }
  },
  "NaturalPersonList": [
    {
      "IdType": "IDCARD",
      "IdNumber": "441423199001010000",
      "PersonName": "张先生",
      "PersonType": "4",
      "IdValidityType": "OTHER",
      "IdEffectiveDate": "2013-01-16",
      "IdExpireDate": "2033-01-16",
      "ContactPhone": "17620150000",
      "ContactAddress": "广东省惠来县葵潭镇新联管区余家寮糖间内38号"
    }
  ],
  "SettleInfo": {
    "BankBranchId": "403584001102",
    "BankBranchName": "中国邮政储蓄银行股份有限公司深圳福田区支行",
    "SettleAccountName": "张先生",
    "SettleAccountNumber": "923829739723730000",
    "SettleAccountType": "PRIVATE",
    "SettleMode": "AUTO",
    "SettlePeriod": "T1",
    "AddressCode": "440304"
  },
  "CredentialFiles": [
    {
      "CredentialType": "006",
      "FileType": "jpg",
      "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png"
    },
    {
      "CredentialType": "005",
      "FileType": "jpg",
      "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png"
    },
    {
      "CredentialType": "008",
      "FileType": "jpg",
      "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png"
    },
    {
      "CredentialType": "009",
      "FileType": "jpg",
      "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png"
    },
    {
      "CredentialType": "014",
      "FileType": "jpg",
      "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png"
    },
    {
      "CredentialType": "002",
      "FileType": "jpg",
      "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png"
    },
    {
      "CredentialType": "032",
      "FileType": "jpg",
      "CredentialUrl": "https://5b0988e595225.cdn.sohucs.com/images/20200226/dab44c08f2f2467294da3b7f7a071502.png"
    }
  ],
  "InterConnectionSubMerchantData": "{\"MccId\":\"5399\"}"
}

InterConnectionSubMerchantData 结构

ChannelName = ALLINPAY 时

参数名称	类型	必选	描述
MccId	String	是	商户行业类别码。枚举值
Stores	Array	否	门店列表
+StoreName	String	是	门店名称
PayProducts	Array	是	支付产品信息列表
+PayType	String	是	支付类型。SWIPE:被扫（B扫C），SCAN:扫码（C扫B），PUBLIC:公众号支付，MINI_PROGRAM:小程序。注意：通联渠道传SWIPE、SCAN、PUBLIC
+PayChannel	String	是	支付渠道 ALIPAY：支付宝 WXPAY：微信支付 UNIONPAY：银联
+FeeRate	String	是	费率，百分之n，例如3.5代表百分之3.5。
Busdetail	String	是	经营内容
Taxdetail	Object	否	税务登记详情：在商户性质为企业，选择非三证合一时，税务登记证信息必填
+TaxRegCode	String	是	税务登记号码
+TaxCodeExpire	String	是	税务登记证日期
+TaxCodePic	String	是	税务登记证照片

ChannelName = ALLINPAYCLOUD 时

参数名称	类型	必选	描述
MccId	String	是	商户行业类别码。枚举值
Stores	Array	否	门店列表
+StoreName	String	是	门店名称
Busdetail	String	是	经营内容
Taxdetail	Object	否	税务登记详情：在商户性质为企业，选择非三证合一时，税务登记证信息必填
+TaxRegCode	String	是	税务登记号码
+TaxCodeExpire	String	是	税务登记证日期
+TaxCodePic	String	是	税务登记证照片

ChannelName = WECHAT 时

参数名称	类型	必选	描述
MccId	String	是	商户行业类别码。枚举值

ChannelName = PINGANJZB 时

参数名称	类型	必选	描述
IpAddress	String	是	用户ip地址
MacAddress	String	是	用户mac地址

ChannelName = LIANLIANPAY 时

参数名称	类型	必选	描述
MccId	String	是	商户行业类别码。枚举值

返回参数

Response

200 OK

Response选填

object

返回示例

{
  "Response": {
    "RequestId": "a998b5a0486843bcb4863df0559df97c",
    "Result": {
      "ChannelRegistrationNo": "496542238168324474",
      "ChannelSubMerchantId": "CM496518091627370848",
      "ExternalReturnData": "",
      "RegistrationMessage": "已受理",
      "RegistrationStatus": "INIT",
      "Stores": [
        {
          "StaticPictureKey": "/wecardpay/merchant/allinpay/staticqrcode/qr1682021751-539B5E14DA3944ABA5AB80E14EE204B5.jpg",
          "StoreId": "CM4965180916273708480001",
          "StoreName": "平湖信华烟酒行1",
          "ContractName": "",
          "ContractPhone": "",
          "EnableFlag": 0,
          "StallNumber": "leonarzhang测试"
        }
      ],
      "RegistrationDetailState": "",
      "SmsSendStatus": "",
      "SmsSendFailedMessage": "",
      "AccountId": ""
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

响应状态码

状态码	描述
SUCCESS	成功
MERCHANT.DATA_NOT_EXIST	商户不存在
MERCHANT.INVALID_PARAMETER	参数错误
MERCHANT.MISSING_PARAMETER	缺少参数错误
MERCHANT.SYSTEM_ERROR	系统错误
MERCHANT.DUPLICATE_ENTRY	重复进件

商户线上进件

接口说明

请求参数

子属性

子属性

子属性

子属性

子属性

子属性

子属性

子属性

子属性

子属性

子属性

子属性

请求示例

InterConnectionSubMerchantData 结构

ChannelName = ALLINPAY 时

ChannelName = ALLINPAYCLOUD 时

ChannelName = WECHAT 时

ChannelName = PINGANJZB 时

ChannelName = LIANLIANPAY 时

返回参数

子属性

子属性

返回示例

响应状态码