付款
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