Method: notification.partners.bookings.patch

更新现有 Booking

HTTP 请求

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

网址采用 gRPC 转码语法。

路径参数

参数
booking.name

string

预订的资源名称:partners/{partner ID}/bookings/{booking ID}

查询参数

参数
updateMask

string (FieldMask format)

要更新的所有预订字段的字段掩码

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

bookingFailure

object (BookingFailure)

如果异步确认的预订请求处理失败,且预订的状态被更新为“FAILED”,则该字段应反映业务逻辑错误(例如,用户的现有预订与此次预订的时间太过接近)。只有在将预订状态更新为“FAILED”时才应设置此字段,否则系统会忽略此字段。

请求正文

请求正文包含一个 Booking 实例。

响应正文

如果成功,则响应正文包含一个 Booking 实例。

授权作用域

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

用于说明异步预订处理失败的原因的状态数据。BookingFailure 主要用于捕获业务逻辑错误。

JSON 表示法
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
字段
cause

enum (Cause)

预订失败的原因。(必填)

rejectedCardType

enum (CreditCardType)

(仅当原因为 PAYMENT_ERROR_CARD_TYPE_REJECTED 时才需要)

description

string

该可选字段适用于仅出于调试目的添加其他信息的合作伙伴。(可选)

paymentFailure

object (PaymentFailureInformation)

与付款失败相关的信息。

原因

对失败原因的枚举。

枚举
CAUSE_UNSPECIFIED 默认值:请勿使用;金额为“未知错误”
SLOT_UNAVAILABLE 引用的可用性空档不再可用。
SLOT_ALREADY_BOOKED_BY_USER 用户已预订引用的可用性空档。
LEASE_EXPIRED 租借(如果已提供)已过期,无法再用于完成所请求的预订。
OUTSIDE_CANCELLATION_WINDOW 由于商家取消政策的时间限制,目前无法执行所请求的取消。
PAYMENT_ERROR_CARD_TYPE_REJECTED 处理付款时出现错误,因为商家不接受所提供的信用卡类型。信用卡类型必须在 rejectedCardType 中提供。
PAYMENT_ERROR_CARD_DECLINED 处理付款时出现错误,因为所提供的信用卡被拒。
PAYMENT_OPTION_NOT_VALID 用于支付预订费用的礼包/会员身份出现错误,可能是已失效或已过期等原因所致。
PAYMENT_ERROR 处理此预订的付款时出现错误。仅当错误与上述特定的付款错误不匹配时,才可使用该值来指明与付款相关的一般错误。
USER_CANNOT_USE_PAYMENT_OPTION 用户无法使用已指定的付款方式(例如用户在第二次付款时尝试使用新客户价格)。
BOOKING_ALREADY_CANCELLED 用户尝试取消的预订已被取消。
BOOKING_NOT_CANCELLABLE 用户尝试取消的预订不可取消。
OVERLAPPING_RESERVATION 用户的现有预订与此次预订的时间太过接近。
USER_OVER_BOOKING_LIMIT 由于用户超出了集合商家的每位用户预订限制,因此预订失败。
PAYMENT_REQUIRES_3DS1

当付款被拒时设置该字段,被拒原因是您在经过 3DS1 挑战/响应之后请求再次尝试交易。请注意,当前交易仍将保持失败状态。重试将会完全单独进行。

当失败原因为此原因时,必须设置 payment_failure.3DS1_parameters。如果不是,则将 PAYMENT_ERROR 视为当前的失败原因。

PaymentFailureInformation

与付款失败相关的信息。

JSON 表示法
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
字段
threeds1Parameters

object (ThreeDS1Parameters)

供 RwG 集合商家用以启动 3DS1 用户身份验证协议的参数。除非 BookingFailure.cause 设置为 PAYMENT_REQUIRES_3DS1,否则系统会忽略此参数。

ThreeDS1Parameters

请求 RwG 执行 3DS1 挑战的参数。

这些参数由 EMVCo 对 3DS1 协议的说明设置。

JSON 表示法
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
字段
acsUrl

string

可加载供用户进行身份验证的表单的网址。

paReq

string

PaymentAuthentication 请求。将发布到 ACSUrl 表单(如果提供)。

transactionId

string

ACS 提供商所用的标识符。将发布到 ACSUrl 表单(如果提供)。

mdMerchantData

string

商家数据。将发布到 ACSUrl 表单(如果提供)。