- API 認証情報
- APIキー
- Webhook シークレット
Stripe を設定すると、旅行者は Stripe の決済ページでカードで支払い、支払い済みの予約に戻ります。上に記載されているいずれかの国の銀行口座が必要です。
Stripe アカウントを作成する
- 1
Stripe に登録する
dashboard.stripe.com/register でアカウントを作成します。ビジネスの国は慎重に選んでください。アカウントが本番稼働すると、Stripe では変更できません。
- 2
ビジネスの確認を受ける
dashboard.stripe.com/account/onboarding で申請を完了します。ビジネス、その代表者や関係者、入金先の銀行口座を入力します。Stripe の確認が済むと、本番の支払いを受け付けられるようになります。
Stripe のシークレットキーをコピーする
- 1
API キーを開く
dashboard.stripe.com/apikeys を開き、サンドボックスから本番環境に切り替えます。
- 2
シークレットキーをコピーする
Standard keys で Reveal live key をクリックし、Secret key をコピーします。sk_live_ で始まるキーです。他人に知られないようにしてください。このキーがあれば、誰でもあなたの名前で支払いを受けたり返金したりできます。
Stripe に TourTask の Webhook を追加する
Webhook は、入金が数日後に確定した場合や、旅行者が戻ってこなかった場合でも、各支払いを TourTask に知らせます。
Stripe 用の TourTask の Webhook アドレス
https://api.tourtask.com/v1/payments/stripe/notifications/booking- 1
イベントの送信先を作成する
本番環境で dashboard.stripe.com/webhooks を開き、Create an event destination をクリックします。
- 2
Your account と Snapshot を選ぶ
Your account と、ペイロード形式の Snapshot を選びます。Stripe が推奨する Thin イベントは TourTask では読み取れません。API バージョンはそのままにします。
- 3
2 つのイベントを選ぶ
checkout.session.completed と checkout.session.async_payment_succeeded にチェックを入れ、ほかは選びません。
- 4
Webhook エンドポイントを選ぶ
Continue をクリックし、送信先のタイプとして Webhook endpoint を選びます。
- 5
TourTask のアドレスを入力する
Continue をクリックし、上の TourTask のアドレスを Endpoint URL に貼り付けて、送信先を作成します。
- 6
署名シークレットをコピーする
送信先のページで Reveal secret をクリックし、署名シークレットをコピーします。whsec_ で始まる値です。
TourTask に Stripe を追加する
- 1
Stripe のカードを開く
構成 → 支払いオプション を開き、オンライン決済 → 決済ゲートウェイ で Stripe のカードをクリックします。見つからない場合は、カードの下の すべてのゲートウェイを表示 を選びます。
- 2
国と通貨を選ぶ
国 で Stripe アカウントとその銀行口座がある国を、通貨 で旅行者が支払う通貨を選び、追加 をクリックします。あとでどちらかを変更するには、取り除く で Stripe を削除してから、もう一度追加します。
- 3
API 認証情報を入力する
認証 に、それぞれの入力欄があります。
APIキー
Webhook シークレット各欄は、欄の外をクリックすると保存されます。
- 4
Stripe を有効化する
すべての欄を入力したら、有効化 をクリックします。カードが アクティブ になり、旅行者は予約ページで Stripe で支払えるようになります。支払いはすべてご自身の Stripe アカウントへ直接入金され、TourTask があなたの資金を預かることはありません。
追加料金の設定や支払い方法の並べ替えについては、オンライン決済をご覧ください。
Stripe が動作するか確認する
TourTask には Stripe のテストモードがなく、Stripe の規約では実際のカードによるテスト決済が禁止されています。
- 1
Stripe の決済ページを開く
ご自身の予約ページでツアーを予約し、Stripe を選びます。Stripe の決済ページが開いたら、支払わずに閉じます。
- 2
テスト予約をキャンセルする
TourTask でその予約を開き、予約をキャンセルするをクリックします。
- 3
最初の支払いを確認する
旅行者が Stripe で支払うと、予約は支払い済みと表示され、支払いが Stripe ダッシュボードに表示されます。
- 4
Webhook を確認する
Stripe で送信先の Event deliveries タブを開くと、checkout.session.completed が Delivered と表示されています。失敗している場合は、エンドポイント URL、Snapshot 形式、Webhook シークレットを確認してください。
よくある質問
Stripe ダッシュボードの支払い方法の設定でオンにしている方法です。口座引き落としなど後から確定する方法では、入金されて初めて予約が支払い済みになります。
いいえ。TourTask が予約の合計金額を、ゲートウェイに選んだ通貨に換算します。
いいえ。支払いはご自身の Stripe アカウントに入り、Stripe からあなたの銀行口座に入金されます。