Stripe

• AIエージェントに、Stripeのシークレットキーを環境に直接埋め込むことなく、Stripeの顧客、商品、価格を作成・管理させたい場合。
• エージェントのワークフロー内から、サブスクリプションの作成、プランの更新、キャンセルなど、サブスクリプションのライフサイクル操作を自動化する必要がある場合。
• PythonまたはJavaScriptを使用して、支払い履歴の照会、請求書PDFの取得、または返金をプログラムで行いたい場合。
• 複数のStripeアカウントを管理しており、Maton-Connectionヘッダーを使用して特定の接続にリクエストをルーティングする必要がある場合。

• Stripe以外のサードパーティサービスと統合する必要がある場合は、代わりにapi-gateway skillを使用してください。
• 直接的なStripe Webhookの処理やリアルタイムイベントストリーミングが必要な場合、このRESTプロキシはそれらを提供していません。
• 有効なMaton APIキーを持っていない、またはネットワークからgateway.maton.aiに接続できない場合。

認証はMATON_API_KEYを通じてすべて処理されます。MatonゲートウェイがStripeへのリクエストをapi.stripe.comにプロキシし、正しいStripe OAuthトークンを自動的に注入するため、Stripeの認証情報を自分で保存したりローテーションしたりする必要がありません。

顧客、商品、価格、サブスクリプション、請求書、チャージ、支払いインテント、支払い方法、クーポン、返金にわたるCRUD操作をサポートし、Stripeの請求・決済機能のコアをカバーします。

ctrl.maton.ai のMatonコントロールパネルから、複数のStripe OAuth接続を管理できます。APIコールを行う際は、Maton-Connection ヘッダーを使用して特定のStripeアカウントを指定するか、ゲートウェイのデフォルト設定により最も古いアクティブな接続が使用されます。

すべてのリストエンドポイントは、starting_after および ending_before クエリパラメータを使用した Stripe のネイティブなカーソルベースのページネーションをサポートしており、レスポンスの has_more フィールドにより大規模なデータセットの反復処理を簡素化します。

基本的なCRUD操作にとどまらず、専用のアクションエンドポイント（/finalize、/pay、/void）を使用して、下書き請求書の確定、支払い回収のトリガー、または請求書の無効化を行うことができます。ホスト型請求書のURLとPDFリンクはレスポンスに含まれて返されます。

顧客を作成し、支払い方法を紐付け、定期価格へのサブスクリプションを開始する — これらすべてをエージェントワークフローから実行できます。サブスクリプション API を使用して、プランのアップグレードやダウングレード、必要に応じたキャンセルを行いましょう。

残高トランザクションの照会、顧客または日付によるフィルタリングを適用した請求一覧の取得、そして支払いインテントのステータスの取得を通じて、財務サマリーの生成や支払い記録のプログラム的な照合を行います。

ユーザーがサインアップした際に自動的にStripeの顧客レコードを作成し、内部ユーザーIDなどのメタデータを付与するとともに、より広範なオンボーディング自動化の一環として顧客の詳細情報を検索・更新することができます。

プロモーションキャンペーン向けに割引率または割引額のクーポンを作成したり、既存のクーポンを一覧表示したり、期限切れのクーポンを削除したりできます — Stripe ダッシュボードを操作することなく、すべて API 経由で実行可能です。