智能分账
接口列表
新增接收方

新增接收方

录入接收方信息

接口说明

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

请求参数

Request
Body 包体
ChannelSubMerchantId必填
string

微卡收付通平台商户编号（管理控制台→商户管理→商户ID）

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

外部接收方id，分账接收方在业务系统的唯一标识

最小长度：1     最大长度：32
PayeeName必填
string

接收方名称.如某经销有限公司，建议是企业名称或自然人姓名

最小长度：1     最大长度：32
PayeeShortName选填
string

接收方简称

最小长度：0     最大长度：32
PayeeType必填
string

接收方类型，ENTERPRISE:企业,PERSON: 个人

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

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

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

社会组织代码

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

法人名称

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

结算账户类型：PRIVATE-对私，BUSINESS-对公

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

结算账户名称

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

结算账号

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

分账周期：T1-工作日隔天分账,D0-准实时分账

最小长度：1     最大长度：32
BankName必填
string

银行开户行名称

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

银行开户支行名

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

银行开户行号

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

银行开户行地址

最小长度：1     最大长度：200
PayeeRoleId选填
string

接收方角色id

PhoneNo选填
string

手机号

最小长度：11     最大长度：11

请求示例

{
  "ChannelSubMerchantId": "CM453726693345990015",
  "OutPayeeId": "out202305290002",
  "PayeeName": "payeeName001",
  "PayeeType": "PERSON",
  "BusinessLicenseType": "IDCARD",
  "BusinessLicenseNumber": "421083199908088888",
  "SettleAccountType": "PRIVATE",
  "SettleAccountName": "王二小",
  "SettlePeriod": "T1",
  "SettleAccountNumber": "6214831150131511",
  "BankCode": "308651020179",
  "BankName": "招商银行",
  "BankBranchName": "招商银行成都分行",
  "PayeeShortName": "payeeShortName",
  "LegalName": "",
  "BankAddress": "成都市天府大道北段1480号科技孵化园德商国际A座",
  "PayeeRoleId": "RID0000000001"
}

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "948948503842433001",
    "Result": {
      "PayeeId": "PE462771261534117050"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

ErrCode 码表

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