
作为行动中心的端到端预订集成的一部分,您可以启用任何押金、缺席费或预付费库存,以便在可能需要付款的任何交易中链接到您的预订页面。通过这种方式启用付款功能后,您可以在指定的预订页面上处理整个预订流程和交易。
资格要求
如需为特定预订添加付款功能,您必须满足以下前提条件:
付款重定向实现步骤
预订修改
本部分介绍了预订修改和取消如何与付款重定向互动,包括空档排除和错误处理。
付款重定向预订
通过付款重定向创建的预订直接在合作伙伴的预订平台上完成。Google 不会存储或管理这些预订,因此 用户无法通过 “通过 Google 预订”查看或修改这些预订。对于付款重定向预订的任何修改或取消,都必须直接在合作伙伴的平台上执行。
修改端到端预订
当用户修改现有端到端预订(最初使用 CreateBooking 创建)时,Google 会自动从修改视图中的可用选项中排除所有标记为
linkout_required_reason: PAYMENT_REQUIRED 的空档(使其不可用或灰显)。这样可以防止用户在未完成付款的情况下将端到端预订切换到付款重定向(例如需要押金)空档。
处理 UpdateBooking 请求
UpdateBooking API 端点不支持将用户转换为付款重定向流程或返回重定向网址。在极少数情况下,如果合作伙伴的服务器收到针对付款重定向(例如需要押金)空档的
UpdateBooking 请求(例如,如果用户在更新后的空闲时间完全传播到服务缓存之前尝试进行修改):
- 通过返回包含
booking_failure的UpdateBookingResponse拒绝请求 。 - 失败原因:将
booking_failure.cause设置为SLOT_UNAVAILABLE。这样会向用户显示明确的消息(“抱歉,此时间段已不可用。”),并防止发送不正确的确认电子邮件。 - 失败说明:在
booking_failure.description中提供明确的说明(例如"UpdateBooking not allowed on PR slots"),以便进行日志记录和问题排查。
沙盒测试
为合作伙伴的集成启用付款重定向后,可以直接在沙盒环境中验证此行为:
- 使用
CreateBooking创建标准端到端预订。 - 提供包含标准空档和
PAYMENT_REQUIRED空档的空闲时间空档。 - 在沙盒预订管理视图中打开预订,尝试进行修改,并确认
PAYMENT_REQUIRED空档显示为不可用(灰显)。 - 验证服务器是否使用
SLOT_UNAVAILABLE拒绝针对付费空档的意外UpdateBooking调用。