- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- BookingFailure
- Causa
- PaymentFailureInformation
- ThreeDS1Parameters
Aggiorna 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 ricerca
Parametri | |
---|---|
updateMask |
Maschera per tutti i campi di prenotazione da aggiornare Si tratta di un elenco separato da virgole di nomi completi dei campi. 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 a NON RIUSCITA, questo campo dovrebbe riflettere l'errore della logica di business (ad esempio, se l'utente ha una prenotazione esistente troppo vicina a questo orario). Questo campo deve essere impostato solo quando si aggiorna lo stato della prenotazione su FAILED. In caso contrario, 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 sullo stato che indicano il motivo per cui l'elaborazione di una prenotazione non è riuscita in modo asincrono. BookingFailure ha lo scopo di rilevare principalmente errori della logica di business.
Rappresentazione JSON |
---|
{ "cause": enum ( |
Campi | |
---|---|
cause |
Il motivo per cui la prenotazione non è andata a buon fine. (obbligatorio) |
rejectedCardType |
(obbligatorio solo se la causa è PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description |
Questo campo facoltativo viene utilizzato per consentire al partner di includere informazioni aggiuntive solo a scopo di debug. (facoltativo) |
paymentFailure |
Informazioni sugli errori di pagamento. |
Causa
Enumerazione delle cause dell'errore.
Enum | |
---|---|
CAUSE_UNSPECIFIED |
Valore predefinito: non utilizzare; corrisponde 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à di riferimento. |
LEASE_EXPIRED |
Il contratto di affitto (se fornito) è scaduto e non può più essere utilizzato per completare la prenotazione richiesta. |
OUTSIDE_CANCELLATION_WINDOW |
L'annullamento richiesto non può essere eseguito al momento a causa dei limiti temporali stabiliti nelle 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 valore 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/l'abbonamento utilizzato per il pagamento della prenotazione. Potrebbe non essere più possibile alcun uso valido, potrebbe essere scaduto e così via. |
PAYMENT_ERROR |
Si è verificato un errore durante l'elaborazione del pagamento per questa prenotazione. Utilizza questo valore per indicare un errore generale 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 specificata (ad esempio l'utente sta tentando di utilizzare un prezzo prima volta per la seconda volta). |
BOOKING_ALREADY_CANCELLED |
Una prenotazione che l'utente ha provato ad annullare è già stata annullata. |
BOOKING_NOT_CANCELLABLE |
Una prenotazione che l'utente ha tentato di annullare non è annullabile. |
OVERLAPPING_RESERVATION |
L'utente ha una prenotazione esistente troppo vicina a questo orario. |
USER_OVER_BOOKING_LIMIT |
Prenotazione non riuscita perché l'utente ha superato il limite di prenotazioni per utente definito dall'aggregatore. |
PAYMENT_REQUIRES_3DS1 |
Imposta quando il pagamento viene rifiutato perché richiedi un nuovo tentativo di transazione, ma questa volta dopo aver eseguito la verifica/risposta di 3DS1. Tieni presente che lo stato di errore della transazione corrente rimarrà non riuscito. Il nuovo tentativo sarà completamente separato. Se questo è il motivo dell'errore, paymentFailure.3DS1_parameters DEVE essere impostato. In caso contrario, la causa attuale verrà trattata come se fosse 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 che RwG esegua una verifica 3DS1.
I parametri sono impostati dalla 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 di PaymentAutenticazione. 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. |