- API 認証情報
- マーチャントアカウント
- APIキー
- API URLプレフィックス
- HMACキー
Adyen のマーチャントアカウントを TourTask に接続します。必要なのは、4 つの値、1 つの Webhook、テスト決済です。テスト用ではなく本番の Adyen アカウントが必要で、取得には数週間かかります。
本番の Adyen アカウントを取得する
- 1
Adyen の営業チームに連絡する
Adyen の営業フォームから、ツアーを販売していることを伝えます。Adyen はツアー会社を制限対象の業種として扱っており、追加の書類が必要で、審査にも時間がかかります。
- 2
契約前に保証金について確認する
Adyen は入金額の一部を保証金として留保することがあります。数か月前に支払われるツアーでは、その額が大きくなる場合があります。
Adyen の情報をコピーする
Merchant admin の役割を持つユーザーで、本番の Customer Area(ca-live.adyen.com)にサインインします。各値は手元に控えておいてください。Webhook の作成後に TourTask で Adyen を追加するときに、まとめて入力します。
- 1
マーチャントアカウントをコピーする
Settings → Merchant accounts で、会社アカウントではなくマーチャントアカウントのコードをコピーします。TourTask のマーチャントアカウントに入力する値です。
- 2
URL プレフィックスをコピーする
Developers → API URLs で Prefix をコピーします。ウェブアドレス全体ではなく、プレフィックスだけです。TourTask の API URLプレフィックスに入力する値です。
- 3
API 認証情報を作成する
会社アカウントを選び、Developers → API credentials で Payments タブを開きます。Create new credential を選び、Web service user を選んでから Create credential を選びます。
- 4
API キーを生成する
Server settings → Authentication で API key タブを開き、Generate API key を選びます。キーは一度しか表示されないので、TourTask の APIキー用にコピーしてから、Adyen で Save changes を選びます。
Webhook を作成する
この Webhook がないと、旅行者に請求されても予約は未確認のままになります。
Adyen 用の TourTask の Webhook アドレス
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Standard webhook を追加する
本番の Customer Area で Developers → Webhooks を開き、Create new webhook を選んでから、Standard webhook の横の Add を選びます。
- 2
マーチャントアカウントで有効にする
General で Enabled をオンにし、Merchant accounts にご自身のマーチャントアカウントが含まれていることを確認します。
- 3
TourTask のアドレスを入力する
Server configuration で、上の TourTask のアドレスを URL に貼り付けます。
- 4
HMAC キーを生成する
Security で HMAC Key の横の編集アイコンを選び、Generate を選びます。キーは一度しか表示されないので、TourTask の HMACキー用にコピーします。
- 5
Save configuration を選ぶ
その後の Test configuration は省略してください。Webhook が正しくても失敗します。
TourTask に Adyen を追加する
- 1
Adyen のカードを開く
構成 → 支払いオプション を開き、オンライン決済 → 決済ゲートウェイ で Adyen のカードをクリックします。見つからない場合は、カードの下の すべてのゲートウェイを表示 を選びます。
- 2
国と通貨を選ぶ
国 で Adyen アカウントとその銀行口座がある国を、通貨 で旅行者が支払う通貨を選び、追加 をクリックします。あとでどちらかを変更するには、取り除く で Adyen を削除してから、もう一度追加します。
- 3
API 認証情報を入力する
認証 に、それぞれの入力欄があります。
マーチャントアカウント
APIキー
API URLプレフィックス
HMACキー各欄は、欄の外をクリックすると保存されます。
- 4
Adyen を有効化する
すべての欄を入力したら、有効化 をクリックします。カードが アクティブ になり、旅行者は予約ページで Adyen で支払えるようになります。支払いはすべてご自身の Adyen アカウントへ直接入金され、TourTask があなたの資金を預かることはありません。
Adyen をテストする
TourTask には Adyen のテストモードがないため、少額の実際の予約でテストし、返金します。
- 1
予約の代金を支払う
ご自身の予約ページで最も安いツアーを予約し、Adyen を選んでご自身のカードで支払います。予約ページに戻ると、予約は自動で確定します。
- 2
支払いを返金する
予約で、支払いの操作メニューから支払いを返金を選び、Adyen で返金を選びます。
- 3
テスト予約をキャンセルする
テスト決済が失敗した場合
- 支払いがすぐに失敗する:4 つの値がすべて本番の Customer Area のものか確認してください。マーチャントアカウントには、会社アカウントではなくマーチャントアカウントのコードを入力します。
- 支払ったのに予約が確定しない:本番の Customer Area で、Webhook が Enabled になっていること、ご自身のマーチャントアカウントが含まれていること、URL が上のとおりであることを確認します。問題がなければ、その Webhook で新しい HMAC Key を生成し、TourTask の HMACキーに貼り付けます。そのあと Adyen で Save configuration を選びます。
よくある質問
Adyen の Customer Area で、マーチャントアカウントに対してオンにしている方法です。TourTask で絞り込むことはありません。
通常は数日です。TourTask は返金をすぐに記録し、返金が完了した時期は Adyen の Customer Area に表示されます。
いいえ。TourTask は旅行者を Adyen の決済ページに送るため、そのための設定は不要です。