stable · guide · 0.1.0

付款、退款與電子發票

Recurring charge

建立 Payment Transaction 時可附帶 period_type、frequency 與 execution_count。三個欄位必須一起提供。每次續扣結果會產生獨立 Domain Event；取消 recurring schedule 也使用新的 Idempotency-Key，並以 recurring cancellation outcome 確認 provider 狀態。

Refund

只有 settled 的 ECPay credit-card Payment Transaction 可以退款。Project Backend 決定退款原因與金額，MiniCenter 驗證剩餘可退金額並追蹤 Refund 的 processing、succeeded 或 failed 狀態。同一業務退款重試必須沿用原本的 Idempotency-Key。

Refund 成功不會變更 Project Order、Entitlement 或 Invoice Issuance；Project Backend 必須各自處理這些商務後果。

Invoice Issuance

電子發票需由 Platform Operator 先為 Project Client 啟用。只能對 settled Payment Transaction 開立，品項總額必須等於付款金額。Invoice Issuance 有自己的 processing、succeeded 與 failed 狀態；付款流程不會等待發票完成。

目前公開介面支援消費者電子發票。Refund 之後的作廢或折讓是獨立作業，不應從 Refund 狀態推測。