指定付款方式

必要條件

如要完成本指南操作,您必須完成下列步驟:

  1. 瞭解我們的付款政策
  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 美元的費用。如果使用者在預約前的 4 小時 (14,400 秒) 內取消 (如 scheduling_rules.min_advance_online_canceling 欄位所指定),也可能會收取這筆費用。

如要瞭解如何在供應情形動態饋給中定義禁播費用,請參閱在供應情形層級覆寫定價

您可視需要將免預約費用設為每人收取。在這種情況下,no_show_fee.fee.fee_type 可以設為 PER_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 小時 (14400 秒) 之前 (前 14,400 秒),則可能符合退款資格;您可以聯絡您或商家取消預訂。實際退款將會顯示在結帳的條款中,以及確認電子郵件中。

如要瞭解如何在可用性層級定義訂金,請參閱在可用性層級覆寫定價

另請注意,如同未逾時費用,客戶可以按固定費率或每人費率收取訂金。在這種情況下,存款為 $25 美元的固定費率,如 "deposit_type": "FIXED_RATE_DEFAULT" 所指定。如果預訂記錄包含入住人數,您可以設定 "deposit_type": "PER_PERSON",將訂金指定為每人訂金。

需要信用卡

服務可能會要求提供信用卡做為驗證身分的其他方式。 但不得用於預付、存款或逾時未到費用。如果需要這些用途,請明確設定。需要信用卡通常會導致這項服務的預訂量明顯下降。

如果需要在結帳時提供信用卡,您必須將 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"
}

在供應情形層級覆寫定價

價格與費用結構是在服務層級指定。在大多數情況下,應使用這類服務層級的定價。不過,變更特定可預訂時段的付款結構就會很合理。舉例來說,您可以覆寫供應情形層級的價格或費用,藉此處理下列情況:

  • 每週二降價較低,星期六會上漲。
  • 下午 5:00 到 7:00 之間有空房,無須支付入場費。
  • 用餐人數超過 6 人時才需要存款。
  • 特定房間的預約需要提供信用卡。

付款類型表格會列出各個付款方式 / 費用方式,要在供應情形動態饋給中使用哪個欄位來覆寫服務層級定義。

付款方式 動態饋給定義 是否可覆寫?
預付款 Availability.prepayment 不可過度使用
逾時未到費用 Service.no_show_fee Availability.no_show_fee
訂金 Service.deposit Availability.deposit