商户管理服务
接口列表
开户

开户

开通支付通道的账户，如果想开户的同时生成付款方或者接收方，可以在接口里OpenType传入PAYER或者PAYEE

对于开通平安见证宝的账户需要调用此接口。如果需要使用充值、提现的功能，开出来的账户还需要调用绑定卡接口绑定银行卡

对于开通连连支付的账户需要调用此接口，接口会返回OpenAccountUrl，用户需要跳转到此url进一步填写信息

对于开通微众银行微易管的账户需要调用此接口进行预校验，通过之后调用查询开户接口会返回OpenAccountUrl，将OpenAccountUrl生成二维码，用户使用微信扫描后在小程序上完成开户和签约。

接口说明

请求方式：
post
https://p.wecard.tencent.com/cloudpay/v1/settle/account/open

请求参数

Request
Body 包体
ChannelMerchantId必填
string

业务线id

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

渠道名称: 平安见证宝- PINGANJZB; 通联云商通-ALLINPAYCLOUD; 云南勐腊农村商业银行-YNMLRCB; 连连支付-LIANLIANPAY; 微众银行微易管-WEBANKWYG; 中信e管家-CITICEM; 微信开放平台B2B-WECHATB2B

最小长度：1     最大长度：50
OutAccountId必填
string

外部开户id

最小长度：1     最大长度：50
OutAccountName必填
string

外部户名

最小长度：1     最大长度：50
AccountName必填
string

账户名，如果是个人则为姓名，如果是企业则为企业名称

最小长度：1     最大长度：50
BusinessLicenseType必填
string

证件类型 : IDCARD：身份证，CREDITCODE：统一社会信用代码

最小长度：1     最大长度：50
BusinessLicenseNumber必填
string

证件号

最小长度：1     最大长度：50
LegalPersonOpenFlag选填
string

标识法人本人开户： 否：0 是：1 当BusinessAccountType=ENTERPRISE必传，用于标记上送的实名信息是不是法人

最小长度：1     最大长度：50
Mobile必填
string

手机号

最小长度：1     最大长度：50
AccountType必填
string

账户类型：PERSON:个人 ENTERPRISE:企业 INDIVIDUALBISS:个体工商户

最小长度：1     最大长度：50
LegalPersonInfo选填
object

法人信息，企业和个体工商户必传

DeviceInfo选填
object

设备信息，平安见证宝渠道需传入

OpenType必填
string

开户类型，PAYER-付款人，PAYEE-接收方，PAYER_WITHOUT_ACCOUNT-仅创建付款方，不在渠道开户

最小长度：1     最大长度：50
SettleInfo选填
object

结算银行卡信息，当通道为YNMLRCB、LIANLIANPAY时需传入

ContactAddress选填
string

地址 ChannelName = WECHATB2B 时必传

最小长度：1     最大长度：50
StoreType选填
string

门店类型 ChannelName = WECHATB2B 时必传 枚举值

最小长度：1     最大长度：50
CredentialFiles选填
object

资质文件列表 微众银行微易管渠道开户时需上送身份证正反面、营业执照

请求示例

{
  "ChannelMerchantId": "CM498421386251934960",
  "ChannelName": "PINGANJZB",
  "OutAccountId": "test0000020231219017",
  "OutAccountName": "xxx电子商务有限公司",
  "BusinessAccountType": "ENTERPRISE",
  "AccountName": "xxx电子商务有限公司",
  "BusinessLicenseType": "CREDITCODE",
  "BusinessLicenseNumber": "91230230MA18XU0914",
  "LegalPersonOpenFlag": "0",
  "Mobile": "15600216660",
  "DeviceInfo": {
    "IpAddress": "127.0.0.1",
    "MacAddress": "0000000"
  },
  "LegalPersonInfo": {
    "LegalName": "李先生",
    "LegalLicenseType": "IDCARD",
    "LegalLicenseNumber": "14010719000320171x"
  },
  "OpenType": "PAYER"
}

返回参数

Response
Response选填
object

返回示例

{
  "Response": {
    "RequestId": "948948503842433001",
    "Result": {
      "AccountStatus": "PROCESSING",
      "AccountId": "A479260732391693516"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

ErrCode 码表

错误代码描述解决方案
SUCCESS请求成功请根据 Result 获取请求结果
ORDER.INVALID_PARAMETER参数有误请根据返回描述修正请求参数
FailedOperation.SystemError系统未知异常系统未知异常，请稍后重试
腾讯微卡收付通接口文档