支払い

支払い

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 - アカウントコンテキスト