跳转到主要内容
1签 (OneSign)

余额、预算与订单对账

本页内容

查询自己账号的可用余额、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 应用层的单笔、日和月额度,以及已用金额、剩余额度和重置时间。余额与预算用途不同:有余额也可能因预算不足而拒绝付款。

查询预算不会修改额度。金额单位变化或财务状态需要核对时,应先解决原因,再确认新的付款业务。

查询订单与资金流水

  1. 订单列表按需要选择状态,首次查询不传 cursor。
  2. 处理 items 后,将非空 next_cursor 带入下一页,保持其他条件不变。
  3. 用原付款回执的 order_id 与订单、资金流水关联信息核对。

订单编号和 API 订单 ID不同。对退款等接口使用返回的完整 API ID,不从展示文本中截取。流水中的 before、change 和 after 表示余额快照与变动,不应重复作为另一笔订单记账。

对账与异常处理

订单状态与资金变动分别以对应记录为准,并按返回的留存标记解释历史完整性。付款或退款响应丢失时先查原报价、订单及回执,不能换业务 ID 重复执行。

只读财务权限不包含付款或退款权限。需要购买时分别阅读分发套餐或签名服务开通。