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

新增接收方

录入接收方信息

接口说明

请求方式：
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

请求示例

{
  "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系统未知异常系统未知异常，请稍后重试
腾讯微卡收付通接口文档