分账关系查询

当商户签约分账产品后，授权ISV帮其进行分账关系的维护。本接口用于商户与分账方的关系查询。

公共错误码

业务错误码

状态码	错误码	错误描述	解决方案
400	SYSTEM_ERROR	系统繁忙	服务器异常可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试
400	INVALID_PARAMETER	参数有误	请根据接口返回的参数非法的具体错误信息，修改参数后进行重试
400	OPENID_APPID_NOT_MATCH	OPENID值和APPID不匹配	检查当前接口调用时使用的appId与获取openId时使用的appId是否是同一个（需一致）
400	PRODUCT_UNSIGN	未签约分账产品	商户需在签约分账产品的情况下，才可进行分账关系集的查询操作。请先确认商户是否签约分账产品。

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" }'

{ "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

必需

【描述】外部请求号，由商家自定义。32个字符以内，仅可包含字母、数字、下划线。需保证在商户端不重复。

page_size

integer

可选

【描述】几页，起始页为 1。不填默认为 1。

out_request_no

string

可选

【描述】页面大小。每页记录数，取值范围是(0,100]。不填默认为20

示例

返回响应

🟢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请求有误

分账关系查询

公共错误码#

业务错误码#

请求参数

返回响应

公共错误码

业务错误码