Panoramica

Nell'ambito dell'integrazione end-to-end delle prenotazioni del Centro azioni, puoi consentire il collegamento di eventuali depositi, commissioni per mancata presentazione o inventario prepagato alla tua pagina di prenotazione per le transazioni che potrebbero richiedere pagamenti. L'attivazione dei pagamenti in questo modo ti consente di gestire l'intero flusso di prenotazione e la transazione nella pagina di prenotazione che specifichi.

Idoneità

Per aggiungere pagamenti a prenotazioni specifiche, devi soddisfare i seguenti prerequisiti:

1. Un'integrazione end-to-end live esistente.
2. La possibilità di eseguire il deep linking direttamente in una pagina di prenotazione in grado di gestire l'elaborazione dei pagamenti.
3. Assicurati di rispettare le nostre norme relative al reindirizzamento dei pagamenti.

Passaggi di implementazione del reindirizzamento dei pagamenti

1. Configura il modello di URL e i campi aggiuntivi.
2. Specifica i tipi di pagamento per i tuoi slot.
3. Attiva il monitoraggio delle conversioni per l'integrazione.

Modifiche delle prenotazioni

Questa sezione descrive come le modifiche e le cancellazioni delle prenotazioni interagiscono con il reindirizzamento dei pagamenti, inclusa l'esclusione degli slot e la gestione degli errori.

Prenotazioni con reindirizzamento dei pagamenti

Le prenotazioni create tramite il reindirizzamento dei pagamenti vengono completate direttamente sulla piattaforma di prenotazione del partner. Google non memorizza né gestisce queste prenotazioni, pertanto gli utenti non possono visualizzarle o modificarle tramite Prenota con Google. Eventuali modifiche o cancellazioni delle prenotazioni con reindirizzamento dei pagamenti devono essere eseguite direttamente sulla piattaforma del partner.

Modifica delle prenotazioni end-to-end

Quando un utente modifica una prenotazione end-to-end esistente (originariamente creata utilizzando CreateBooking), Google esclude automaticamente tutti gli slot contrassegnati con linkout_required_reason: PAYMENT_REQUIRED dalle opzioni disponibili nella visualizzazione di modifica (rendendoli non disponibili o in grigio). In questo modo, gli utenti non possono passare da una prenotazione end-to-end a uno slot di reindirizzamento dei pagamenti (ad es. che richiede un deposito) senza completare il pagamento.

Gestione delle richieste UpdateBooking

L'endpoint API UpdateBooking non supporta la transizione di un utente al flusso di reindirizzamento dei pagamenti né la restituzione di un URL di reindirizzamento. Nell'improbabile eventualità che il server del partner riceva una richiesta UpdateBooking per uno slot di reindirizzamento dei pagamenti (ad es. che richiede un deposito), ad esempio se un utente tenta di apportare una modifica prima che la disponibilità aggiornata sia stata propagata completamente nelle cache di pubblicazione:

• Rifiuta la richiesta restituendo una UpdateBookingResponse contenente un booking_failure.
• Motivo dell'errore: imposta booking_failure.cause su SLOT_UNAVAILABLE. In questo modo, l'utente visualizza un messaggio chiaro ("Spiacenti, questo orario non è più disponibile") e non vengono inviate email di conferma errate.
• Descrizione dell'errore: fornisci una descrizione esplicita (ad es. "UpdateBooking not allowed on PR slots") in booking_failure.description per facilitare la registrazione e la risoluzione dei problemi.

Test nella sandbox

Una volta attivato il reindirizzamento dei pagamenti per l'integrazione del partner, questo comportamento può essere verificato direttamente nell'ambiente sandbox:

1. Crea una prenotazione end-to-end standard utilizzando CreateBooking.
2. Fornisci slot di disponibilità con un mix di slot standard e PAYMENT_REQUIRED.
3. Apri la prenotazione nella visualizzazione di gestione delle prenotazioni della sandbox per tentare di apportare una modifica e verificare che gli slot PAYMENT_REQUIRED vengano visualizzati come non disponibili (in grigio).
4. Verifica che il server rifiuti le chiamate UpdateBooking impreviste sugli slot a pagamento con SLOT_UNAVAILABLE.