Setup

決済(Stripe)

あなた自身のStripeアカウント(BYOモデル)を使って、見積書に決済リンクを生成します。

決済連携は、あなた自身のStripeアカウント(BYOモデル: 自分のアカウントを持ち込む)を使用します。支払いは直接あなたのStripeアカウントに入り、当社側でのコスト・マージン・仲介は一切発生しません。当社が行うのは、フィールドとリンク生成ボタンを配線することだけです。

この連携は不活性な状態から始まります。キーを貼り付けて有効化するまでは何も起こりません。キーはCRM内で暗号化して保存され、二度と表示されません。

前提条件

有効なStripeアカウント(実際に課金するには、あなたの国で決済が有効になっている必要があります)。
StripeダッシュボードへのAPIキー閲覧権限(Developers→API keys)およびwebhook作成権限(Developers→Webhooks)。
Sellioにおいて、設定→連携でキーを保存し連携を有効化できる管理者権限。

Secret key: StripeダッシュボードのDevelopers→API keysにあります(本番はsk_live_、テストはsk_test_で始まります)。
Webhook signing secret(最初は任意): StripeでWebhookを作成した際に生成されます(whsec_で始まります)。これにより、支払いが自動的に確定されるようになります。

設定→連携を開き、「決済(Stripe)」カードを見つけます。
Stripeのsecret keyを貼り付け、「キーを保存」をクリックします。
表示される「Stripe webhook URL」をコピーし、Stripeダッシュボード(Developers→Webhooks)で、checkout.session.completedとpayment_intent.succeededのイベントを指定してそのURL宛のエンドポイントを作成します。
CRMに戻り、webhook signing secret(whsec_...)をsecret keyと一緒に貼り付け、再度保存します。
「有効化」をクリックします。

💡 Stripeが未設定の状態でリンクを生成しようとすると、CRMは明確に警告し、課金は一切発生しません。キーが設定されるまで、この機能は不活性のままです。見積書に紐付いた支払いが確定すると、見積書は自動的に承諾済みとしてマークされます。

webhook URLは秘密として扱い、キーを変更する際は必ず両方のキーを一緒に貼り付けてください(セキュリティ上、CRMは保存済みのキーを再表示しません)。

実際に課金しないよう、TESTキー(テストモードのsk_test_.../whsec_)を使用してください。
見積書で「決済リンク」を生成して開くと、見積書の合計金額のStripeチェックアウトが表示されるはずです。
Stripeのテストカード(例: 4242 4242 4242 4242)で支払います。見積書が「支払い済み」になり承諾済みとしてマークされることを確認してください。これはwebhookが届き署名が検証された証拠です。
Stripeダッシュボード(Developers→Webhooks→対象エンドポイント)で、配信済みイベントの履歴と200ステータスを確認します。

リンク生成時のエラー/Stripeで401: secret keyが間違っているか、モードが違います(本番なのにテストキーを貼り付けた、またはその逆)。正しいsk_を貼り直してください。
顧客は支払ったのに見積書が「支払い済み」にならない: webhookが確定処理を行っていません。Stripeで、「Stripe webhook URL」を指すエンドポイントがcheckout.session.completedとpayment_intent.succeededのイベントで作成されているか確認してください。
webhookでInvalid signature: CRM内のwebhook signing secret(whsec_...)が、Stripeのエンドポイントのものと一致していません。エンドポイントのシークレットをコピーし、secret keyと一緒に貼り付けてください(両方を一緒に保存)。
webhook URLで404: 連携が有効化されていないか、URLのトークンが変更されました。再有効化し、URLをStripeに再度コピーしてください。
リンク生成時に何も起こらない: キーがないため連携が不活性です。先にsecret keyを貼り付けて有効化してください。