admin 2026-08-16 17:11:03 卡组百科

查询分账

智能分账接口列表查询分账查询分账

查询分账状态

接口说明

用途:查询分账请求方式:posthttps://p.wecard.tencent.com/cloudpay/v1/settle/profit/profit-query复制

请求参数

RequestBody 包体OutProfitOrderId选填string外部商户分账单号。调用请求分账接口后的查询传入此参数

最小长度:1 最大长度:50OutOrderId选填string外部订单号。请优先使用 OutProfitOrderId 参数进行查询。当不知道外部分账单号时可使用 OutOrderId 查询。当下单传分账域、同步订单分账、使用分账模板传入此参数

请求示例{

"OutProfitOrderId": "out202305290002"

}

返回参数

Response200 OKResponse必填object子属性RequestId必填stringResult选填object子属性OutOrderId必填string外部订单号,即业务系统侧订单

最小长度:1 最大长度:50OutProfitOrderId选填string外部商户分账订单号

最小长度:1 最大长度:50ProfitOrderId选填string腾讯云商付分账订单号

ProfitStatus选填string分账状态,后续不再维护,建议去判断ProfitFlowList里的ProfitStatus字段。"INIT": 等待分账,"PROCESSING": 分账中,"FINISHED": 分账完成

ProfitFlowList必填array分账明细列表

数组子类型:object子属性ProfitId必填string腾讯云商付分账流水Id

PayeeId选填string腾讯云商付分账接收方Id

InChannelSubMerchantId选填string被分账商户ID。和 PayeeId 2选1

ProfitAmount必填integer分账金额,单位【分】

ProfitStatus必填string分账状态,"INIT": 等待分账,"PROCESSING": 分账中,"SUCCESS": 分账成功,"FAILED": 分账失败,"SETTLE_BACK": 退票(平安银企直联和招行通道有此枚举,表示银行转账后被退票)

FailReason选填string失败原因

ChannelSubMerchantId选填string分账出资商户ID,对应 FundAllocateList 里的 ChannelSubMerchantId 参数

BillId选填string账单id

CoverFeeAmount选填integer承担手续费。当分账时传了IsFeeCovered需关注此字段,分账接收方实际到账金额为分账金额减去此金额。此金额在拉取到交易手续费后才会更新

ThirdProfitId选填string第三方支付渠道分账明细订单id

ErrCode必填stringErrMessage必填string返回示例{

"Response": {

"RequestId": "948948503842433001",

"Result": {

"OutProfitOrderId": "out202305290002",

"OutOrderId": "CM453726693345990015",

"ProfitOrderId": "p202305290002",

"ProfitStatus": "INIT",

"ProfitFlowList": [

{

"ProfitId": "flow20230715000",

"PayeeId": "PE462771186506407098",

"ProfitAmount": 2,

"ProfitStatus": "INIT"

},

{

"ProfitId": "flow20230715001",

"PayeeId": "PE462771261534117050",

"ProfitAmount": 2,

"ProfitStatus": "INIT"

}

]

},

"ErrCode": "SUCCESS",

"ErrMessage": "成功"

}

}

ErrCode 码表

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