Stripeの支払いデータ、Webhookなしで数秒のうちにSupabaseへ

Stripeのデータを外のデータベースへ送るStripe Data Pipelineの同期先に、Supabaseが加わった。StripeのダッシュボードでSupabaseのプロジェクトを選ぶだけで、支払い、顧客、サブスクリプションといった表が過去の分も含めて入り、その後の変化は数秒で反映される。Webhookを書く必要はなく、データベースのパスワードもStripeに渡さない。今は公開プレビューで、始めるのは無料だ。アプリに課金を入れたばかりの小さなチームほど、手間が減る話だ。

Webhookなしで支払いが届く

これまでStripeの支払いを自分のデータベースに残すには、Webhookを受ける口を作るのが定番だった。支払いが成功した、サブスクリプションが更新された、といった通知を受け取り、自分で表に書き込む。通知の取りこぼしや二重の受信、順番の入れ替わりにも備える必要があり、Claude CodeやCodexに任せても、テストまで含めると意外に手間がかかる部分だった。

新しい連携では、この部分をStripeが受け持つ。Stripeのダッシュボードで同期先にSupabaseのプロジェクトを選ぶと、まず過去のデータがまとめて入る。その後の変化は数秒で反映される。数秒という速さについて、StripeのブログはSupabaseに限らずPostgresへの同期全般として書いている。Stripeは同期した記録を元のデータと定期的に照らし合わせ、食い違いがあれば直すとしている（会社の申告）。

設定はStripeのダッシュボードで済む。Supabaseのブログによると、ReportingのData managementからData Pipelineを開き、同期先にPostgresとSupabaseを選ぶ。Supabaseにサインインしてプロジェクトを選べば、あとはStripeが引き受ける。入る表は、請求、返金、不審請求の申し立て、顧客、サブスクリプション、請求書などで、名前の頭にstripe_sdpが付いた専用のスキーマに置かれる。

パスワードを渡さない接続の仕組み

接続のやり方も変わった。Supabaseの説明では、Stripeにデータベースのパスワードを預けるのではなく、利用者がOAuthで許可した期限付きの認証を使う。Stripeはこの認証を毎回取り直して接続し、その認証で書き込めるのはStripe用のスキーマだけだ。アプリ本体の表には手が届かない。Supabase側は接続の前に、そのスキーマにしか触れない専用のロールを作り、短い期限のトークンでPostgresに直接つなぐ機能を有効にし、通信の暗号化も必ず使う設定にする。

パスワードを外のサービスに渡さずに済むのは、小さなチームにとって安心材料になる。Stripeが触れるのはStripe用のスキーマだけで、ほかの表と分けて扱える。

SQLで売り上げを引けるようになる

支払いのデータがSupabaseの中に入ると、アプリの表と同じSQLで扱える。どのユーザーが有料プランか、今月の解約は何件かといった問いに、StripeのAPIを何度も呼ばずに答えられる。管理画面や社内の集計を作る時も、エージェントに「この表を読んで」と頼むだけで済む場面が増えそうだ（編集部の読み）。

ただし、同期された表はStripeの形のままだ。自分のユーザー表とどうつなぐかは、これまでどおり自分で決める必要がある。Stripeの顧客IDを自分のユーザー表に持たせておけば、二つの表を結んで、有料ユーザーだけに機能を開くといった判定もSQLで書ける。エージェントに頼むなら、まず同期された表の一覧と列を読ませ、それから問いを渡すと間違いが減るはずだ（編集部の読み）。

使う前に知っておくこと

連携は公開プレビューの段階で、始めるのは無料とされている。プレビューが終わった後の料金や、同期できる量の上限は、両社の公式ブログには書かれておらず、未確認だ。課金の仕組みそのものに関わる部分なので、本番のアプリで頼り切る前に、両社の続報を待つほうがよい。

同期先はSupabaseだけではない。Stripeのブログは、AWSやNeon、Databricks Lakebaseなどが動かすPostgresにも送れるとし、Snowflake、Google BigQuery、Amazon Redshiftなどへのリアルタイム同期も近く対応するという。

すでにWebhookで支払いを記録しているアプリは、すぐに置き換えず、しばらく両方を並べて中身を比べるのが無難だ（編集部の読み）。つないだ直後は、同期された表の件数をStripeのダッシュボードの数字と見比べておくと安心だ（編集部の読み）。

編集部の見方

Claude CodeやCodexでアプリに課金を入れる時、いちばん神経を使うのはWebhookの受け口だった。取りこぼしや二重の受信をテストで潰す作業が、ダッシュボードの設定に置き換わる意味は大きい。パスワードを渡さず、書ける範囲もStripe用のスキーマに限られる点もよい。ただしまだ公開プレビューで、プレビュー後の料金は分からない。まずは試作のアプリでつないで、表の形を見てみるのがよさそうだ。