Panoramica

Nell'ambito dell'integrazione end-to-end delle prenotazioni di Actions Center, puoi attivare la ricezione dei pagamenti da parte degli utenti da parte dei tuoi commercianti quando effettuano una prenotazione, un appuntamento o una prenotazione. Google collabora con gli elaboratori dei pagamenti per configurare la tokenizzazione. I sistemi di elaborazione dei pagamenti utilizzano quindi token univoci per pagare i commercianti in tutta sicurezza.

Per le prenotazioni con pagamento sicuro, mostriamo un modulo Dati di pagamento nel flusso di pagamento. In questo modo, l'utente può inserire i dati della sua carta di credito.

È disponibile il supporto per 3DS1 e 3DS2. Consulta questo tutorial sull'implementazione.

Idoneità

Affinché i tuoi commercianti ricevano i pagamenti tramite il Centro azioni, devi soddisfare i seguenti requisiti:

  1. Utilizza un elaboratore dei pagamenti supportato. L'elenco più recente degli elaboratori supportati è disponibile sul sito web di Google Pay.
  2. Accetta i pagamenti con token in conformità con l'elaboratore.
  3. Completa la procedura di verifica dell'identità e dell'attività descritta qui.
  4. Il pagamento non può essere attivato per le prenotazioni che richiedono una conferma asincrona .

Modifiche ai feed e al server di prenotazione per i pagamenti

I pagamenti vengono effettuati tramite una procedura di attivazione a livello di commerciante. Devi attivare i pagamenti per tutti i commercianti che devono ricevere pagamenti per i propri servizi. Per attivare i pagamenti, è necessario apportare modifiche ai feed e al server di prenotazione.

Feed

  • Feed dei commercianti: specifica i dati di pagamento tramite il valore tokenization_parameter impostato nel campo tokenization_config. Il set dipende dall'elaboratore dei pagamenti scelto. L'insieme è lo stesso insieme di paymentMethodTokenizationParameters.parameters che verrebbe passato a Google Pay se esegui l'integrazione.
  • Feed di servizi/disponibilità: specifica i requisiti di pagamento in base al tuo caso d'uso appropriato. Per ulteriori dettagli, consulta Casi d'uso per i pagamenti.

Server di prenotazione

Casi d'uso per i pagamenti

Quando decidi se accettare pagamenti per ciascuno di questi casi d'uso, consulta le nostre Norme relative ai pagamenti e assicurati di poter rispettare tutte le norme pertinenti.

Esistono i seguenti casi d'uso per i pagamenti:

Per ulteriori informazioni su come implementare ciascuno di questi casi d'uso, consulta il tutorial sulla configurazione dei pagamenti.

Prenotazioni prepagate completate

La Figura 1 mostra il flusso di attività tra gli utenti, te (il partner di pianificazione), Google e l'agente di elaborazione dei pagamenti.

Figura 1: diagramma di sequenza delle prenotazioni prepagate
Figura 1: diagramma di sequenza delle prenotazioni prepagate
  • Un pagamento deve corrispondere al 100% dell'importo del costo del servizio. In altre parole, i servizi devono essere pagati per intero al momento della prenotazione.
Modifiche ai feed dei servizi

Depositi e commissioni per mancata presentazione

I depositi e le commissioni per mancata presentazione vengono configurati in modo simile. La Figura 2 mostra il flusso di queste attività tra gli utenti, te (il partner di pianificazione), Google e l'agente di pagamento.

Figura 2: diagramma di sequenza delle prenotazioni con deposito o con tariffa per mancato arrivo
Figura 2:diagramma di sequenza delle prenotazioni con deposito o commissione per mancata presentazione

I depositi e le commissioni per mancato arrivo possono essere utilizzati per garantire che un utente si presenti per la sua prenotazione.

  • Un deposito può essere addebitato sulla carta di credito dell'utente in anticipo o in un secondo momento.
  • Se l'utente non si presenta alla prenotazione, può essere addebitata una commissione per mancata presentazione.
  • Se necessario, sia i depositi sia le commissioni per mancato arrivo possono essere applicati contemporaneamente per una prenotazione.
  • Anche se non è richiesto alcun pagamento anticipato, il server di prenotazione deve rispondere alla richiesta CreateBooking con un PaymentInformation contenente un payment_transaction_id, che deve essere univoco. payment_transaction_id non deve essere fornito dall'elaboratore dei pagamenti, ma può essere generato dal server di prenotazione.
Modifiche ai servizi o ai feed di disponibilità

I depositi e le commissioni per mancata presentazione possono essere specificati a livello di servizio o di disponibilità per un commerciante. Se le specifichi a livello di slot di disponibilità, queste sostituiscono le definizioni a livello di servizio.

  • Per attivare i depositi, imposta il campo deposit a livello di servizio o di slot di disponibilità.
  • Per attivare le commissioni per mancata presentazione, imposta il campo no_show_fee a livello di servizio o di spazio di disponibilità.
  • Imposta il campo require_credit_card su REQUIRE_CREDIT_CARD_CONDITIONAL a livello di servizio o di area di disponibilità.
  • (Facoltativo) Imposta prepayment_type su REQUIRED o OPTIONAL.

È necessaria una carta di credito

Potrebbero esserci altri casi d'uso che richiedono una carta di credito al momento della prenotazione.

  • Imposta il campo require_credit_card su REQUIRE_CREDIT_CARD_ALWAYS a livello di Servizio o a livello di Disponibilità per un commerciante.

Annullamenti e rimborsi

Gli annullamenti e i rimborsi vengono avviati dal partner (tu) o dall'utente tramite il Centro azioni. In entrambi i casi, devi rispettare il valore CancellationPolicy impostato a livello di servizio e comunicato all'utente al momento del pagamento della prenotazione.

Se non fornisci CancellationPolicy, si presume che qualsiasi annullamento entro il periodo di annullamento definito da min_advance_online_canceling impostato a livello di livello di servizio sia rimborsabile. Se min_advance_online_canceling non è definito, è 0 (ovvero annullabile in qualsiasi momento).

Se devi disattivare l'annullamento dal Centro azioni, rivolgiti al tuo POC di Google.

Modifiche alle unità di raffreddamento a terra
  • Dopo aver fornito un rimborso all'utente, devi inviare un RTU di aggiornamento della prenotazione per modificare lo stato di pagamento della prenotazione. Imposta update_mask su status,payment_information.prepayment_status e imposta payment_information.prepayment_status = PREPAYMENT_REFUNDED e status = CANCELED.
    • Utilizza i nuovi BookingStatus = CANCELED e PrepaymentStatus = PREPAYMENT_REFUNDED. Il valore enumerato CANCELED_AUTOMATIC_REFUND è deprecato sia per l'API Maps Booking sia per i modelli gRPC.
Passare al server di prenotazione
  • Quando il Centro azioni invia un messaggio UpdateBookingRequest e questo attiva un rimborso per l'utente, imposta booking.payment_information.prepayment_status = PREPAYMENT_REFUNDED in UpdateBookingResponse.