Documentation Index
Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt
Use this file to discover all available pages before exploring further.
Invoicing 是 StablePay 面向商家创建的一次性客户账单产品。它适合 B2B 收款、服务费、批发订单、客户经理维护销售和人工账单流程，帮助商家向指定客户发送正式、可支付、可追踪的账单。
商家在 Merchant Portal 中创建和管理 invoices，并通过邮件、PDF 或 hosted invoice page 交付给客户。当 invoice 为 open 或 past due 时，付款人可以在托管账单页查看账单详情并完成付款。
产品演示
适用场景
当付款需要绑定到指定客户和具体账单时，适合使用 Invoicing。
常见场景包括：
- B2B 或批发订单，买方需要正式 invoice。
- 专业服务、retainer 和客户经理维护的销售流程。
- 由财务或销售团队手动创建付款请求。
- 客户专属金额、到期日、备注和 line items。
- 需要 invoice 状态跟踪、提醒、PDF 和记录留存的流程。
如果你需要一个不预先绑定客户、可公开复用的支付页面，请使用 Payment Links。如果你需要周期计费，请使用 Stablecoin Subscriptions。
工作流程
- 商家在 Merchant Portal 创建 invoice。
- Invoice 包含客户信息、line items、金额、due date 和可选 notes。
- 商家通过 email、PDF 或 hosted invoice page 发送或分享 invoice。
- 付款人打开 hosted invoice page，查看账单详情，并通过 StablePay Checkout 付款。
- StablePay 根据 invoice 生命周期更新 invoice 和 payment 记录。
商家能力
| 能力 | 说明 |
|---|
| 创建和管理 invoices | 在 Merchant Portal 中为指定客户创建一次性账单。 |
| Email delivery | 将 invoice 直接发送到客户邮箱。 |
| PDF download | 下载或分享 invoice PDF，支持采购、财务和线下流程。 |
| Hosted invoice page | 提供托管页面，让付款人查看账单并发起支付。 |
| Reminders | 管理未支付 invoice 的跟进提醒。 |
| Duplicate invoice | 将已有 invoice 复制为新的账单起点，适合重复人工账单流程。 |
| Payment records | 追踪 invoice 付款活动与 StablePay payment records 的关系。 |
Invoice 生命周期
| 状态 | 商家语义 |
|---|
draft | Invoice 正在准备中，尚不可支付。 |
open | Invoice 可支付，可发送或分享给客户。 |
past_due | Invoice 仍为 open，但 due date 已过且仍有未付金额。 |
paid | Invoice 已全额支付。 |
void | Invoice 已作废，不再可支付。 |
past_due 是一个派生展示状态，用于帮助商家识别逾期账单；它不改变 invoice 仍处于 open 且未付清的基本语义。
Hosted invoice page
Hosted invoice page 是 Invoicing 的付款人入口。付款人可以在页面中查看商家信息、客户信息、line items、应付金额、due date 和付款状态，然后发起付款。
| Invoice 状态 | Hosted page 行为 |
|---|
open | 付款人可查看详情并支付。 |
past_due | 付款人仍可查看详情并支付，同时看到逾期上下文。 |
paid | 页面保留用于记录查看和类似 receipt 的付款确认。 |
void | 页面保留用于记录查看，但不能继续支付。 |
Manual invoices 与 subscription invoices
Manual invoices 由商家为一次性客户账单流程创建，属于 Invoicing 产品体验。
Subscription-generated invoices 由订阅计费生命周期创建。它们可能作为 billing records 出现在报表或 invoice 视图中，但在 Portal invoice 工作流里可能是只读的，因为其生命周期由 subscription 系统控制。
Invoicing vs Payment Links
| Invoicing | Payment Links |
|---|
| 面向指定客户和具体账单 | 公开且可复用 |
| 包含 invoice details、due date 和客户上下文 | 客户信息可在 checkout 中收集 |
| 通过 email、PDF 或 hosted invoice page 交付 | 通过托管支付页面或适合二维码的链接分享 |
| 适合 B2B、财务和客户经理维护流程 | 适合活动、社交销售和一对多分发 |
重要说明
- Invoicing 用于指定客户的一次性 invoice 流程，不适合公开复用支付页面。
- 退款基于 payment 发起。Refunding a payment 不会自动改写 invoice 状态机。
- Subscription-linked invoices 可能作为 billing records 存在，但不等同于人工创建的 invoices。
- 当客户需要先查看账单再付款时，应使用 hosted invoice page 作为付款入口。
相关页面
