stripe

Stripe 請求業務の運用

Stripe で請求および決済の操作を実行します。対象は、顧客、商品、請求書、決済リンク、サブスクリプション、返金、異議申し立てです。

MCP は任意です。 このスキルは、MCP（自動）、Stripe CLI、または Dashboard で動作します。実行方法については、BACKENDS.md を参照してください。

3 つの重要ルール

1. 書き込み前に読み取る — 顧客／商品／価格を作成する前に、重複を避けるため、すでに存在するか確認します
2. 金銭に関わる操作には確認が必要です — 返金、サブスクリプションの変更、異議申し立ての更新は、実行前に確認を得る必要があります
3. 迷ったら検索する — オブジェクト ID やパラメーターが不明な場合は、推測せず、まず検索します

セキュリティルール

操作の種類	ルール
読み取り（一覧、取得、検索）	そのまま実行
作成（顧客、商品、価格、請求書）	まず重複がないか確認
金銭に関わる操作（返金、サブスクリプションのキャンセル／更新、異議申し立て）	詳細を表示 → 確認を待つ → 実行
モード	デフォルトはテストモードです。ライブモードでは、「live mode」の明示と二重確認が必要です

危険な操作（確認が必要）

以下の操作を実行する前に：

1. 表示 — オブジェクト ID と主要なフィールドを表示します
2. 影響を説明 — 金額、タイミング、結果を説明します
3. 確認を待つ — 「confirm」／「yes」／「proceed」の明示的な応答を待ちます
4. 実行して結果を返す — 結果、オブジェクト ID、ステータスを返します

操作	リスク
create_refund	アカウントから資金が出ていきます
cancel_subscription	収益が失われます
update_subscription	契約が変更されます
update_dispute	法的な影響があります

確認プロンプトの例：

About to execute refund:
- PaymentIntent: pi_xxx
- Amount: $50.00 (full amount)
- Reason: requested_by_customer

Reply "confirm" to proceed, or "cancel" to abort.

一般的なワークフロー

顧客の作成

1. Search/list to check if customer exists (by email)
2. If not exists, create_customer(name, email, metadata)
3. Return cus_xxx + key info

商品と価格の作成

1. List products to check if already exists
2. create_product(name, description)
3. create_price(product=prod_xxx, unit_amount=cents, currency)
4. Return prod_xxx + price_xxx

請求書の作成と送信

1. Confirm customer ID (list_customers if unknown)
2. create_invoice(customer=cus_xxx, collection_method, days_until_due)
3. create_invoice_item(invoice=inv_xxx, price=price_xxx, quantity)
4. finalize_invoice(invoice=inv_xxx)
5. Return inv_xxx + hosted_invoice_url

決済リンクの作成

1. Confirm price ID (list_prices if unknown)
2. create_payment_link(line_items=[{price, quantity}])
3. Return payment link URL

返金（危険）

1. list_payment_intents to find target payment
2. Display pi_xxx + amount + customer info
3. Request user confirmation
4. create_refund(payment_intent=pi_xxx, amount?, reason)
5. Return re_xxx + status

サブスクリプションのキャンセル（危険）

1. list_subscriptions(customer=cus_xxx) to find target
2. Display sub_xxx + status + next billing date
3. Ask: cancel immediately or at period end?
4. After confirmation, cancel_subscription(subscription=sub_xxx)
5. Return cancellation result

デフォルト設定

• 通貨：ユーザー指定の通貨を使用します。指定がない場合は、既存のオブジェクトの通貨を使用し、それもない場合は確認します
• 金額：小数を受け付け、最小通貨単位に自動変換します（例：$19.99 → 1999）
• 出力：オブジェクトの種類 + ID + 主要なフィールド + 次のステップ

制限事項

以下の操作は標準ツールでは利用できません：

• ❌ PaymentIntent の作成／直接の課金
• ❌ サブスクリプションの作成（一覧／更新／キャンセルのみ）
• ❌ プロモーションコードの作成（クーポンのみ）
• ❌ オブジェクトの削除

これらの操作には、Dashboard または API を直接使用してください。

ファイルベースのパイプライン

複数ステップのワークフローに統合する場合：

runs/<workflow>/active/<run_id>/
├── proposal.md                # Requirements / objective
├── context.json               # Known IDs (customer, invoice, etc.)
├── tasks.md                   # Checklist + approval gate
├── evidence/stripe-actions.md # Operations to execute (money ops written here first)
├── evidence/receipt.md        # Results + object IDs
└── logs/events.jsonl          # Optional tool call summary (no sensitive data)

エラー処理

状況	対応
オブジェクトが存在しない	正しい ID を見つけるために検索します
パラメーターエラー	正しい形式をドキュメントで確認します
権限が不足している	API キーのスコープを確認します
ネットワークエラー	再試行するか、接続を確認します

関連ファイル

• BACKENDS.md — 実行方法（MCP／CLI／Dashboard）
• SETUP.md — MCP の設定（任意）
• tools.md — ツールのパラメーターの詳細