充值后要确认钱有没有入账,下单后要确认有没有扣费,应查看官方交易记录,而不是只看某一天的余额数字。文档把常用记录分成两类:消费记录,以及充值和余额调整记录。对账时优先用本系统订单号过滤,这一条也写在最佳实践里。
本页不是查账户余额的重复,也不是USDT 充值流程本身。余额是当前钱包;本页是历史流水。动态流量还剩多少,见剩余流量。仅限授权目标。不支持中国大陆使用。
开始前备齐什么
| 准备项 | 从哪里来 |
|---|---|
| 访问令牌或已登录控制台 | 接口需要有效令牌,见登录与 Token |
| 订单号(如有) | 下单或续费返回的本系统订单号;占位符用 ORDER_NO_EXAMPLE |
| 日期范围 | 查询参数格式为 YYYY-MM-DD |
| 产品类型筛选 | 消费记录可按 order_type=static 或 dynamic 过滤 |
占位符(非生产):令牌 TOKEN_EXAMPLE_NOT_REAL,订单号 ORDER_NO_EXAMPLE。不要把文档示例订单号当成你的实单。
两类记录不要混用
| 类型 | 接口 | 用来核对什么 |
|---|---|---|
| 消费记录 | GET /open/app/user/transactions | 动态或静态订单产生的消费 |
| 充值和调整记录 | GET /transaction/agent/transactions | 充值和余额调整是否入账 |
| 当前余额 | 余额接口或控制台 | 流水入账之后的钱包数字,见查余额 |
文档写明:代理商可以查看自己和下级用户记录;普通用户只能查看自己的记录。本页只教买家核对本人流水,不把这条说明扩写成团队子账户或代理商开户教程。那类能力以账号文档为准,且面向的是下游/代理商对接,不是普通控制台买家路径。
消费记录怎么筛
消费记录的常用查询参数如下。分页用 page 和 page_size,每页最大 100 条。
| 参数 | 说明 |
|---|---|
page、page_size | 页码与每页数量,page_size 最大 100 |
order_type | static 或 dynamic |
type | 交易类型(以接口实际取值和说明为准,不在本页编造枚举) |
start_date、end_date | 日期范围,格式 YYYY-MM-DD |
order_no | 按订单号筛选 |
keyword | 搜索备注、类型、订单号或用户名 |
username、target_user_id | 文档列出的筛选条件;普通用户仍只能看到自己权限范围内的记录 |
充值和调整记录文档列出的筛选是 order_no、日期范围、分页,以及受账号权限限制的可选 user_id。不要用消费记录接口去代替充值核对,也不要用充值记录接口去代替订单消费核对。
查询消费记录示例
export ZTPROXY_BASE="https://backend.ztproxy.net/api"
export ZTPROXY_TOKEN="TOKEN_EXAMPLE_NOT_REAL"
curl -X GET "$ZTPROXY_BASE/open/app/user/transactions?page=1&page_size=10&order_type=static" \
-H "Authorization: Bearer $ZTPROXY_TOKEN"
把 order_type 换成 dynamic 可查看动态消费。若要按订单号对账,追加文档中的 order_no 参数,值用你的真实订单号,而不是 ORDER_NO_EXAMPLE。控制台若提供账单或流水页,名称以实际界面为准,但仍建议与接口或导出记录交叉核对。
合规与范围
只用于授权目标。不要把本页写成绕过限制或查看他人账户的教程。价格以控制台与价格方案为准(动态约 $0.40/GB,100 TB 整包约 $0.20/GB;静态共享约 $1.50、独享约 $5 /IP/月)。USDT/USDC 可用;Visa/Mastercard 申请中。不支持中国大陆使用。
FAQ
消费记录和充值记录为什么要分开查?
官方文档把它们分成两个接口。消费记录对应下单产生的扣费;充值和调整是另一类流水。对账时按你要核对的事情选对接口。
普通用户能看到团队里其他人的流水吗?
文档写明普通用户只能查看自己的记录。不要把本页理解成团队子账户管理。
每页最多能查多少条?
消费记录文档写明 page_size 最大 100。最佳实践也提醒列表分页每页不要超过 100 条。
日期参数用什么格式?
YYYY-MM-DD。不要改用时间戳或本地化日期写法去猜接口。
刚充值,流水里还没有怎么办?
先按USDT 充值核对充值订单状态,再查充值和调整记录,最后再查余额。不要立即重复创建充值订单。
可以用交易记录判断静态 IP 已经开通吗?
流水只能帮助核对扣费或调整。静态资源是否已开通,还要看订单列表和实例状态,见购买静态住宅 IP。queued: true 也不等于已经开通。
没有订单号还能查吗?
可以先按日期、产品类型或关键字查。但要对某一笔订单,仍应使用下单时返回的本系统订单号。
价格以哪里为准?
以控制台与价格方案为准。记录里的金额以实际入账为准,不是营销页上的示意价。