付款
AM 會自動追蹤來自 Stripe 的付款,也支援手動記錄其他來源的付款。
付款歷程隸屬於帳戶,你可以清楚掌握誰在何時支付了哪些款項。
付款紀錄
{
id: "pay_...",
account_id: "acc_...",
amount_cents: 9900, // cents
currency: "usd",
status: "succeeded",
payment_method: "card",
external_id: "pi_..."
}
操作
| 操作 | Endpoint | 說明 |
|---|---|---|
| 建立 | POST /api/accounts/:account_id/payments | 記錄付款 |
| 列表 | GET /api/accounts/:account_id/payments | 付款歷史 |
| 取得 | GET /api/payments/:payment_id | 付款詳情 |
| 更新 | PATCH /api/payments/:payment_id | 更新中繼資料 |
付款狀態
| 狀態 | 說明 |
|---|---|
pending | 等待處理中 |
succeeded | 付款完成 |
failed | 付款失敗 |
canceled | 付款已取消 |
refunded | 已退款給客戶 |
付款方式
| 類型 | 說明 |
|---|---|
card | 信用卡/簽帳金融卡 |
ach | 銀行轉帳(美國) |
wire | 電匯 |
other | 其他方式 |
自動追蹤
Stripe 付款會透過 webhook 自動記錄。手動追蹤通常用於:
- 銀行轉帳
- 支票
- 外部支付服務
- 折抵/調整
中繼資料
可在付款上附加商業上下文:
- 購買的方案或產品
- 發票參考編號
- 自訂追蹤 ID