# 余额

{% hint style="info" %}
遇到 API 接入问题时，可登录 [Eva](https://www.atriptech.com/) 寻求帮助。
{% endhint %}

用这页查看当前账户余额。

### 主要 API

* `balance.do`

### 适用场景

* 支付前的财务检查
* 余额对账
* 余额不足场景的支持确认

### 关键输入

发送：

* `currency`

使用你要查询的余额账户的结算币种。

### 响应会返回什么

响应中通常会包含：

* 账户余额金额
* 结算币种

### 最佳实践

* 大量支付前先查余额
* 确认查询的是正确币种账户
* 返回金额只用于运营检查
* 成功判断以响应 `status` 为准

### 注意事项

* 余额按币种区分
* 余额过低会阻塞 deposit 支付
* `msg` 仅作说明，不应用于业务判断

### 完整 API 参考

完整 schema 和示例见：

[余额](https://resources.atriptech.com/api-wen-dang/api-can-kao/gong-ju-api/yu-e)
