收付款

订单与对账

查询订单、理解每个字段，并与你的账目对账。

查询订单

按 HTP id：

http

GET /open/v1/orders/0b7a9c62-3f1e-4a2b-9d6c-5e4f3a2b1c0d

按你自己的单号（order_type 默认 PAYMENT；退款用 out_refund_no 并指定 REFUND）：

http

GET /open/v1/orders?out_order_no=A20261107-0001&order_type=PAYMENT

注意签名的路径包含查询串。

字段	类型	说明
`id`	UUID	HTP 订单 ID
`out_order_no`	string	你的单号（退款为 `out_refund_no`）
`order_type`	enum	`PAYMENT`、`REFUND`、`PAYOUT`
`parent_id`	UUID	仅退款：被退款的收款单
`environment`	enum	`SANDBOX`、`PRODUCTION`
`status`	enum	收款：`CREATED`、`PAID`、`CLOSED`；退款、付款：`SUCCEEDED`
`amount`	金额	订单金额
`refunded_amount`	金额	收款单：累计已退款
`fee_amount`	金额	收款单：平台手续费。退款、付款为 `0.00`
`net_amount`	金额	收款单：你的入账金额（`amount − fee_amount`）。其他等于 `amount`
`currency`	string	`USDT`
`description`	string	你的说明或退款原因
`user_sub`	string	付款人 / 收款人 `sub`。未指定 `payer_sub` 且未支付的收款单为空
`checkout_url`	URL	仅 `CREATED` 且未过期的收款单
`expires_at`	时间	收款单的支付截止时间
`completed_at`	时间	支付 / 完成时间
`created_at`	时间	创建时间

没有值的字段可能不出现在 JSON 中。之后可能新增字段 —— 请忽略未知字段。

每天将你的记录与 HTP 核对：

在控制台打开订单 → 账单，下载一段日期的 CSV（UTC 日期，最多 31 天）。
按 out_order_no 和 order_type 匹配你的订单，比对 status、amount、fee_amount、net_amount。
对你系统中仍为“待支付”的订单调用 GET /open/v1/orders/{id}：PAID 说明漏收了回调；CLOSED 说明已过期。
当天钱包余额变化应等于 Σ 已支付收款单的 net_amount − Σ 退款金额 − Σ 付款金额，如果用同一钱包测试，还要加上沙箱手续费返还。

沙箱手续费返还

沙箱收款单的 fee_amount 和 net_amount 与生产计算方式完全一致，但手续费会以一笔单独的“沙箱手续费返还”入账退回你的钱包，测试不产生成本。