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

更新接收方

更新接收方信息

接口说明

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

请求参数

Request
Body 包体
PayeeId选填
string

微卡接收方id,与OutPayeeId不能同时为空

最小长度:1     最大长度:32

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

请求示例

{
  "OutPayeeId": "out202305290002",
  "PayeeId": "P2023052900002",
  "PayeeName": "payeeName001",
  "PayeeType": "PERSONAL",
  "BusinessLicenseType": "IDCARD",
  "BusinessLicenseNumber": "1000000000000002",
  "SettleAccountType": "PRIVATE",
  "SettleAccountName": "结算名称",
  "SettlePeriod": "T1",
  "SettleAccountNumber": "A00000002",
  "BankCode": "CMB",
  "BankName": "招商银行",
  "BankBranchName": "招商银行深圳分行",
  "PayeeShortName": "payeeShortName",
  "LegalName": "",
  "BankAddress": "",
  "PayeeRoleId": "RID0000000001"
}

返回参数

Response
Response必填
object

返回示例

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

ErrCode 码表

错误代码描述解决方案
SUCCESS请求成功请根据 Result 获取请求结果
ORDER.INVALID_PARAMETER参数有误请根据返回描述修正请求参数
FailedOperation.SystemError系统未知异常系统未知异常,请稍后重试

腾讯微卡收付通接口文档