Stripe決済データをData Platformコネクタで抽出する#

#目的

Stripeコネクタは、Stripeアカウントからデータを抽出します: 顧客、請求、支払い意図、サブスクリプション、請求書、製品、残高取引、イベントなど。

76のエンドポイントリソースが12のドメイングループに分類されています + 4つのフィルタリングされたエンドポイント + 3つのスタンドアロンエンドポイント + カスタムエンドポイントは、任意のStripeリソースパスに対して使用できます。

コネクタはStripe APIからの生のJSONを返します。プラットフォームは自動的に入れ子になったオブジェクトを列にフラット化し、結果をレイクハウスに保存します。手動でスキーマを定義する必要はありません。

#1. Stripe APIキーを取得する

#アカウントを作成する

1. dashboard.stripe.com/registerに無料でサインアップ（クレジットカードは不要）
2. すべてのアカウントはサンドボックス（テストモード）から開始され、フルAPIアクセスが可能で、実際の請求は発生しません

#シークレットキーを取得する

1. Stripeダッシュボードにログイン
2. テストモードのトグルがONになっていることを確認（ダッシュボードの右上）
3. Developers > API Keysに移動
4. Secret keyをコピー: テストモードではsk_test_で始まり、ライブモードではsk_live_で始まります

#2. 資格情報を設定する

シークレットキーをStripe API Keyフィールドに貼り付けます:

sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

コネクタはベアラートークン認証を使用します。スコープ設定は必要ありません。シークレットキーにはフルAPIアクセスが付与されています。

#3. 利用可能なエンドポイント

コネクタは20のエンドポイントに分類されています。ほとんどのエンドポイントは「リソースタイプ」ドロップダウンで関連リソースをグループ化しています。

#ドメイングループ（12）

#フィルタリングされたエンドポイント（親IDが必要）

#スタンドアロンエンドポイント

#カスタムエンドポイント

例のリソースパス値: issuing/settlements, treasury/statements, capital/financing_offers. /v1/プレフィックスはオプションです。コネクタは欠落している場合に追加します。

#4. Data PlatformでStripeソースを追加する

1. Data PlatformのConnectorsで、Stripeをソースストアから見つけ、Selectをクリックします。
2. ステップ1からStripe API Keyフィールドにシークレットキーを貼り付けます。
3. Connectをクリックして資格情報を確認します。コネクタはGET /v1/balanceをヘルスチェックとして呼び出します。
4. Add an Endpointをクリックし、ドロップダウンからエンドポイントを選択（例: core, billing, custom）し、適用可能な場合はResource Type（例: customers）と必要なパラメータ（例: payment_methodsのCustomer ID、customのResource Path）を選択します。
5. このソースで取り込みたい追加のエンドポイントごとにステップ4を繰り返します。各エンドポイントはレイクハウス内の別々のテーブルになります。
6. ソースに名前を付け、Createをクリックします。

#5. クイック例: 顧客を抽出する

1. エンドポイント: core
2. リソースタイプ: customers
3. 最大アイテム数: 100（または空にしてすべて抽出）

コネクタはStripeから生のJSONを返します。プラットフォームは自動的に入れ子になったオブジェクト（例: address.countryは列address_countryになる）をフラット化し、結果をレイクハウスに保存します。

#6. ベストプラクティス

#テスト時はmax_itemsを使用する

新しいテーブルを設定する際は、max_itemsを10または100に設定して、出力を迅速に確認します。Stripeはページネーションが豊富（1ページあたり100件、合計は無制限）であるため、データが多いアカウントでは大規模な抽出に時間がかかる場合があります。

#eventsを抽出して完全な監査トレールを取得する

eventsエンドポイントはcoreグループに含まれており、アカウント内のすべての状態変更を含みます: 顧客が作成された、サブスクリプションが更新された、請求が返金されたなど。これは増分監査ログの最適なソースです。

#パイプラインをリファレンステーブルとして抽出する

products, prices, plans, couponsエンドポイントは、静的なリファレンスデータを提供します。これらを別々に抽出し、charges, subscriptions, invoicesと結合して分析に使用します。

#balance_transactionsを財務報告に使用する

balance_transactionsには、Stripeの残高、請求、返金、手数料、支払い、調整など、すべての動きが1つの統合ストリームで含まれています。これは通常、調整の最適な開始点です。

#シークレットキー vs 制限付きキー

読み取り専用の分析には、制限付きAPIキー（プレフィックスrk_test_ / rk_live_）を作成し、必要なリソースに対してのみRead権限を付与できます。これはフルシークレットキーより安全です。Developers > API Keys > Restricted keys > Create restricted keyに移動してください。

#7. 制限事項

• 静的型接頭辞: すべてのStripeオブジェクトには、型付きID接頭辞（cus_, ch_, sub_, pi_, in_など）があります。これらを保持してテーブル間で結合してください。
• タイムスタンプはUnix秒で、ISO 8601ではありません。ダウンストリーム処理でキャストしてください。
• 一部のエンドポイントは特定のStripe製品が必要です（Issuing、Treasury、Terminal、Identity、Climate）。アカウントで製品が有効化されていない場合、Stripeは400エラーを返し、抽出が失敗します。コネクタはこのエラーをスキップまたは再試行しません。
• Stripe製品の有効化は、Stripeダッシュボードから管理されます。このコネクタの外部です。
• テストモード vs ライブモード: シークレットキーがどのデータを抽出するかを決定します。sk_test_キーはサンドボックスデータのみを表示します；sk_live_キーは生産データのみを表示します。完全に分離されています。
• レポートAPIのクセ: /v1/reporting/report_typesはlimitパラメータを拒否します。コネクタは自動的にこれを省いて再試行します。ご自身で行う必要はありません。

#さらに詳しく

当社のソリューションを実装するためのトレーニングや技術サポートが必要な場合は、営業担当者にお問い合わせください、またはこのリンクをクリックして見積もりを依頼し、当社のプロフェッショナルサービスの専門家にプロジェクトのカスタム分析を依頼してください。

質問をする、フィードバックを送信する、またはData Platformを構築するチームと直接交流するには、専用のDiscordチャネルにアクセスしてください。

OVHcloudサービスについてサポートが必要な場合は、ヘルプセンターでリクエストを作成してください。

ユーザーコミュニティに参加してください。