余额、预算与订单对账
本页内容
查询自己账号的可用余额、API 付款预算、订单和资金流水。先分清四类数据的用途,再按业务需要读取和核对。
选择查询内容
| 数据 | 回答什么问题 |
|---|---|
| 余额 | 当前站内可用金额是多少,以什么单位展示。 |
| API 预算 | 账号和这套 API 程序还允许支付多少金额。 |
| 订单 | 某笔业务购买了什么,处于什么状态。 |
| 资金流水 | 哪次业务使余额增加或减少。 |
前提条件
使用本人账号已授权的长期凭据,按需授予余额、预算、订单或流水读取动作。账号级财务查询需要覆盖本人全部自有应用,不能用仅授权某个应用的范围读取全账号账单。
查询余额与金额单位
读取返回的金额和 currency。金额使用十进制字符串,单位由平台配置,可能为人民币、美元、欧元或点数。不要在程序中固定写成“元”,也不要自行进行外币换算。
Python SDK
def read_balance_and_budget(client):
balance = client.get_balance()["data"]
budget = client.get_payment_budget()["data"]
return balance, budget # 金额保留十进制字符串,并显示返回的金额单位。
def read_order_page(client, status=None, cursor=None):
return client.list_orders(limit=50, cursor=cursor, status=status)["data"]查询付款预算
同时检查账号层与当前 API 应用层的单笔、日和月额度,以及已用金额、剩余额度和重置时间。余额与预算用途不同:有余额也可能因预算不足而拒绝付款。
查询预算不会修改额度。金额单位变化或财务状态需要核对时,应先解决原因,再确认新的付款业务。
查询订单与资金流水
- 订单列表按需要选择状态,首次查询不传 cursor。
- 处理 items 后,将非空 next_cursor 带入下一页,保持其他条件不变。
- 用原付款回执的 order_id 与订单、资金流水关联信息核对。
订单编号和 API 订单 ID不同。对退款等接口使用返回的完整 API ID,不从展示文本中截取。流水中的 before、change 和 after 表示余额快照与变动,不应重复作为另一笔订单记账。
对账与异常处理
订单状态与资金变动分别以对应记录为准,并按返回的留存标记解释历史完整性。付款或退款响应丢失时先查原报价、订单及回执,不能换业务 ID 重复执行。