通用场景
可查询请求方的支付宝账户余额信息。
公共请求参数
业务请求参数
account_type必选string(32)
【描述】查询的账号类型，查询余额账户值为acctrans_account。必填。
【枚举值】
余额户查询: acctrans_account
托管账户查询: trusteeship_account
【示例值】acctrans_account
以下参数 二选一 传入
alipay_user_idstring(20)
【描述】支付宝会员 id。
新商户建议使用alipay_open_id替代该字段。对于新商户，alipay_user_id字段未来计划逐步回收，存量商户可继续使用。如使用alipay_open_id，请确认 应用-开发配置-openid配置管理 已启用。无该配置项，可查看openid配置申请。
【示例值】2088301409188095
alipay_open_idstring(64)
【描述】支付宝openid 详情可查看 openid简介
【示例值】061p6nablcwdwjodrxsvvoyz-ufp-3wqaa4e_szqymftxse
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.fund.account.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"alipay_user_id":"2088301409188095",
"alipay_open_id":"061p6nablcwdwjodrxsvvoyz-ufp-3wqaa4e_szqymftxse",
"account_type":"acctrans_account"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
available_amount必选string(15)
【描述】账户可用余额，单位元，精确到小数点后两位。
【示例值】26.45
amount_detail｜余额明细必选balanceaccountdetail
【描述】支付宝账户的余额成份明细，仅当查询日终余额明细时返回
acs必选string(64)
【描述】acs余额，单位：元
【示例值】100.00
bank必选string(64)
【描述】bank余额，单位：元
【示例值】100.00
freeze_amount特殊可选string(15)
【描述】当前支付宝账户的实时冻结余额
【示例值】11.11
total_amount｜总余额可选string(64)
【描述】支付宝账户的余额总数，仅当查询日终余额明细时返回。单位：元
【示例值】100.00
响应示例
正常示例
异常示例
{
"alipay_fund_account_query_response": {
"code": "10000",
"msg": "success",
"available_amount": "26.45",
"freeze_amount": "11.11",
"total_amount": "100.00",
"amount_detail": {
"acs": "100.00",
"bank": "100.00"
}
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| alipay_account_not_exist | 对方没有支付宝账户，可使用转账到卡服务给对方银行卡转账 | 对方没有支付宝账户，可使用转账到卡服务给对方银行卡转账 |
| authoree_is_not_match | 请求的partner_id与支付授权协议的被授权方不一致 | 请检查授权协议的签约的partner_id是否与本次请求的partner_id一致 |
| auth_code_error | 授权信息不存在 | 授权信息不存在，请检查协议号是否正确 |
| auth_info_not_exists | 授权信息不存在 | 授权信息不存在，请检查协议号是否正确 |
| auth_userid_is_not_match | 支付授权协议的授权方与查询的alipay_user_id不匹配 | 请检查支付授权协议授权方与alipay_user_id的一致性 |
| merchant_agreement_verify_fail | 支付授权协议对应的partner_id的商户协议校验失败 | 请检查请求的partner_id是否签约支付授权签约产品 |
| no_permission | 没有接口使用权限 | 确认是否有查询余额权限 |
| no_permission_account | 无权限操作当前付款账号 | 无权限操作当前付款账号 |
| trusteeship_account_not_exist | 托管子户查询不存在 | 托管子户查询不存在 |
| user_agreement_is_out_of_date | 用户协议已过期 | 请联系授权方重新进行支付授权协议的签约，并更新agreement_no |
| user_agreement_status_abnormal | 用户协议状态不正常 | 用户协议状态不正常，请检查协议有效性 |
| user_agreement_verify_fail | 用户协议校验失败 | 请检查用户协议号是否正确 |