支払いを有効にする

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

「Google で予約」のエンドツーエンドの統合の一環として、ユーザーが予約や予約を行うときに、販売者から支払いを受け取るよう販売者にオプトインできます。Google は決済代行業者と協力してトークン化を設定します。 決済代行業者は一意のトークンを使って販売者に安全に支払いを行います。

支払いが保護された予約の場合、購入手続きフローに支払い情報モジュールが表示されます。これにより、ユーザーはクレジット カード情報を入力できます。

3DS1 と 3DS2 のサポートを利用できます。実装については、このチュートリアルをご覧ください。

対象条件

販売者が「Google で予約」を通じて支払いを受け取るには、次の要件を満たす必要があります。

  1. サポートされている決済代行業者を使用する。サポートされている決済代行業者の最新のリストについては、Google Pay のウェブサイトをご覧ください。
  2. 決済代行業者に従ってトークン化された支払いを受け入れます。

支払いに関するフィードと予約サーバーへの変更内容

支払いは販売者レベルのオプトイン プロセスを通じて行われます。サービスに対する支払いを受けたい販売者については、支払いを有効にする必要があります。支払いを有効にするには、フィードと予約サーバーを変更する必要があります。

フィード

  • 販売者フィード: tokenization_config フィールドの tokenization_parameter で支払い情報を指定します。このセットは、選択した決済代行業者によって異なります。このセットは、統合する場合に Google Pay に渡される paymentMethodTokenizationParameters.parameters のセットと同じです。
  • サービス/可用性フィード: 適切なユースケースに基づいて支払い要件を指定します。詳しくは、支払いのユースケースをご覧ください。

予約サーバー

支払いのユースケース

これらの各ユースケースに対して支払いを行うかどうかを判断する際は、支払いポリシーを確認し、関連するすべてのポリシーを遵守していることを確認してください。

支払いのユースケースには、次のようなものがあります。

各ユースケースの実装方法について詳しくは、支払いの構成のチュートリアルをご覧ください。

前払いによる予約の完了

図 1 は、ユーザー、スケジュール管理システム パートナー、Google、決済代行業者との間のアクティビティの流れを示しています。

図 1: 前払いの受注のシーケンス図
図 1: 前払い取り扱い金額のシーケンス図
  • サービス費用の全額を支払う必要があります。つまり、予約時にサービス料金の全額を支払う必要があります。
サービス フィードの変更点
  • そのサービスの prepayment_type フィールドを REQUIRED に設定します。
  • そのサービスの require_credit_card フィールドを REQUIRE_CREDIT_CARD_CONDITIONAL に設定します。

デポジットと無断キャンセル料

デポジットと無断キャンセル料は同様の方法で設定します。図 2 は、ユーザー(スケジュール パートナー)、Google、決済代行業者との間のこれらのアクティビティの流れを示しています。

図 2: デポジットまたは無断キャンセル料の予約シーケンス図
図 2: デポジットまたは無断キャンセル料の予約シーケンス図

デポジットと無断キャンセル料は、ユーザーの予約に対して確実に表示されるようにするために使用されます。

  • デポジットは、事前に、または後でユーザーのクレジット カードに請求できます。
  • ユーザーが予約まで表示されない場合、無断キャンセル料が請求されることがあります。
  • 必要に応じて、デポジットと無断キャンセル料の両方が予約時に適用されます。
  • 前もって支払いが不要な場合でも、予約サーバーは payment_transaction_id を含む PaymentInformation で CreateBooking リクエストに応答する必要があります。これは一意である必要があります。 payment_transaction_id は、決済代行業者から提供された必要はありませんが、予約サーバーで生成できます。
サービスまたは空室状況に関するフィードの変更

デポジットと無断キャンセル料は、サービスレベルまたは販売者の空き状況スロットレベルで指定できます。可用性スロットレベルで指定すると、サービスレベル定義がオーバーライドされます。

  • デポジットを有効にするには、サービスレベルまたは可用性スロットレベルで deposit フィールドを設定します。
  • 無断キャンセル料を有効にするには、サービスレベルまたは予約枠レベルで no_show_fee フィールドを設定します。
  • require_credit_card フィールドを、サービスレベルまたは可用性スロットレベルで REQUIRE_CREDIT_CARD_CONDITIONAL に設定します。
  • (省略可)prepayment_typeREQUIRED または OPTIONAL に設定します。

クレジットカード必須

予約時にクレジット カードが必要となるユースケースもあります。

  • 販売者のサービスレベルまたは販売者の可用性スロットレベルで、require_credit_card フィールドを REQUIRE_CREDIT_CARD_ALWAYS に設定します。

キャンセルと払い戻し

キャンセルと払い戻しは、パートナー(お客様)またはユーザーが「Google で予約」を通じて開始します。いずれの場合も、サービスレベルに設定された CancellationPolicy を尊重し、予約の購入手続きでユーザーに通知する必要があります。

CancellationPolicy を指定しないと、サービスレベルに設定された min_advance_online_canceling で定義されたキャンセル期間内にキャンセルしたものすべてが払い戻しの対象であると見なされます。min_advance_online_canceling が定義されていない場合、0 は、いつでもキャンセル可能であることを意味します。

「Google で予約」側のキャンセルを無効にする必要がある場合は、Google のパートナー オペレーション担当者にご相談ください。

RTU の変更
  • ユーザーに払い戻しを行った後は、予約の更新 RTU を送信して予約の支払いステータスを変更する必要があります。update_maskstatus,payment_information.prepayment_status に設定し、payment_information.prepayment_status = PREPAYMENT_REFUNDEDstatus = CANCELED を設定します。
    • 新しい BookingStatus = CANCELEDPrepaymentStatus = PREPAYMENT_REFUNDED を使用します。列挙値 CANCELED_AUTOMATIC_REFUND は、Maps Booking API と gRPC テンプレートの両方で非推奨になりました。
予約サーバーに変更
  • 「Google で予約」が UpdateBookingRequest を送信し、これにより、ユーザーに対する払い戻しが行われた場合は、UpdateBookingResponsebooking.payment_information.prepayment_status = PREPAYMENT_REFUNDED を設定します。