- 支付
- 私域
- 公域
- 营销
- 资金
- 会员
- 信用
- 安全
- 其他
分账剩余金额查询
开发环境
开发环境
GET
/v3/alipay/trade/order/onsettle/query
公共错误码#
业务错误码#
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | INVALID_PARAMETER | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| 400 | ASYNC_ALLOC_IN_PROCESS | 异步分账请求处理中 | 异步分账请求处理中，请稍后重试 |
| 400 | ILLEGAL_SETTLE_STATE | 结算状态非法，当前不允许分账 | 请按错误提示检查结算状态 |
| 400 | MERCHANT_TRADE_NOT_MATCH | 交易与商户不匹配 | 交易不属于该商户，请确定交易号与商户关系。修改后重新发起 |
| 400 | QUERY_NOT_SUPPORT | 不支持的查询场景 | 该订单的业务场景尚未开放分账金额查询，如有需要，可联系支付宝小二反馈 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://dev-cn.your-api-server.com/v3/alipay/trade/order/onsettle/query?trade_no=2023030611001006370061300000' \
--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 ''响应示例响应示例
200 - 成功示例
{
"unsettled_amount": 10
}请求参数
Query 参数
trade_no
string
必需
示例值:
2023030611001006370061300000
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
返回响应
🟢200成功
application/json
Body
unsettled_amount
integer
必需
🟠400请求有误
修改于 2023-11-20 07:01:52