Stripe Elements

Stripe Elements でカード決済を受け付ける方法

Stripe Elements で、予約ページ上でカード決済を受け付けます。

国

  • アイルランド
  • アメリカ合衆国
  • アラブ首長国連邦
  • イギリス
  • イタリア

通貨

  • AED
  • AFN
  • ALL
  • AMD
  • ANG
  • AOA
  • ARS
ドキュメントお問い合わせ
API 認証情報
  • APIキー
  • 公開可能なキー
  • Webhook シークレット

Stripe Elements は Stripe のカード入力欄を予約ページに表示するため、旅行者はページを離れずにカードで支払えます。本番の支払いを受け付けられる Stripe アカウントが必要です。開設方法は Stripe のガイドをご覧ください。

Stripe からキーをコピーする


  1. 1

    本番環境で API キーを開く

    dashboard.stripe.com/apikeys を開き、サンドボックスではなく本番環境になっていることを確認します。テスト用のキーでもエラーにはならず、存在しないお金で予約が支払い済みになってしまいます。

  2. 2

    公開可能なキーをコピーする

    Standard keys で Publishable key をコピーします。pk_live_ で始まるキーです。

  3. 3

    シークレットキーをコピーする

    Secret key をコピーします(隠れている場合は Reveal live key をクリック)。sk_live_ で始まるキーです。他人に知られないようにしてください。このキーがあれば、あなたの名前でカードに請求できます。

Stripe に Webhook を追加する


予約を支払い済みにするのは Webhook です

Webhook がないと、旅行者に請求されても予約は未確認のままになります。

Stripe Elements 用の TourTask の Webhook アドレス

https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking
  1. 1

    イベントの送信先を作成する

    本番環境のまま dashboard.stripe.com/webhooks を開き、Create an event destination をクリックします。

  2. 2

    Your account と Snapshot を選ぶ

    Your account と、ペイロード形式の Snapshot を選びます。Stripe が推奨する Thin イベントは TourTask では読み取れません。

  3. 3

    イベントを選ぶ

    payment_intent.succeeded を選び、ほかのイベントは選びません。

  4. 4

    Webhook エンドポイントを選ぶ

    Continue をクリックし、送信先のタイプとして Webhook endpoint を選びます。

  5. 5

    TourTask のアドレスを入力する

    Continue をクリックし、上の TourTask のアドレスを Endpoint URL に貼り付けて、Create destination をクリックします。

  6. 6

    署名シークレットをコピーする

    送信先のページで Reveal secret をクリックし、署名シークレットをコピーします。whsec_ で始まる値です。

ゲートウェイごとにエンドポイントを 1 つ

Stripe ゲートウェイ用のエンドポイントがすでにある場合も、新しいエンドポイントを追加してください。ゲートウェイごとに専用のものが必要です。

TourTask に Stripe Elements を追加する


  1. 1

    Stripe Elements のカードを開く

    構成 → 支払いオプション を開き、オンライン決済 → 決済ゲートウェイ で Stripe Elements のカードをクリックします。見つからない場合は、カードの下の すべてのゲートウェイを表示 を選びます。

  2. 2

    国と通貨を選ぶ

    国 で Stripe Elements アカウントとその銀行口座がある国を、通貨 で旅行者が支払う通貨を選び、追加 をクリックします。あとでどちらかを変更するには、取り除く で Stripe Elements を削除してから、もう一度追加します。

  3. 3

    API 認証情報を入力する

    認証 に、それぞれの入力欄があります。
    APIキー
    公開可能なキー
    Webhook シークレット

    各欄は、欄の外をクリックすると保存されます。

  4. 4

    Stripe Elements を有効化する

    すべての欄を入力したら、有効化 をクリックします。カードが アクティブ になり、旅行者は予約ページで Stripe Elements で支払えるようになります。支払いはすべてご自身の Stripe Elements アカウントへ直接入金され、TourTask があなたの資金を預かることはありません。

APIキー:sk_live_… で始まるシークレットキー
公開可能なキー:pk_live_… で始まるキー
Webhook シークレット:whsec_… で始まる署名シークレット

既定で開く(任意)

カードで既定で開くをクリックすると、予約ページの上部にカード入力フォームが開いた状態で表示されます。

Stripe Elements が動作するか確認する


TourTask には Stripe Elements のテストモードがなく、Stripe の規約では実際のカードによるテスト決済が禁止されています。

  1. 1

    カード入力フォームを開く

    ご自身の予約ページでツアーを予約し、カード払いを選ぶと、Stripe のカード入力フォームが表示されます。支払わずにページを閉じます。

  2. 2

    テスト予約をキャンセルする

    TourTask でその予約を開き、予約をキャンセルするをクリックします。

  3. 3

    最初の支払いを確認する

    旅行者がカードで支払うと、予約は支払い済みと表示され、支払いが Stripe ダッシュボードに表示されます。

  4. 4

    Webhook を確認する

    Stripe で送信先の Event deliveries タブを開くと、payment_intent.succeeded が Delivered と表示されています。

請求されたのに、TourTask で支払い済みにならない場合は?

Stripe で Webhook を確認します。本番環境であること、Snapshot 形式、イベント payment_intent.succeeded、正確なアドレスを確かめてください。TourTask の Webhook シークレットには、このエンドポイントの署名シークレットが入っている必要があります。失敗した送信は、Stripe の送信先の Event deliveries タブにすべて表示されます。

Apple Pay と Google Pay を追加する


Apple Pay と Google Pay はそれぞれ独立したゲートウェイで、Stripe Elements と同じ 2 つのキーを使って同じように設定します。それぞれ専用のアドレスに専用の Webhook エンドポイントが必要で、そのエンドポイントの署名シークレットを各ゲートウェイの Webhook シークレットに入力します。

Apple Pay

https://api.tourtask.com/v1/payments/apple-pay/notifications/booking

Google Pay

https://api.tourtask.com/v1/payments/google-pay/notifications/booking
Stripe にウェブアドレスを登録する

カード入力フォームとは違い、ウォレットのボタンは、Stripe の Settings → Payment method domains に登録したアドレスにしか表示されません。旅行者が予約するアドレスをすべて登録してください。ご自身のウェブサイト、yourname.tourtask.com、TourTask のウェブサイト(yourname.tourtask.site または独自ドメイン)です。example.com と www.example.com は別々に登録します。

よくある質問


いいえ。カード情報は旅行者のブラウザーから Stripe に直接送られます。

Stripe Elements では旅行者は予約ページにとどまり、Stripe では Stripe のページに移動してから戻ります。両方を併用することもできます。

Stripe ダッシュボードの支払い方法の設定でオンにしている方法です。カードは初期設定でオンになっています。

いいえ。TourTask が予約の合計金額を、ゲートウェイに選んだ通貨に換算します。

このページは役に立ちましたか?