必要條件
如要完成本指南操作,您必須完成下列步驟:
這個外掛程式支援的付款方式如下:
- 預付款
- 逾時未到 / 取消費
- 訂金
- 必須提供信用卡資訊
所有付款用途皆為無付款/即付即用用途 (無須付款設定) 的延伸,因此本教學課程會先說明該項設定,並將其他設定視為擴充功能。
預付款
這項設定可用來指定必須在預訂時付清服務費用。預付款會透過 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 |