使用「透過 Google 預訂」端對端整合時,您可以選擇讓商家在使用者預訂、預約或預訂時收到他們的款項。Google 會與付款處理方合作設定權杖化。設定完畢後,付款處理方就能使用不重複代碼安全地付費給商家。
若是有付款方式付款的預訂,系統會在結帳流程中顯示「付款資訊」模組。讓使用者可以輸入信用卡資訊。
支援 3DS1 和 3DS2,請參閱這個教學課程瞭解導入方式。
使用資格
如果您的商家要透過「透過 Google 預訂」收款,就必須符合下列規定:
- 與受支援的付款處理方合作。您可以前往 Google Pay 網站查看支援的處理器最新清單。
- 請根據處理方接受代碼化付款。
- 無法進行非同步確認的預訂。
變更動態饋給和預訂伺服器以啟用付費功能
在商家層級完成啟用程序後,才能使用付費功能。您必須為所有需要收取服務費用的商家啟用付款功能。如要啟用付款功能,你必須對動態饋給和預訂伺服器進行變更。
動態饋給
- 商家動態饋給:透過
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
。
付費功能使用案例
在決定是否要為上述各種用途付費時,請參閱我們的付款政策,確保您能遵守所有相關政策。
付款的用途如下:
如需實作這些用途的更多資訊,請參閱設定付款的教學課程。
訂金和逾時未到費用
訂金和逾時未到費用的設定方式相似。圖 2 顯示了使用者 (您 (排程合作夥伴))、Google 和付款處理方之間的活動流程。

訂金和表演費可用來確保使用者看見預訂。
- 可預先從使用者的信用卡扣款,或在日後收費。
- 如果使用者不收取 任何預訂費用,系統會向使用者收取未收取的手續費。
- 視需要在預訂時同時支付存款費和到場費。
- 即使不需要預繳款項,預訂伺服器仍必須透過包含
payment_transaction_id
的PaymentInformation
回應 CreateBooking 要求,而且不得重複。payment_transaction_id
不必由付款處理方提供,但可以透過預訂伺服器產生。
您可以在「服務」層級或商家的「供應情形」層級層級指定訂金和不收取手續費。如果在供應時段層級指定這些值,就會覆寫服務層級的定義。
- 如要啟用存款,請在服務或可預訂時段層級設定
deposit
欄位。 - 如要啟用不收取手續費,請在服務或供應時段層級設定
no_show_fee
欄位。 - 在服務或可用性時段層級,將
require_credit_card
欄位設為REQUIRE_CREDIT_CARD_CONDITIONAL
。 - (選用) 將
prepayment_type
設為REQUIRED
或OPTIONAL
。
必須提供信用卡資訊
或者,其他用途可能需在預訂時提供信用卡。
取消和退款
取消或退款是由合作夥伴 (您) 或由「透過 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
。