交易单是 Subotiz 计费系统中的核心账单记录，用于追踪所有支付、退款与争议活动。Subotiz 的 交易单会完整记录所有支付与账单活动，包括订阅开通、续费、按量计费以及一次性购买。每一笔交易单都对应商户侧的一笔实际订单，用于确保顾客支付结果与商户系统中的订单状态一致。通过交易单，商家可以清晰掌握支付结果、退款处理、计费异常及争议情况，是 Subotiz 计费体系中最核心、最重要的数据实体之一。
交易单在计费系统中的作用
系统在处理支付动作时，会自动生成交易单，用于记录完整交易生命周期，包括订单类型、支付方式、金额、顾客信息、交易来源国家、支付失败原因等。
交易单的主要作用包括：
- 实时反映订单状态（待支付、审核中、已支付、退款等）
- 作为发票、退款、争议处理的唯一数据来源
- 作为对账依据，确保账目准确、一致、可追溯
- 作为交易事件的统一入口（时间轴记录支付与退款全流程）
系统会在以下场景自动生成交易单
- 新订阅开通时
- 订阅自动续费时
- 一次性商品付款时
- 试用方案绑定支付方式时（含 0 元授权）
- Token / 按量计费订单生成时
- 支付方式验证（如 0 元扣款验证）
- 使用 OpenAPI 创建支付单时
交易单关联的其他计费记录
- 交易单：对应商户的核心订单实体，当前状态包括：待处理、支付渠道审核中、已支付、部分退款、全额退款。
- 退款单：记录退款申请及最终处理结果。
- 争议订单：跟进拒付或争议案件的处理进度。
退款处理机制
所有退款都源于交易单，确保每笔退款均关联到具体的原始交易，并通过相同的支付通道处理。 当商户发起退款时，系统会自动生成一笔退款订单并跟踪结果。退款成功后，原交易单状态会更新，相关发票也会更新为 全额退款 或 部分退款。
交易单字段说明
每一笔交易单都包含结构化的核心数据：
- 交易单ID：Subotiz 系统内的唯一标识。
- 外部订单ID：商户系统中的对应订单编号。
- 订单类型：如订阅开通、续费、一次性购买。
- 支付方式：信用卡、PayPal 或其他支持的渠道。
- 顾客：购买方的唯一标识。
- 订单金额：本次交易的收款金额。
- 创建时间：订单生成的具体时间。
- 订单状态：待处理、支付渠道审核中、已支付、部分退款、全额退款。
后台查看交易单
操作路径：进入 交易 > 交易单，即可查看全部记录。列表中会显示交易单 ID、外部订单 ID、顾客、订单类型、支付方式、创建时间、状态及金额等关键信息。
在交易单列表页，商户可以：
- 使用订单信息（交易单 ID 或外部订单 ID）进行搜索。
- 按订单类型、状态 或支付方式 筛选记录。
- 通过日历选择时间范围筛选。
- 点击任意订单行，打开交易单详情页，查看完整的交易数据与退款记录（如有）。
交易单功能帮助商户在 Subotiz 中统一管理所有计费记录，将支付、退款与争议紧密连接，确保全流程清晰可追溯，并提升对账效率。