ComposioHQ/Braintree-Automation

Braintree自動化

Stripe互換ツールを使用して、顧客管理、サブスクリプション、支払い方法、残高トランザクション、顧客検索などを含む決済処理業務を自動化します。Composioプラットフォームは、Braintreeの決済ワークフローをStripeツールキット経由でルーティングし、統合された支払い管理を実現します。

ツールキットドキュメント: composio.dev/toolkits/braintree

---

セットアップ

このスキルを使用するには、https://rube.app/mcp に接続された Rube MCPサーバー が必要です。

ツールを実行する前に、stripe ツールキットに対してアクティブな接続が存在することを確認してください。接続がアクティブでない場合は、RUBE_MANAGE_CONNECTIONS を介して接続を開始してください。

---

コアワークフロー

1. 顧客の作成と管理

新しい顧客を作成し、既存の顧客詳細を取得します。

ツール:

• STRIPE_CREATE_CUSTOMER -- 新しい顧客を作成する
• STRIPE_GET_CUSTOMERS_CUSTOMER -- IDで顧客を取得する
• STRIPE_POST_CUSTOMERS_CUSTOMER -- 既存の顧客を更新する
• STRIPE_LIST_CUSTOMERS -- ページネーション付きで顧客を一覧表示する
• STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS -- メール、名前、メタデータで顧客を検索する

STRIPE_CREATE_CUSTOMER の主要パラメータ:

• email -- 顧客のプライマリメールアドレス
• name -- 氏名または事業者名
• phone -- 国番号付きの電話番号
• description -- 内部参照用メモ
• address -- line1、city、state、postal_code、country を含む請求先住所オブジェクト

STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS の主要パラメータ:

• query (必須) -- Stripe検索クエリ言語。field:value 構文を使用する必要があります:
  • email:'[email protected]' -- 完全一致（大文字小文字を区別しない）
  • name~'John' -- 部分一致（最低3文字）
  • metadata['key']:'value' -- メタデータ検索
  • created>1609459200 -- タイムスタンプ比較
  • AND または OR で結合（最大10節、混在不可）
• limit -- ページあたりの結果数（1～100、デフォルト10）

例:

ツール: STRIPE_CREATE_CUSTOMER
引数:
  email: "[email protected]"
  name: "Jane Doe"
  description: "エンタープライズプランの顧客"
  address: {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US"
  }

---

2. サブスクリプションの管理

サブスクリプションを作成し、顧客のサブスクリプション詳細を表示します。

ツール:

• STRIPE_CREATE_SUBSCRIPTION -- 既存の顧客向けに新しいサブスクリプションを作成する
• STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS -- 顧客の全サブスクリプションを一覧表示する
• STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID -- 特定のサブスクリプションを取得する

STRIPE_CREATE_SUBSCRIPTION の主要パラメータ:

• customer (必須) -- 顧客ID（例: "cus_xxxxxxxxxxxxxx"）
• items (必須) -- サブスクリプションアイテムの配列。各アイテム:
  • price -- 価格ID（例: "price_xxxxxxxxxxxxxx"）（price_data の代わりに使用）
  • price_data -- currency、product、unit_amount、recurring を含むインライン価格定義
  • quantity -- アイテム数量
• default_payment_method -- 支払い方法ID（トライアル期間または請求書請求の場合は不要）
• trial_period_days -- トライアル日数（トライアル中は支払い不要）
• collection_method -- "charge_automatically"（デフォルト）または "send_invoice"
• cancel_at_period_end -- 請求期間終了時にキャンセル（ブール値）

STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS の主要パラメータ:

• customer (必須) -- 顧客ID
• status -- フィルター: "active"、"all"、"canceled"、"trialing"、"past_due" など
• limit -- ページあたりの結果数（1～100、デフォルト10）

例:

ツール: STRIPE_CREATE_SUBSCRIPTION
引数:
  customer: "cus_abc123"
  items: [{"price": "price_xyz789", "quantity": 1}]
  trial_period_days: 14

---

3. 支払い方法の管理

支払い方法を一覧表示し、顧客に割り当てます。

ツール:

• STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS -- 顧客の支払い方法を一覧表示する
• STRIPE_ATTACH_PAYMENT_METHOD -- 支払い方法を顧客に割り当てる

STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS の主要パラメータ:

• customer (必須) -- 顧客ID
• type -- タイプでフィルター: "card"、"sepa_debit"、"us_bank_account" など
• limit -- ページあたりの結果数（1～100、デフォルト10）

例:

ツール: STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS
引数:
  customer: "cus_abc123"
  type: "card"
  limit: 10

---

4. 残高トランザクションの表示

顧客の残高変更履歴を取得します。

ツール: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS

主要パラメータ:

• customer (必須) -- 顧客ID
• created -- 作成日でフィルター（比較演算子使用）: {"gte": 1609459200} または {"gt": 1609459200, "lt": 1640995200}
• invoice -- 関連する請求書IDでフィルター
• limit -- ページあたりの結果数（1～100）
• starting_after / ending_before -- ページネーションカーソル

例:

ツール: STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS
引数:
  customer: "cus_abc123"
  limit: 25
  created: {"gte": 1704067200}

---

既知の落とし穴

落とし穴	詳細
検索クエリ構文	STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS ではフィールドプレフィックス付きクエリ（例: email:'x'）が必要です。プレフィックスなしの裸の文字列は無効で、エラーになります。
サブスクリプションの支払い方法	trial_period_days または collection_method='send_invoice' を使用する場合、default_payment_method は不要です。それ以外の場合、サブスクリプションが有効化されない可能性があります。
支払い方法の割り当て	PaymentMethod は顧客に割り当てる前に未割り当て状態である必要があります。すでに割り当てられている方法はエラーになります。
ページネーションカーソル	starting_after/ending_before にはページ番号ではなくオブジェクトIDを使用します。各レスポンスから最初または最後のオブジェクトIDを抽出してください。
残高はセント単位	すべての金額は最小通貨単位（例: USDの場合はセント）で表されます。1000 = $10.00 です。
サブスクリプションステータスのデフォルト	GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS はデフォルトでキャンセルされたサブスクリプションを除外します。含めるには status: "all" を渡してください。

---

クイックリファレンス

ツールスラッグ	説明
STRIPE_CREATE_CUSTOMER	新しい顧客を作成する
STRIPE_GET_CUSTOMERS_CUSTOMER	IDで顧客を取得する
STRIPE_POST_CUSTOMERS_CUSTOMER	既存の顧客を更新する
STRIPE_LIST_CUSTOMERS	ページネーション付きで顧客を一覧表示する
STRIPE_GET_V1_CUSTOMERS_SEARCH_CUSTOMERS	属性で顧客を検索する
STRIPE_CREATE_SUBSCRIPTION	顧客向けにサブスクリプションを作成する
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS	顧客のサブスクリプションを一覧表示する
STRIPE_GET_CUSTOMERS_CUSTOMER_SUBS_SUB_EXPOSED_ID	特定のサブスクリプションを取得する
STRIPE_GET_CUSTOMERS_CUSTOMER_PAYMENT_METHODS	顧客の支払い方法を一覧表示する
STRIPE_ATTACH_PAYMENT_METHOD	支払い方法を顧客に割り当てる
STRIPE_GET_CUSTOMERS_CUSTOMER_BALANCE_TRANSACTIONS	顧客の残高トランザクションを一覧表示する

---

Powered by Composio