Method: notification.partners.bookings.patch

Обновляет существующее Booking .

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования 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 предназначен в первую очередь для обнаружения ошибок бизнес-логики.

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 При обработке платежа произошла ошибка, поскольку указанный тип кредитной карты не был принят продавцом. Тип кредитной карты должен быть указан в поле ignoreCardType.
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. Обратите внимание, что состояние сбоя текущей транзакции останется неудачным. Повторная попытка будет полностью отдельной.

Если это причина сбоя, ДОЛЖЕН быть установлен параметр payFailure.3DS1_parameters. Если это не так, текущая причина будет рассматриваться как PAYMENT_ERROR.

Информация о сбое платежа

Информация о сбоях в оплате.

JSON-представление 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Поля
threeds1Parameters

object ( ThreeDS1Parameters )

Параметры, используемые агрегатором RwG для инициирования протокола аутентификации 3DS1 с пользователем. Будет игнорироваться, если для BookingFailure.cause не установлено значение PAYMENT_REQUIRES_3DS1.

ТриDS1Параметры

Параметры, требующие от RwG выполнения запроса 3DS1.

Параметры устанавливаются описанием EMVCo протокола 3DS1.

JSON-представление 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Поля
acsUrl

string

URL-адрес, с которого можно загрузить форму, которая будет предоставлена ​​Пользователю для аутентификации.

paReq

string

Запрос аутентификации платежа. Будет опубликовано в форме ACSUrl, если она имеется.

transactionId

string

Идентификатор, используемый поставщиком ACS. Будет опубликовано в форме ACSUrl, если таковая имеется.

mdMerchantData

string

Данные о торговце. Будет опубликовано в форме ACSUrl, если она имеется.