Stripe コネクタ

Stripe アカウントを Tajo に接続すると、支払いデータ（顧客、支払い、サブスクリプション、請求書）を読み取り専用で同期し、連絡先の名寄せ、セグメンテーション、売上にもとづく自動化（Brevo などのエンゲージメントプロバイダー経由）に活用できます。

概要

項目	値
認証	Stripe のシークレットキー (`sk_live_...` / `sk_test_...`) または制限付きキー
アクセス	読み取り専用。Tajo が Stripe アカウントに書き込むことはありません
ベース API	`https://api.stripe.com/v1`
同期の方向	Stripe → Tajo
リアルタイム Webhook	未対応。現時点の同期はポーリング方式です

Stripe のダッシュボードで Developers → API keys を開きます。
制限付きキーを作成します。Customers、Charges、Subscriptions、Invoices への読み取り権限があれば十分です。Tajo は読み取りしか行わないため、読み取りだけを許可する制限付きキーの利用を強くおすすめします。
そのキーを Tajo の Stripe 接続に貼り付けます。

同期が始まる前に、読み取り専用のリクエストで接続が検証されます。キーのローテーションや失効は、いつでも Stripe 側で行えます。

データ	Tajo での使われ方
顧客	連絡先（メールアドレス、氏名、電話番号、住所）に名寄せされ、identity とセグメンテーションに使われます。顧客レコードが存在することから同意が推測されることはありません。
支払い	購買にもとづくライフサイクル自動化と LTV セグメンテーションのための売上イベント
サブスクリプション	ライフサイクルのステータス (active、past_due、canceled など)。督促、ウィンバック、リテンションのフローに使います
請求書	請求まわりのメッセージングに使う支払いステータス

ページネーションには Stripe のカーソル方式 (starting_after) を使うため、大規模なアカウントでも中断と再開をしながら完全に同期できます。

計画を立てやすいように、率直に記載します。

リアルタイム Webhook は未対応です。 変更は支払いが成功した瞬間ではなく、同期のスケジュールに従って届きます。Webhook の取り込みはロードマップに入っています。
読み取り専用です。 Tajo が Stripe 上で顧客、支払い、サブスクリプションを作成したり変更したりすることはありません。
Stripe App はありません。 現時点で Stripe App Marketplace に Tajo のアプリはなく、接続は Stripe のダッシュボードではなく Tajo 側で設定します。

症状	原因と対処
Stripe から 401 が返る	キーが失効またはローテーションされています。現在のキーを接続に貼り付けてください
顧客は同期されるが支払いが同期されない	制限付きキーに Charges の読み取り権限がありません
連絡先にメールアドレスがない	メールアドレスのない Stripe の顧客は匿名の売上レコードとして同期されます。後からメールアドレスが追加されれば連絡先グラフに加わります