- Credenziali API
- Chiave API
- Segreto del webhook
Configura Stripe perché i viaggiatori paghino con carta sulla pagina di pagamento di Stripe e tornino a una prenotazione pagata. Ti serve un conto bancario in uno dei paesi elencati sopra.
Creare il tuo account Stripe
- 1
Registrati su Stripe
Crea l’account su dashboard.stripe.com/register. Scegli con cura il paese dell’attività: Stripe non può cambiarlo una volta che l’account è attivo.
- 2
Verifica la tua attività
Completa la richiesta su dashboard.stripe.com/account/onboarding: la tua attività, le persone che la gestiscono e il conto bancario per i tuoi accrediti. I pagamenti reali si sbloccano dopo che Stripe ti ha verificato.
Copiare la chiave segreta di Stripe
- 1
Apri le tue chiavi API
Vai su dashboard.stripe.com/apikeys e passa dalla sandbox alla modalità live.
- 2
Copia la chiave segreta
In Standard keys, fai clic su Reveal live key e copia la Secret key: inizia con sk_live_. Tienila riservata: chiunque la possieda può incassare e rimborsare pagamenti a tuo nome.
Aggiungere il webhook TourTask in Stripe
Il webhook informa TourTask di ogni pagamento, anche quando il denaro viene accreditato giorni dopo o il viaggiatore non torna più.
Il tuo indirizzo webhook TourTask per Stripe
https://api.tourtask.com/v1/payments/stripe/notifications/booking- 1
Crea una destinazione di eventi
Vai su dashboard.stripe.com/webhooks 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. Lascia la versione dell’API com’è.
- 3
Seleziona i due eventi
Spunta checkout.session.completed e checkout.session.async_payment_succeeded, e nient’altro.
- 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 come Endpoint URL e crea la destinazione.
- 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 in TourTask
- 1
Apri il riquadro di Stripe
Vai su Configurazione → Opzioni di pagamento e fai clic sul riquadro Stripe 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 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 con Rimuovi e aggiungilo di nuovo.
- 3
Inserisci le tue credenziali API
In Autenticazione, il riquadro ha un campo per ciascuna:
Chiave API
Segreto del webhookOgni campo si salva quando fai clic fuori da esso.
- 4
Attiva Stripe
Fai clic su Attiva quando tutti i campi sono compilati. Il riquadro passa a Attivo e i viaggiatori possono pagare con Stripe sulla tua pagina di prenotazione. Ogni pagamento arriva direttamente sul tuo account Stripe: TourTask non trattiene mai il tuo denaro.
Per aggiungere un supplemento o riordinare i tuoi metodi di pagamento, vedi pagamenti online.
Verificare che Stripe funzioni
TourTask non ha una modalità di test per Stripe, e i termini di Stripe vietano i pagamenti di prova con carte reali.
- 1
Apri la pagina di pagamento di Stripe
Sulla tua pagina di prenotazione, prenota un tour e scegli Stripe. Si apre la pagina di pagamento di Stripe: chiudila 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 Stripe, 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: checkout.session.completed risulta Delivered. Se non è andato a buon fine, controlla l’URL dell’endpoint, il formato Snapshot e il Segreto del webhook.
Domande frequenti
Quelli attivati nelle impostazioni dei metodi di pagamento della tua Dashboard Stripe. Un metodo che si conclude più tardi, come un addebito bancario, segna la prenotazione come pagata solo quando arriva il denaro.
No. TourTask converte il totale della prenotazione nella valuta che hai scelto per il gateway.
No. I pagamenti arrivano sul tuo account Stripe, e Stripe li versa alla tua banca.