支払いタイプの指定

前提条件

このガイドを完了するには、以下の手順を完了しておく必要があります。

  1. Google のお支払いポリシーについて理解する。
  2. E2E 統合のフィードのエクスポートを完了している。

このアドオンでサポートされているお支払い方法は次のとおりです。

  1. 前払い
  2. 無断キャンセル料 / キャンセル料
  3. 入金の
  4. クレジットカード必須

支払いのユースケースはすべて、支払い構成なし(支払い構成が不要)のユースケースの拡張です。このチュートリアルでは、まずその構成について説明し、他の構成を拡張機能として扱います。

前払い

この構成は、予約時にサービスの料金を全額支払うことを指定する場合に使用します。前払いは、Avaibility フィードの payment フィールドを通じて在庫状況レベルで指定されます。

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
    "room_id": "A-dining-room",
    "room_name": "Wine Tasting Room",
    "party_size": 2,
    "prepayment": {
      "price_info": {
        "price": {
          "price_micros": 200000000,
          "currency_code": "USD",
          },
        "price_type": "PER_PERSON"
        }
      }
    }
  }]
}

無断キャンセル料

ユーザーが予約に出席しない場合、またはキャンセル期間後にキャンセルした場合、無断キャンセル料が請求されることがあります。キャンセル期間が指定されていない場合は、デフォルトでスロットの開始時間になります。

無断キャンセル料を指定するには、次の例に示すように、サービス フィードに no_show_fee フィールドを含める必要があります。

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 14400,
    },
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        },
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

この例では、予約所有者が予約に出席しない場合、パートナーまたは販売者は no_show_fee.fee.price_micros フィールドで指定された $25 の固定料金を請求する権限があります。この料金は、scheduling_rules.min_advance_online_canceling フィールドで指定されたとおり、ユーザーが予約の 4 時間前(14,400 秒)以内にキャンセルした場合にも請求されることがあります。

空き状況フィードで無断キャンセル料を定義する方法については、在庫状況レベルでの料金のオーバーライドをご覧ください。

無断キャンセル料は、必要に応じて予約の 1 名あたり請求するように構成できます。この場合、no_show_fee.fee.fee_typePER_PERSON に設定できます。

入金の

デポジットは、予約時に最初の請求金額をお受け取りいただくために使用されます。 デポジットは予約時または予約時に請求できます。場合によっては、保証金が払い戻し可能な条件と、オンラインで予約をキャンセルできるタイミングを定義する必要があります。

デポジットを指定するには、次の例に示すように、サービス フィードに deposit フィールドを含める必要があります。

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 86400,
    },
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": "USD",
            "min_advance_cancellation_sec": 14400,
        },
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

この例では、min_advance_online_canceling でキャンセル期間を定義し、deposit.min_advance_cancellation_sec でデポジットが払い戻し可能になるタイミングを定義しています。この例では、デポジットのキャンセル時刻を払い戻し期間とは別に指定できます。この場合、ユーザーは 24 時間前(86, 400 秒前)までオンラインでサービスをキャンセルできます。これにより、キャンセルが遅れた場合には販売者に直接通知されます。ただし、ユーザーは予約の 4 時間前(14,400 秒前)までは、(キャンセルについて貴社または販売者に連絡して)デポジットの払い戻しを受けられる場合があります。これは、購入手続き時と確認メールに記載されている利用規約に記載されています。

可用性レベルでデポジットを定義する方法については、可用性レベルでの料金のオーバーライドをご覧ください。

また、無断キャンセル料と同様に、保証金は固定レートまたは 1 人あたりのレートで請求できます。この場合、デポジットは "deposit_type": "FIXED_RATE_DEFAULT" で指定される $25 の固定金利になります。予約に人数が含まれている場合は、"deposit_type": "PER_PERSON" を設定することで、1 人あたりのデポジットとしてデポジットを指定できます。

クレジットカードを必須にする

サービスによっては、本人確認のための追加の方法としてクレジット カードが必要な場合があります。 ただし、前払い、デポジット、無断キャンセル料には使用できません。これらのユースケースが必要な場合は、明示的に構成する必要があります。クレジット カードを要求すると、多くの場合、このサービスの予約数が大幅に減少します。

購入手続き時にクレジット カードの入力を要求するには、require_credit_card フィールドを REQUIRE_CREDIT_CARD_ALWAYS に設定する必要があります。

{
    "merchant_id": "merchant-1",
    "service_id": "reservation",
    "name": "reservation",
    "description": "Food reservation",
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

在庫状況レベルで価格をオーバーライドする

料金と料金体系は、サービスレベルで指定されます。ほとんどの場合、このサービスレベルの料金を使用する必要があります。ただし、特定の空き状況スロットの支払い構造を変更するのは理にかなっています。たとえば、次のような状況は、可用性レベルで料金や料金をオーバーライドすることで処理できます。

  • 火曜日は値下げ、土曜日は値上げされます。
  • 17:00 ~ 19:00 の時間帯に無断キャンセル料は適用されません。
  • 人数が 6 人を超える場合はデポジットが必要です。
  • 特定の部屋を予約するにはクレジット カードが必要です。

支払いタイプの表には、お支払い方法 / 料金方法ごとに、サービスレベル定義をオーバーライドするために空き情報フィードで使用するフィールドがリストされています。

Payment Type(お支払いタイプ) フィードの定義 オーバーライドの可否
前払い Availability.prepayment 上書き不可
無断キャンセル料 Service.no_show_fee Availability.no_show_fee
入金の Service.deposit Availability.deposit