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 )

Если обработка асинхронно подтвержденного запроса на бронирование завершается неудачей и статус бронирования обновляется на «НЕУДАЧНО», это поле должно отражать ошибку бизнес-логики (например, у пользователя уже есть существующее бронирование слишком близко к этому времени). Это поле должно быть установлено только при обновлении статуса бронирования на «НЕУДАЧНО» и будет игнорироваться в противном случае.

Текст запроса

В теле запроса содержится экземпляр объекта 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) с помощью запроса/ответа. Обратите внимание, что текущее состояние неудачной транзакции останется «неудачным». Повторная попытка будет выполнена отдельно.

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

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

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

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

object ( ThreeDS1Parameters )

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

ThreeDS1Parameters

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

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

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

string

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

paReq

string

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

transactionId

string

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

mdMerchantData

string

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