Passa al contenuto principale

Stripe Payment Links

L'integrazione Selgeo più semplice — nessun codice backend richiesto. Lo snippet di tracciamento riscrive automaticamente i Stripe Payment Links sulla tua pagina per includere il click_id, e Selgeo lo legge dal webhook Stripe quando il cliente paga.

Versione API: v1

Come funziona​

Lo snippet rileva tutti i tag <a> che puntano a https://buy.stripe.com/... e aggiunge ?client_reference_id=CLICK_ID. Il flusso completo è automatico — devi solo:

  1. Installare lo snippet.
  2. Mettere Stripe Payment Links sulla tua pagina.
  3. Collegare Stripe a Selgeo.

Configurazione​

Passaggio 1: Installare lo snippet​

<script
  async
  src="https://cdn.selgeo.com/v1/selgeo.js"
  data-merchant="pk_test_YOUR_KEY"
></script>
<a href="https://buy.stripe.com/test_abc123">Abbonati al Piano Pro</a>
<a href="https://buy.stripe.com/test_def456">Abbonati al Piano Enterprise</a>

Passaggio 3: Collegare Stripe​

Nella dashboard Selgeo, vai su Impostazioni > Stripe e collega il tuo account Stripe.

Cosa riscrive lo snippet​

Prima:

https://buy.stripe.com/test_abc123

Dopo (quando è memorizzato un click_id):

https://buy.stripe.com/test_abc123?client_reference_id=f47ac10b-58cc-4372-a567-0e02b2c3d479

Protezione contro la sovrascrittura del commerciante​

Se imposti tu stesso client_reference_id su un Payment Link, lo snippet non sovrascriverà il tuo valore.

Test​

  1. Ottieni un link di tracciamento. I link di tracciamento vengono creati dai partner nel portale partner (nella sezione Link), non nella dashboard del merchant — per un test personale, accedi come partner di test e creane uno.
  2. Visita il tuo sito usando il link di tracciamento: https://il-tuo-sito.com/?ref=IL_TUO_REF
  3. Ispeziona il Payment Link — fai clic con il tasto destro sul link e seleziona «Ispeziona» o «Copia indirizzo link». Verifica che client_reference_id sia stato aggiunto.
  4. Fai clic sul Payment Link e completa l'acquisto con la carta di test Stripe 4242 4242 4242 4242.
  5. Controlla la dashboard — la conversione dovrebbe apparire in Analytics, attribuita al partner.

Modalità di debug​

Aggiungi data-debug al tag dello snippet per vedere l'attività di riscrittura nella console:

[selgeo] Stripe payment link rewritten https://buy.stripe.com/test_abc123?client_reference_id=f47ac10b-...

Limitazioni​

  • Vengono rilevati solo i link buy.stripe.com.
  • Il visitatore deve arrivare prima tramite un link di tracciamento.
  • Sessione limitata alla scheda. Il sessionStorage è specifico della scheda.

Passaggi successivi​