- 支付
- 私域
- 公域
- 营销
- 资金
- 会员
- 信用
- 安全
- 其他
分账关系查询
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/trade/royalty/relation/batchquery
公共错误码#
业务错误码#
状态码 | 错误码 | 错误描述 | 解决方案 |
---|---|---|---|
400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
400 | INVALID_PARAMETER | 参数有误 | 请根据接口返回的参数非法的具体错误信息,修改参数后进行重试 |
400 | OPENID_APPID_NOT_MATCH | OPENID值和APPID不匹配 | 检查当前接口调用时使用的appId与获取openId时使用的appId是否是同一个(需一致) |
400 | PRODUCT_UNSIGN | 未签约分账产品 | 商户需在签约分账产品的情况下,才可进行 分账关系集的查询操作。请先确认商户是否签约分账产品。 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/trade/royalty/relation/batchquery' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
"page_num":1,
"page_size":20,
"out_request_no":"2019032200000001"
}'
响应示例响应示例
200 - 成功示例
{
"result_code":"SUCCESS",
"receiver_list":[
{
"type":"userId",
"account":"2088xxxxx00",
"memo":"分账给测试商户",
"login_name":"test@alitest.xyz",
"bind_login_name":"test@alitest.xyz"
}
],
"total_page_num":10,
"total_record_num":480,
"current_page_num":1,
"current_page_size":20
}
请求参数
Header 参数
authorization
string
必需
示例值:
ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign
alipay-request-id
string
必需
示例值:
$requestid
Content-Type
string
必需
示例值:
application/json
Body 参数application/json
page_num
integer
必需
page_size
integer
可选
out_request_no
string
可选
示例
返回响应
🟢200成功
application/json
Body
result_code
string
【描述】业务结果码。SUCCESS:分账关系查询成功;FAIL:分账关系查询失败。
receiver_list
array [object {5}]
【描述】分账收款方列表
type
string
可选
account
string
可选
memo
string
可选
login_name
string
可选
bind_login_name
string
可选
total_page_num
integer
【描述】总页数
total_record_num
integer
【描述】分账关系记录总数
current_page_num
integer
【描述】当前页数
current_page_size
integer
【描述】当前页面大小
🟠400请求有误
修改于 2023-11-20 08:18:07