- Credenziali API
- Chiave API
- Chiave pubblicabile
- Segreto del webhook
Stripe Elements inserisce i campi della carta di Stripe nella tua pagina di prenotazione, così i viaggiatori pagano con carta senza lasciarla. Ti serve un account Stripe abilitato ai pagamenti reali: la guida a Stripe spiega come aprirne uno.
Copiare le chiavi da Stripe
- 1
Apri le chiavi API in modalità live
Apri dashboard.stripe.com/apikeys e verifica di essere in modalità live, non in una sandbox. Una chiave di test non dà errori: segna le prenotazioni come pagate con denaro che non esiste.
- 2
Copia la chiave pubblicabile
In Standard keys, copia la Publishable key. Inizia con pk_live_.
- 3
Copia la chiave segreta
Copia la Secret key (fai clic su Reveal live key se è nascosta). Inizia con sk_live_. Tienila riservata: permette di addebitare carte a tuo nome.
Aggiungere il webhook in Stripe
Il tuo indirizzo webhook TourTask per Stripe Elements
https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking- 1
Crea una destinazione di eventi
Apri dashboard.stripe.com/webhooks, sempre in modalità live, e fai clic su Create an event destination.
- 2
Scegli il tuo account e Snapshot
Seleziona Your account e il formato di payload Snapshot: TourTask non sa leggere gli eventi Thin consigliati da Stripe.
- 3
Seleziona l’evento
Seleziona payment_intent.succeeded e nessun altro evento.
- 4
Scegli un endpoint webhook
Fai clic su Continue e seleziona Webhook endpoint come tipo di destinazione.
- 5
Inserisci l’indirizzo TourTask
Fai clic su Continue, incolla l’indirizzo TourTask qui sopra in Endpoint URL e fai clic su Create destination.
- 6
Copia il segreto di firma
Nella pagina della destinazione, fai clic su Reveal secret e copia il segreto di firma. Inizia con whsec_.
Aggiungere Stripe Elements in TourTask
- 1
Apri il riquadro di Stripe Elements
Vai su Configurazione → Opzioni di pagamento e fai clic sul riquadro Stripe Elements in Pagamenti online → Gateway di pagamento. Non c’è? Scegli Mostra tutti i gateway sotto i riquadri.
- 2
Scegli il paese e la valuta
In Paese scegli il paese del tuo account Stripe Elements e del relativo conto bancario, e in Valuta la valuta in cui pagano i viaggiatori. Fai clic su Aggiungi. Per cambiarli in seguito, rimuovi Stripe Elements con Rimuovi e aggiungilo di nuovo.
- 3
Inserisci le tue credenziali API
In Autenticazione, il riquadro ha un campo per ciascuna:
Chiave API
Chiave pubblicabile
Segreto del webhookOgni campo si salva quando fai clic fuori da esso.
- 4
Attiva Stripe Elements
Fai clic su Attiva quando tutti i campi sono compilati. Il riquadro passa a Attivo e i viaggiatori possono pagare con Stripe Elements sulla tua pagina di prenotazione. Ogni pagamento arriva direttamente sul tuo account Stripe Elements: TourTask non trattiene mai il tuo denaro.
Verificare che Stripe Elements funzioni
TourTask non ha una modalità di test per Stripe Elements, e i termini di Stripe vietano i pagamenti di prova con carte reali.
- 1
Apri il modulo della carta
Sulla tua pagina di prenotazione, prenota un tour e scegli di pagare con carta: compare il modulo della carta di Stripe. Chiudi la pagina senza pagare.
- 2
Annulla la prenotazione di prova
Apri la prenotazione in TourTask e fai clic su Annulla prenotazione.
- 3
Controlla il tuo primo pagamento
Quando un viaggiatore paga con carta, la prenotazione risulta pagata e il pagamento compare nella tua Dashboard Stripe.
- 4
Controlla il webhook
In Stripe, apri la scheda Event deliveries della destinazione: payment_intent.succeeded risulta Delivered.
Aggiungere Apple Pay e Google Pay
Apple Pay e Google Pay sono gateway a sé, da configurare come Stripe Elements con le stesse due chiavi. Ognuno ha bisogno del proprio endpoint webhook al proprio indirizzo, e il segreto di firma di quell’endpoint va nel suo Segreto del webhook.
Apple Pay
https://api.tourtask.com/v1/payments/apple-pay/notifications/bookingGoogle Pay
https://api.tourtask.com/v1/payments/google-pay/notifications/bookingDomande frequenti
No. La carta passa direttamente dal browser del viaggiatore a Stripe.
Stripe Elements tiene i viaggiatori sulla tua pagina di prenotazione; Stripe li manda alla pagina di Stripe e poi li riporta indietro. Puoi usarli entrambi.
Quelli attivati nelle impostazioni dei metodi di pagamento della tua Dashboard Stripe. Le carte sono attive per impostazione predefinita.
No. TourTask converte il totale della prenotazione nella valuta che hai scelto per il gateway.