Stripe Elements

Come accettare pagamenti con carta tramite Stripe Elements

Accetta pagamenti con carta sulla tua pagina di prenotazione con Stripe Elements.

Paesi

  • Australia
  • Austria
  • Belgio
  • Brasile
  • Bulgaria

Valute

  • AED
  • AFN
  • ALL
  • AMD
  • ANG
  • AOA
  • ARS
DocumentazioneContatti
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. 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. 2

    Copia la chiave pubblicabile

    In Standard keys, copia la Publishable key. Inizia con pk_live_.

  3. 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 webhook segna le prenotazioni come pagate

Senza di esso, ai viaggiatori viene addebitato il pagamento e le loro prenotazioni restano non confermate.

Il tuo indirizzo webhook TourTask per Stripe Elements

https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking
  1. 1

    Crea una destinazione di eventi

    Apri dashboard.stripe.com/webhooks, sempre in modalità live, e fai clic su Create an event destination.

  2. 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. 3

    Seleziona l’evento

    Seleziona payment_intent.succeeded e nessun altro evento.

  4. 4

    Scegli un endpoint webhook

    Fai clic su Continue e seleziona Webhook endpoint come tipo di destinazione.

  5. 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. 6

    Copia il segreto di firma

    Nella pagina della destinazione, fai clic su Reveal secret e copia il segreto di firma. Inizia con whsec_.

Un endpoint per ogni gateway

Hai già un endpoint per il gateway Stripe? Aggiungine comunque uno nuovo: ogni gateway ha bisogno del suo.

Aggiungere Stripe Elements in TourTask


  1. 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. 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. 3

    Inserisci le tue credenziali API

    In Autenticazione, il riquadro ha un campo per ciascuna:
    Chiave API
    Chiave pubblicabile
    Segreto del webhook

    Ogni campo si salva quando fai clic fuori da esso.

  4. 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.

Chiave API: la tua chiave segreta sk_live_…
Chiave pubblicabile: la tua chiave pk_live_…
Segreto del webhook: il tuo segreto di firma whsec_…

Aprilo per impostazione predefinita (facoltativo)

Fai clic su Aperto per impostazione predefinita nel riquadro per mostrare il modulo della carta già aperto in cima alla tua pagina di prenotazione.

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. 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. 2

    Annulla la prenotazione di prova

    Apri la prenotazione in TourTask e fai clic su Annulla prenotazione.

  3. 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. 4

    Controlla il webhook

    In Stripe, apri la scheda Event deliveries della destinazione: payment_intent.succeeded risulta Delivered.

Addebitato, ma non pagato in TourTask?

Controlla il webhook in Stripe: modalità live, formato Snapshot, l’evento payment_intent.succeeded e l’indirizzo esatto. In TourTask, Segreto del webhook deve contenere il segreto di firma di questo endpoint. In Stripe, la scheda Event deliveries della destinazione mostra ogni tentativo non riuscito.

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/booking

Google Pay

https://api.tourtask.com/v1/payments/google-pay/notifications/booking
Registra i tuoi indirizzi web in Stripe

A differenza del modulo della carta, i pulsanti dei wallet compaiono solo sugli indirizzi registrati in Stripe in Settings → Payment method domains. Registra ogni indirizzo su cui prenotano i viaggiatori: il tuo sito web, tuaazienda.tourtask.com e il tuo sito web TourTask (tuaazienda.tourtask.site o il suo dominio). example.com e www.example.com contano come due voci.

Domande 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.

Questa pagina ti è stata utile?