啟用付款功能

注意：「透過 Google 預訂」功能目前還不支援新的附加功能。

使用「透過 Google 預訂」端對端整合時，您可以選擇讓商家在使用者預訂、預約或預訂時收到他們的款項。Google 會與付款處理方合作設定權杖化。設定完畢後，付款處理方就能使用不重複代碼安全地付費給商家。

若是有付款方式付款的預訂，系統會在結帳流程中顯示「付款資訊」模組。讓使用者可以輸入信用卡資訊。

支援 3DS1 和 3DS2，請參閱這個教學課程瞭解導入方式。

使用資格

如果您的商家要透過「透過 Google 預訂」收款，就必須符合下列規定：

1. 與受支援的付款處理方合作。您可以前往 Google Pay 網站查看支援的處理器最新清單。
2. 請根據處理方接受代碼化付款。
3. 無法進行非同步確認的預訂。

變更動態饋給和預訂伺服器以啟用付費功能

在商家層級完成啟用程序後，才能使用付費功能。您必須為所有需要收取服務費用的商家啟用付款功能。如要啟用付款功能，你必須對動態饋給和預訂伺服器進行變更。

動態饋給

• 商家動態饋給：透過 tokenization_config 欄位中設定的 tokenization_parameter 指定付款資訊。這組設定取決於您選擇的付款處理方。這組組合與用於整合 Google Pay 的一組 paymentMethodTokenizationParameters.parameters 整合。
  注意：如果您代表商家收取付款，可以提供自己的參數，而非商家的參數。
• 服務/供應情形動態饋給：請根據適當用途指定付款規定。詳情請參閱付款用途一文。

Booking Server (預訂伺服器)

• 根據使用者付款類型，導入 CreateBooking 方法
• Google 會在 CreateBookingRequest 欄位傳送 payment_processing_parameters.unparsed_payment_method_token 欄位中的付款權杖。與 Google Pay 整合作業中的回呼會收到的 paymentData 相同。
• 在 CreateBookingResponse 中加入 PaymentInformation 訊息，指定付款方式、狀態、交易 ID 和價格 / 費用結構。
• 在 CreateBookingResponse 中，將 payment_information.payment_processed_by 欄位設為 PROCESSED_BY_PARTNER。

付費功能使用案例

在決定是否要為上述各種用途付費時，請參閱我們的付款政策，確保您能遵守所有相關政策。

付款的用途如下：

• 完成預付預訂
• 預訂所需訂金
• 使用者無法在預訂服務中看見未收取的費用
• 預訂時必須提供信用卡

如需實作這些用途的更多資訊，請參閱設定付款的教學課程。

預收預訂的全額費用

圖 1 顯示了使用者 (您 (排程合作夥伴))、Google 和付款處理方之間的活動流程。

圖 1：預付預訂序列圖

• 付款金額必須是服務費用金額的 100%，也就是說，服務在預訂時必須支付全額費用。

服務動態饋給異動

• 將服務的 prepayment_type 欄位設為 REQUIRED。
• 將服務的 require_credit_card 欄位設為 REQUIRE_CREDIT_CARD_CONDITIONAL。

訂金和逾時未到費用

訂金和逾時未到費用的設定方式相似。圖 2 顯示了使用者 (您 (排程合作夥伴))、Google 和付款處理方之間的活動流程。

圖 2：存款或未支付費用 預訂流程圖

訂金和表演費可用來確保使用者看見預訂。

• 可預先從使用者的信用卡扣款，或在日後收費。
• 如果使用者不收取 任何預訂費用，系統會向使用者收取未收取的手續費。
• 視需要在預訂時同時支付存款費和到場費。
• 即使不需要預繳款項，預訂伺服器仍必須透過包含 payment_transaction_id 的 PaymentInformation 回應 CreateBooking 要求，而且不得重複。payment_transaction_id 不必由付款處理方提供，但可以透過預訂伺服器產生。

服務或供應情形動態饋給異動

您可以在「服務」層級或商家的「供應情形」層級層級指定訂金和不收取手續費。如果在供應時段層級指定這些值，就會覆寫服務層級的定義。

• 如要啟用存款，請在服務或可預訂時段層級設定 deposit 欄位。
• 如要啟用不收取手續費，請在服務或供應時段層級設定 no_show_fee 欄位。
• 在服務或可用性時段層級，將 require_credit_card 欄位設為 REQUIRE_CREDIT_CARD_CONDITIONAL。
• (選用) 將 prepayment_type 設為 REQUIRED 或 OPTIONAL。

必須提供信用卡資訊

或者，其他用途可能需在預訂時提供信用卡。

• 在「服務」層級或商家的「可用性」運算單元層級中，將 require_credit_card 欄位設為 REQUIRE_CREDIT_CARD_ALWAYS。

取消和退款

取消或退款是由合作夥伴 (您) 或由「透過 Google 預訂」所啟動。無論是哪種情況，您都必須遵循在服務層級設定的 CancellationPolicy，並在預訂結帳時通知使用者。

如未提供 CancellationPolicy，系統會假設在min_advance_online_canceling 於服務等級如果 min_advance_online_canceling 未定義，則為 0 (表示可取消)。

如果您必須停用「透過 Google 預訂」端的取消功能，請與 Google 合作夥伴業務聯絡人討論。

RTU 異動

• 向使用者退款後，您必須傳送更新預訂即時文字訊息來變更預訂的付款狀態。將 update_mask 設為 status,payment_information.prepayment_status，並設定 payment_information.prepayment_status = PREPAYMENT_REFUNDED 和 status = CANCELED。
  • 使用新的 BookingStatus = CANCELED 和 PrepaymentStatus = PREPAYMENT_REFUNDED。Maps Booking API 和 gRPC 範本都淘汰了 CANCELED_AUTOMATIC_REFUND 列舉值。

變更為預訂伺服器

• 當「透過 Google 預訂」傳送 UpdateBookingRequest並觸發使用者退款，請在 UpdateBookingResponse 中設定 booking.payment_information.prepayment_status = PREPAYMENT_REFUNDED。