Method: notification.partners.bookings.patch

Met à jour une valeur Booking existante.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
booking.name

string

Nom de ressource de la réservation: partners/{partner ID}/bookings/{booking ID}

Paramètres de la requête

Paramètres
updateMask

string (FieldMask format)

Masque de champ de tous les champs de la réservation à mettre à jour

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"

bookingFailure

object (BookingFailure)

Si le traitement d'une demande de réservation confirmée de manière asynchrone échoue, et si l'état de la réservation est désormais FAILED, ce champ doit indiquer l'erreur de logique métier (par exemple, l'utilisateur a une réservation existante qui est trop proche). Ce champ ne doit être défini que lors de la mise à jour de l'état de la réservation sur FAILED. Il est ignoré dans les autres cas.

Corps de la requête

Le corps de la requête contient une instance de Booking.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Booking.

Champs d'application des autorisations

Requiert le champ d'application OAuth suivant :

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

BookingFailure

Données d'état indiquant la raison pour laquelle le traitement d'une réservation confirmée de manière asynchrone a échoué. L'objectif principal de BookingFailure est de capturer les erreurs de logique métier.

Représentation JSON
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Champs
cause

enum (Cause)

Cause de l'échec de la réservation. (obligatoire)

rejectedCardType

enum (CreditCardType)

(obligatoire uniquement si la cause est PAYMENT_ERROR_CARD_TYPE_REJECTED)

description

string

Ce champ facultatif permet au partenaire d'inclure des informations supplémentaires à des fins de débogage seulement. (facultatif)

paymentFailure

object (PaymentFailureInformation)

Données concernant les échecs de paiement.

Cause

Énumération des causes d'échec.

Énumérations
CAUSE_UNSPECIFIED Valeur par défaut : ne pas utiliser. Équivaut à une "erreur inconnue".
SLOT_UNAVAILABLE Le créneau de disponibilité référencé n'est plus disponible.
SLOT_ALREADY_BOOKED_BY_USER L'utilisateur a déjà pris rendez-vous pour le créneau de disponibilité référencé.
LEASE_EXPIRED La location qui a été éventuellement définie a expiré et ne peut plus être utilisée pour finaliser la réservation demandée.
OUTSIDE_CANCELLATION_WINDOW L'annulation demandée ne peut pas être effectuée à l'heure actuelle en raison de restrictions imposées par les modalités d'annulation du marchand.
PAYMENT_ERROR_CARD_TYPE_REJECTED Une erreur s'est produite lors du traitement du paiement, car le marchand n'a pas accepté le type de carte de crédit fourni. Le type de carte de crédit doit être spécifié dans "rejectedCardType".
PAYMENT_ERROR_CARD_DECLINED Une erreur s'est produite lors du traitement du paiement, car la carte de crédit fournie a été refusée.
PAYMENT_OPTION_NOT_VALID Une erreur s'est produite au niveau du pack ou de l'abonnement utilisé pour payer la réservation. Il ne peut plus être utilisé, il est peut-être arrive à expiration, etc.
PAYMENT_ERROR Une erreur s'est produite lors du traitement du paiement de cette réservation. Utilisez cette valeur pour indiquer une erreur de paiement générale, mais seulement si l'erreur ne correspond pas à une des erreurs de paiement spécifiques ci-dessus.
USER_CANNOT_USE_PAYMENT_OPTION L'utilisateur ne peut pas utiliser l'option de paiement indiquée (par exemple, l'utilisateur essaie d'utiliser un prix spécial proposé aux nouveaux clients pour la deuxième fois).
BOOKING_ALREADY_CANCELLED Une réservation que l'utilisateur a tenté d'annuler a déjà été annulée.
BOOKING_NOT_CANCELLABLE Une réservation que l'utilisateur a tenté d'annuler ne peut pas être annulée.
OVERLAPPING_RESERVATION L'utilisateur a une réservation existante qui est trop proche de cette heure.
USER_OVER_BOOKING_LIMIT La réservation a échoué, car l'utilisateur a dépassé la limite de réservations par utilisateur définie par l'agrégateur.
PAYMENT_REQUIRES_3DS1

Défini lorsque le paiement est refusé, car vous demandez que la transaction soit tentée une nouvelle fois, mais cette fois après que l'utilisateur a répondu au test 3DS1. Notez que l'état d'échec de la transaction actuelle n'est pas modifié. Le système traite la nouvelle tentative comme une transaction complètement distincte.

S'il s'agit de la cause de l'échec, vous DEVEZ définir paymentFailure.3DS1_parameters. Sinon, la cause sera traitée comme s'il s'agissait de PAYMENT_ERROR.

PaymentFailureInformation

Données concernant les échecs de paiement.

Représentation JSON
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Champs
threeds1Parameters

object (ThreeDS1Parameters)

Paramètres utilisés par un agrégateur RwG pour lancer un protocole d’authentification 3DS1 avec l’utilisateur. Le système ignore ces paramètres, à moins que BookingFailure.cause ne soit défini sur PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

Paramètres demandant que RwG effectue un défi 3DS1.

Les paramètres sont définis par la description du protocole 3DS1 d'EMVCo.

Représentation JSON
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Champs
acsUrl

string

URL à partir de laquelle charger un formulaire à présenter à l'utilisateur pour authentification.

paReq

string

Une requête PaymentAuthentication. À publier dans le formulaire ACSUrl, le cas échéant.

transactionId

string

Un identifiant utilisé par le fournisseur ACS. À publier dans le formulaire ACSUrl, le cas échéant.

mdMerchantData

string

Données du marchand. À publier dans le formulaire ACSUrl, le cas échéant.