- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- BookingFailure
- Causa
- PaymentFailureInformation
- ThreeDS1Parameters
Consente di aggiornare un elemento Booking
esistente.
Richiesta HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
booking.name |
Nome risorsa della prenotazione: |
Parametri di query
Parametri | |
---|---|
updateMask |
Maschera dei campi di tutti i campi di prenotazione da aggiornare Si tratta di un elenco di nomi completi dei campi separati da virgole. Esempio: |
bookingFailure |
Se l'elaborazione di una richiesta di prenotazione confermata in modo asincrono non va a buon fine e lo stato della prenotazione viene aggiornato su NON RIUSCITA, questo campo dovrebbe riflettere l'errore della logica di business (ad esempio, l'utente ha una prenotazione esistente troppo vicina a questo momento). Questo campo deve essere impostato solo quando si aggiorna lo stato della prenotazione su NON RIUSCITA, altrimenti verrà ignorato. |
Corpo della richiesta
Il corpo della richiesta contiene un'istanza di Booking
.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Booking
.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/mapsbooking
BookingFailure
Dati di stato che indicano perché l'elaborazione di una prenotazione non è riuscita in modo asincrono. BookingFailure è pensato per acquisire principalmente gli errori della logica di business.
Rappresentazione JSON |
---|
{ "cause": enum ( |
Campi | |
---|---|
cause |
Il motivo per cui la prenotazione non è riuscita. (obbligatorio) |
rejectedCardType |
(obbligatorio solo se la causa è PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description |
Questo campo facoltativo viene utilizzato dal partner per includere informazioni aggiuntive solo a scopo di debug. (facoltativo) |
paymentFailure |
Informazioni sugli errori di pagamento. |
Causa
Enumerazione delle cause di errore.
Enum | |
---|---|
CAUSE_UNSPECIFIED |
Valore predefinito: Non usare; equivale a un "errore sconosciuto" |
SLOT_UNAVAILABLE |
Lo slot di disponibilità a cui viene fatto riferimento non è più disponibile. |
SLOT_ALREADY_BOOKED_BY_USER |
L'utente ha già prenotato un appuntamento per lo spazio di disponibilità indicato. |
LEASE_EXPIRED |
Il leasing (se fornito) è scaduto e non può più essere utilizzato per completare la prenotazione richiesta. |
OUTSIDE_CANCELLATION_WINDOW |
Al momento non è possibile effettuare l'annullamento richiesto a causa dei limiti di tempo previsti dalle norme sull'annullamento del commerciante. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Si è verificato un errore durante l'elaborazione del pagamento perché il tipo di carta di credito fornito non è stato accettato dal commerciante. Il tipo di carta di credito deve essere specificato nel campo rifiutatoCardType. |
PAYMENT_ERROR_CARD_DECLINED |
Si è verificato un errore durante l'elaborazione del pagamento perché la carta di credito fornita è stata rifiutata. |
PAYMENT_OPTION_NOT_VALID |
Si è verificato un errore con il pacchetto/abbonamento utilizzato per il pagamento della prenotazione. Potrebbero non esserci altri utilizzi validi, potrebbero essere scaduti e così via. |
PAYMENT_ERROR |
Si è verificato un errore durante l'elaborazione del pagamento per questa prenotazione. Utilizza questo valore per indicare un errore generico relativo ai pagamenti, solo se l'errore non corrisponde a uno specifico errore di pagamento riportato sopra. |
USER_CANNOT_USE_PAYMENT_OPTION |
L'utente non può utilizzare l'opzione di pagamento indicata (ad es. se l'utente prova a utilizzare per la seconda volta il prezzo di un acquisto). |
BOOKING_ALREADY_CANCELLED |
Una prenotazione che l'utente ha cercato di annullare è già stata annullata. |
BOOKING_NOT_CANCELLABLE |
Una prenotazione che l'utente ha tentato di annullare non può essere annullata. |
OVERLAPPING_RESERVATION |
L'utente ha una prenotazione esistente troppo vicina a questo orario. |
USER_OVER_BOOKING_LIMIT |
Prenotazione non riuscita perché l'utente supera il limite di prenotazioni per utente dell'aggregatore. |
PAYMENT_REQUIRES_3DS1 |
Imposta il momento in cui il pagamento viene rifiutato perché hai richiesto un nuovo tentativo della transazione, ma questa volta dopo aver eseguito la verifica o la risposta 3DS1. Tieni presente che lo stato di errore della transazione corrente rimarrà non riuscito. I nuovi tentativi saranno completamente separati. Se questo è il motivo dell'errore, DEVE essere impostato paymentFailure.3DS1_parameters. In caso contrario, la causa corrente verrà considerata come PAYMENT_ERROR. |
PaymentFailureInformation
Informazioni sugli errori di pagamento.
Rappresentazione JSON |
---|
{
"threeds1Parameters": {
object ( |
Campi | |
---|---|
threeds1Parameters |
Parametri utilizzati da un aggregatore RwG per avviare un protocollo di autenticazione 3DS1 con l'utente. Verrà ignorato a meno che BookingFailure.cause non sia impostato su PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
Parametri che richiedono a RwG di eseguire una verifica 3DS1.
I parametri sono impostati secondo la descrizione di EMVCo del protocollo 3DS1.
Rappresentazione JSON |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
Campi | |
---|---|
acsUrl |
L'URL da cui caricare un modulo da presentare all'utente per l'autenticazione. |
paReq |
Una richiesta PaymentAuthentication. Da pubblicare nel modulo ACSUrl, se fornito. |
transactionId |
Un identificatore utilizzato dal provider ACS. Da pubblicare nel modulo ACSUrl, se fornito. |
mdMerchantData |
Dati del commerciante. Da pubblicare nel modulo ACSUrl, se fornito. |