查询接收方

录入接收方信息

接口说明

请求方式：

post

https://p.wecard.tencent.com/cloudpay/v1/settle/payee/account-query

请求参数

Request

Body 包体

PayeeId选填

string

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

最小长度：1 最大长度：32

OutPayeeId选填

string

外部接收方id，分账接收方在业务系统的唯一标识，与PayeeId不能同时为空

最小长度：1 最大长度：32

请求示例

{
  "OutPayeeId": "out202305290002",
  "PayeeId": "P2023052900002"
}

返回参数

Response

200 OK

Response必填

object

返回示例

{
  "Response": {
    "RequestId": "948948503842433001",
    "Result": {
      "PayeeId": "PE462771261534117050",
      "OutPayeeId": "out202305290002",
      "PayeeName": "test22",
      "PayeeShortName": "test1",
      "PayeeType": "ENTERPRISE",
      "BusinessLicenseNumber": "1000000000000002",
      "LegalName": "test001",
      "SettleAccountType": "PRIVATE",
      "SettleAccountName": "吴好",
      "SettleAccountNumber": "6214831150131511",
      "SettlePeriod": "T1",
      "BankName": "招商银行深圳分行",
      "BankCode": "75",
      "BankAddress": "深圳市",
      "BankBranchName": "招商银行深圳分行",
      "BusinessLicenseType": "IDCARD",
      "PayeeRoleId": "RID0000000001",
      "PayeeRoleName": "视频号小店分享员"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

ErrCode 码表

错误代码	描述	解决方案
SUCCESS	请求成功	请根据 Result 获取请求结果
ORDER.INVALID_PARAMETER	参数有误	请根据返回描述修正请求参数
RECORD_NOT_EXIST	分账接收方不存在	请检查分账接收方id是否正确
FailedOperation.SystemError	系统未知异常	系统未知异常，请稍后重试