商户管理服务
接口列表
商户录入

商户录入

线下提交资料以后，客户拿到合作渠道商户ID，进行渠道子商户线下录入

接口说明

请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/merchant/out/channelSubMerchant/createOpenBankOfflineSubRegistration

请求参数

Request
Body 包体
OutRegistrationNo必填
string

外部入驻号

最小长度：0     最大长度：50
OutSubMerchantId必填
string

外部子商户ID

最小长度：0     最大长度：50
ChannelMerchantId必填
string

业务线ID

最小长度：0     最大长度：50
ChannelName必填
string

渠道名称: 微信-WECHAT; 微企付-ENTPAY; 通联-ALLINPAY; 平安见证宝-PINGANJZB; 通联云商通-ALLINPAYCLOUD; 连连支付-LIANLIANPAY; 微众银行微易管-WEBANKWYG; 工商银行聚富通-ICBCJFT; 农业银行-ABCPAY; 中信E管家-CITICEM; 微信开放平台B2B-WECHATB2B; 农业银行综合收银台-ABCZHSYT

最小长度：0     最大长度：50
OutSubMerchantType必填
string

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

最小长度：0     最大长度：50
OutSubMerchantName必填
string

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

OutSubMerchantShortName必填
string

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

最小长度：0     最大长度：50
ThirdSubMerchantId必填
string

合作渠道商户号

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

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

InterConnectionSubMerchantData选填
string

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

Action必填
string

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

MerchantRole选填
array

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

数组子类型：string

请求示例

{
  "Action": "CreateOpenBankOfflineAggregatedSubRegistration",
  "OutRegistrationNo": "leonarzhang20240117014",
  "ChannelMerchantId": "CM453726390617904511",
  "OutSubMerchantId": "OM20240117001",
  "ChannelName": "WECHAT",
  "StallNumber": "leonarxxx测试",
  "OutSubMerchantType": "INDIVIDUALBISS",
  "OutSubMerchantName": "深圳市龙岗区平湖信华烟酒行1",
  "ThirdSubMerchantId": "9549819659999027",
  "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"
  },
  "InterConnectionSubMerchantData": "{\"MccId\":\"5399\"}"
}

返回参数

Response
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重复进件
腾讯微卡收付通接口文档