通用场景
当商户签约分账产品后，授权isv帮其进行分账关系的维护。本接口用于商户与分账方的关系绑定。
公共请求参数
业务请求参数
receiver_list必选royaltyentity[]
【描述】分账接收方列表，单次传入最多20个
name特殊可选string(256)
【描述】分账接收方真实姓名。
绑定分账关系时：
当分账方类型是userid时，本参数可以不传，若上传则进行校验不上传不会校验。
当分账方类型是loginname时，本参数必传。
解绑分账关系时：作为请求参数可不填，分账关系查询时不作为返回结果返回
【示例值】测试名称
type｜分账接收方类型可选string(32)
【描述】分账接收方类型。
【枚举值】
支付宝账号对应的支付宝唯一用户号: userid
支付宝登录号: loginname
支付宝openid: openid
【示例值】userid
account可选string(32)
【描述】分账接收方账号。 当分账方类型是userid时，本参数为用户的支付宝账号对应的支付宝唯一用户号，以2088开头的纯16位数字； 当分账方类型是loginname时，本参数为用户的支付宝登录号；当分账方类型是openid时，本参数传递支付宝openid信息。
【示例值】2088xxxxx00
account_open_id｜分账方 openid可选string(128)
【描述】分账接收方openid，本参数为分账接收方在该应用（appid）下的唯一用户标识，仅用于分账关系查询接口出参。
【示例值】093pjtapyb2ukq0mxk_x86z_famou-dtieverq8x8yqkaef
memo可选string(256)
【描述】分账关系描述
【示例值】分账给测试商户
login_name可选string(150)
【描述】作为查询返回结果：当前userid对应的支付宝登录号。当login_name与bind_login_name不相等时，表明该支付宝账户发生了登录号变更。
【示例值】test@alitest.xyz
bind_login_name可选string(150)
【描述】作为查询返回结果：分账收款方绑定时的支付宝登录号。分账关系绑定（alipay.trade.royalty.relation.bind）时，通过type为loginname绑定传入的支付宝登录号，若使用userid绑定则不返回。
【示例值】test@alitest.xyz
out_request_no必选string(32)
【描述】外部请求号，由商家自定义。32个字符以内，仅可包含字母、数字、下划线。需保证在商户端不重复。
【示例值】2019032200000001
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.trade.royalty.relation.bind&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"receiver_list":[
{
"login_name":"test@alitest.xyz",
"name":"测试名称",
"memo":"分账给测试商户",
"account_open_id":"093pjtapyb2ukq0mxk_x86z_famou-dtieverq8x8yqkaef",
"bind_login_name":"test@alitest.xyz",
"type":"userid",
"account":"2088xxxxx00"
}
],
"out_request_no":"2019032200000001"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
result_code必选string(16)
【描述】success：分账关系绑定成功；
fail：分账关系绑定失败。
【枚举值】
分账关系绑定成功: success
分账关系绑定失败: fail
【示例值】success
响应示例
正常示例
异常示例
{
"alipay_trade_royalty_relation_bind_response": {
"code": "10000",
"msg": "success",
"result_code": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| invalid_receiver_type | 分账收款方类型参数非法 | 请检查分账收款方类型参数 |
| openid_appid_not_match | openid与appid不匹配 | 检查当前接口调用时使用的appid与获取openid时使用的appid是否是同一个（需一致） |
| product_unsign | 未签约分账产品 | 商户需在签约分账产品的情况下，才可进行分账关系集的新增操作。请先确认商户是否签约分账产品。 |
| receiver_account_not_certify | 分账收款方账号未完成实名认证 | 请在支付宝完成实名认证，或更换一个已认证账号作为分账收款方 |
| receiver_account_no_balance | 分账收款方账号无支付宝账户 | 分账收款方支付宝账号未开立余额账户，请确认收款方账号是否正确，更换账号后重新发起 |
| receiver_account_state_invalid | 分账收款方账号被冻结或已注销 | 分账收款方账号被冻结或已注销，请联系支付宝小二确认原因 |
| receiver_list_empty | 分账收款方列表为空 | 请检查分账收款方列表是否为空 |
| receiver_list_overload | 分账收款方列表数量超限 | 请检查分账收款方列表数量是否超过了20 |
| relation_quantity_limit | 达到分账关系集数量上限 | 分账关系集数量有上限，当达到上限后，无法继续添加分账方。可删除无用的分账方后，再发起分账关系绑定。 |
| username_not_match | 分账接收方全称不匹配 | 请检查分账方全称是否正确 |
| user_not_exist | 分账接收方不存在 | 请确认分账接收方类型或者账号无误后重试 |