支払い
AccountMaker（以下「AM」）は Stripe からの支払いを自動で記録し、その他の支払いソースは手動で記録できます。
支払い履歴は Account に紐づくため、誰がいつ何を支払ったかを常に追跡できます。
支払いレコード
{
id: "pay_...",
account_id: "acc_...",
amount_cents: 9900, // cents
currency: "usd",
status: "succeeded",
payment_method: "card",
external_id: "pi_..."
}操作
| Operation | Endpoint | Description |
|---|---|---|
| 作成 | POST /api/accounts/:account_id/payments |
支払いを記録 |
| 一覧 | GET /api/accounts/:account_id/payments |
支払い履歴 |
| 取得 | GET /api/payments/:payment_id |
支払い詳細 |
| 更新 | PATCH /api/payments/:payment_id |
メタデータ更新 |
支払いステータス
| Status | Description |
|---|---|
pending |
処理待ち |
succeeded |
支払い完了 |
failed |
支払い失敗 |
canceled |
支払いキャンセル |
refunded |
顧客へ返金済み |
支払い方法
| Type | Description |
|---|---|
card |
クレジット/デビットカード |
ach |
銀行振込（米国） |
wire |
電信送金 |
other |
その他 |
自動追跡
Stripe 支払いは Webhook で自動記録されます。手動記録は次の用途で利用します。
- 銀行振込
- 小切手
- 外部決済プロセッサ
- クレジット/調整仕訳
メタデータ
支払いに業務コンテキストを付与できます。
- 購入したプランまたはプロダクト
- 請求書参照
- カスタム追跡 ID
関連
- Subscriptions - サブスクリプション管理
- Payment - 支払いリソース
- Accounts - アカウントコンテキスト