inquiryBalance

2026-02-27 16:39

POST /v1/aba/accounts/inquiryBalance

此接口用于查询账户余额。

结构

报文由报文头和报文体组成。本文主要介绍报文体结构信息，有关报文头的结构信息，请参阅：

注意：将每个字段（除数组外）的数据类型设置为字符串。这意味字段值必须使用双引号（" "）括起来。例如：

如果字段的数据类型为整数属性，且其值为 20，设置为 "20"。
如果字段的数据类型为布尔属性，且其值为 true，设置为 "true"。

入参

currencyList Array<CurrencyList>

包含商户查询的货币对应的 3 位 ISO 4217 货币代码列表。

注意：如果未指定此参数，该接口将返回所有币种的余额信息。

出参

result Object REQUIRED

表明此接口是否调用成功。

Show child parameters

accountBalances Array<AccountBalance>

账户余额列表。

注意: 此参数仅在 result.resultStatus 的值为 S 时返回。

Show child parameters

API Explorer

请求

URL

Method

POST

请求体

响应

响应体

结果码

结果码	值	结果码信息	行动建议
SUCCESS	S	成功	接口调用成功，无需进一步操作。
PARAM_ILLEGAL	F	存在非法参数。例如，非数字输入或无效日期。	检查并验证请求字段（包括头部字段和正文字段）是否正确且有效。有关每个 API 的字段详细信息，请参阅具体的 API 结构部分。
UNKNOWN_EXCEPTION	U	由于未知原因，API 调用失败。	服务可能不可用，请稍后重试。如果问题仍然存在，请联系 Antom 技术支持。
CONTRACT_CHECK_FAIL	F	合同检查失败。	在重试之前，请与 Antom 核实合同状态。
USER_NOT_EXIST	F	用户不存在。	使用正确的用户信息重试。
AUTHORIZATION_NOT_EXIST	F	OAuth 授权不存在。	当前的令牌授权不存在，请联系 Antom 技术支持以验证令牌授权。
PROCESS_FAIL	F	发生了一般的业务失败。请勿重试。	通常需要人工干预。建议您联系 Antom 技术支持以解决问题。
OAUTH_FAIL	F	OAuth 流程失败。	请联系 Antom 技术支持以获取详细原因。
INVALID_CLIENT	F	客户端无效。	客户端 ID 不存在或无效。
INVALID_API	F	调用的 API 无效或未激活。	检查是否正在调用正确的 API。
INVALID_SIGNATURE	F	签名无效。	确保请求已使用有效签名正确签名。
METHOD_NOT_SUPPORTED	F	服务器不支持所请求的 HTTP 方法。	确保 HTTP 方法是 POST。
REQUEST_TRAFFIC_EXCEED_LIMIT	U	请求流量超过限制。	再次调用接口以解决问题。如果问题仍然存在，请联系 Antom 技术支持。
FEE_EXCEPTION	U	由于费用相关问题，API 调用失败。	检查参数并再次调用接口以解决问题。如果问题仍然存在，请联系 Antom 技术支持。
UN_SUPPORT_BUSINESS	F	不支持的业务。	使用了无效参数，请使用正确的信息重试。
USER_NO_PERMISSION	F	用户没有权限。	使用其他用户信息重试。
CURRENCY_NOT_SUPPORT	F	不支持该货币。	确保货币输入正确并重试。
USER_ACCOUNT_ABNORMAL	F	用户账户状态异常。	使用不同的用户重试。如果问题仍然存在，请联系 Antom 技术支持以获取更多详细信息。
REPEAT_REQ_INCONSISTENT	F	重复请求不一致。	确保请求中的所有字段相同并重试。
USER_STATUS_ABNORMAL	F	用户状态异常。	使用另一张卡重试。用户状态异常，请使用另一笔订单重试。
BALANCE_NOT_ENOUGH	F	余额不足。	确保余额充足并重试。
AMOUNT_EXCEED_LIMIT	F	金额超出限制。	确保提交的金额正确并重试。
CONTRACT_NOT_EXIST	F	合同不存在。	确保商户已签署合同且输入正确。
QUOTE_EXPIRED	F	报价已过期。	调用 consultPayout 接口创建新报价。使用新报价重试以创建新的结算请求。
AVAILABLE_QUOTA_NOT_ENOUGH	F	支付配额不足。	调用 inquiryAvailableQuota 接口检查当前可用的支付配额，确保其充足并重试。
CARD_INFO_NOT_MATCH	F	卡片信息不匹配。	使用正确的卡片信息重试。
SYSTEM_ERROR	F	系统错误。	请勿重试，并联系 Antom 技术支持以获取更多详细信息。
SERVICE_NOT_ALLOWED	F	服务不允许。	使用正确的信息重试。如果问题仍然存在，请联系 Antom 技术支持。
ACCESS_TOKEN_EXPIRED	F	访问令牌已过期。	刷新令牌以获取新的访问令牌，或者联系 Antom 技术支持以解决此问题。