読み取り専用のキーで Stripe を接続する

01Stripe を接続する

1. 1

   Stripe で制限付きキーを作成する

   Tally が行うのは決済の読み取りだけで、お金を動かす必要はありません。制限付きキーは許可したことしかできず、Stripe でいつでも無効にできます。Stripe で Developers, API keys を開き、「Create restricted key」を選んで、次のように設定します。

   権限	アクセス	用途
   PaymentIntents	読み取り	すべての支払い：金額、通貨、顧客、メタデータ。
   Invoices	読み取り	支払いがサブスクリプションの初回か、更新か、プラン変更か、そして含まれる税額。
   Checkout Sessions	読み取り	メタデータまたは client_reference_id で渡す訪問者 ID と、どの Payment Link で売れたか。
   Customers	読み取り	顧客のメタデータと、tally('identify') と照合するためのメールアドレス（すぐにハッシュ化し、保存はしません）。
   Charges	読み取り	返金。
   Disputes	読み取り	チャージバックと、異議申し立てに勝った後に戻された資金。
   Webhook Endpoints	書き込み	Tally があなたのアカウントに専用のエンドポイントを作成するので、支払いは数秒で届きます。

   それ以外はすべて「None」のままにします。

2. 2

   制限付きキーを貼り付ける

   サイトの Integrations ページ（またはサイト追加時の Payments の手順）で Stripe を開き、次を入力します。

   • Restricted key：rk_live_ または rk_test_ で始まります。Tally は暗号化して保管し、二度と表示しません。

   続いて Connect Stripe を押します。

3. 3

   Tally が確認し、過去 1 年分を取り込む

   キーに足りない権限があればその名前を示し、新しい決済を発生と同時に受け取れるようアカウントに専用の Webhook を追加して、過去 365 日分を取り込みます。

02キーとアカウント

• 受け付けるのは制限付きキーだけです。シークレットキー（sk_…）は、使われる前に拒否されます。
• テストモードで作成したキー（rk_test_…）ではテスト決済が見えるので、まず試すにはこれを使います。
• Stripe アカウントはそれぞれ別の接続になります。販売に使っているアカウントをそれぞれ接続してください。
• キーは Stripe でいつでも無効にでき、Integrations ページで切断することもできます。取り込み済みの決済はレシートとともに残ります。

03新しい決済を訪問に紐づける

取り込みで過去 1 年分がそろいます。これからの決済では、チェックアウトが訪問者 ID を渡します。必要なページは、支払いの受け取り方によって異なります。

• Stripe Checkoutサーバーで Checkout Session を作成している。
• Stripe Payment Linksbuy.stripe.com に移動する購入ボタン。
• その他の Stripe の支払いPayment Element、API で作成するサブスクリプション、請求書。

04うまくいったか確認する