Pagamenti (Stripe)

Genera link di pagamento sui preventivi usando il tuo account Stripe personale (modello BYO).

L'integrazione Pagamenti usa IL TUO account Stripe (modello BYO: porti il tuo account personale). I pagamenti vanno direttamente nel tuo account Stripe: non c'è costo, margine o intermediazione da parte nostra. Ci limitiamo a collegare i campi e il pulsante per generare il link.

L'integrazione parte inerte: nulla accade finché non incolli la tua chiave e attivi. Le chiavi sono memorizzate cifrate nel CRM e non vengono mai mostrate di nuovo.

Prerequisiti

• Un account Stripe attivo (per addebitare per davvero, l'account deve essere abilitato ai pagamenti nel tuo paese).
• Accesso alla Dashboard Stripe con permesso di visualizzare le chiavi API (Developers → API keys) e creare webhook (Developers → Webhooks).
• In Sellio, accesso come amministratore per salvare le chiavi e attivare l'integrazione in Impostazioni → Integrazioni.

Cosa devi incollare

• Chiave segreta: nella Dashboard Stripe, sotto Developers → API keys (inizia con sk_live_ in produzione o sk_test_ in test).
• Webhook signing secret (opzionale all'inizio): generato quando crei il webhook in Stripe (inizia con whsec_). È ciò che permette di confermare automaticamente i pagamenti.

Come configurare

1. Apri Impostazioni → Integrazioni e trova il riquadro "Pagamenti (Stripe)".
2. Incolla la tua chiave segreta Stripe e clicca "Salva chiavi".
3. Copia l'"URL webhook Stripe" che appare e, nella Dashboard Stripe (Developers → Webhooks), crea un endpoint per quell'URL con gli eventi checkout.session.completed e payment_intent.succeeded.
4. Torna al CRM, incolla il webhook signing secret (whsec_...) insieme alla chiave segreta e salva di nuovo.
5. Clicca "Attiva".

Come generare un link di pagamento

1. Apri un'opportunità e vai alla sezione Preventivi.
2. Sulla versione desiderata, clicca "Link di pagamento": il CRM crea un link in Stripe con l'importo totale del preventivo e lo copia negli appunti.
3. Invia il link al cliente. Quando paga, Stripe notifica il CRM tramite webhook e il pagamento appare come "Pagato" sul preventivo.

Tratta l'URL del webhook come segreto e incolla sempre entrambe le chiavi insieme quando le cambi (per sicurezza, il CRM non mostra di nuovo le chiavi salvate).

Come testare

1. Usa le chiavi di TEST (sk_test_.../whsec_ della modalità test) per non addebitare per davvero.
2. Genera un "Link di pagamento" su un preventivo e aprilo: dovresti atterrare sul checkout Stripe con l'importo totale del preventivo.
3. Paga con una carta di test Stripe (es., 4242 4242 4242 4242). Conferma che il preventivo diventi "Pagato" e sia segnato come accettato, segno che il webhook è arrivato e la firma è stata verificata.
4. Nella Dashboard Stripe (Developers → Webhooks → il tuo endpoint), consulta la cronologia degli eventi consegnati e lo stato 200.

Risoluzione problemi

• Errore nella generazione del link / 401 su Stripe: la chiave segreta è sbagliata o di un'altra modalità (hai incollato quella di test ma sei in produzione, o viceversa). Reincolla la sk_ corretta.
• Il cliente paga ma il preventivo non diventa "Pagato": il webhook non sta confermando. Verifica di aver creato l'endpoint in Stripe puntando all'"URL webhook Stripe" con gli eventi checkout.session.completed e payment_intent.succeeded.
• Firma non valida sul webhook: il webhook signing secret (whsec_...) nel CRM non corrisponde a quello dell'endpoint in Stripe. Copia il secret dell'endpoint e incollalo INSIEME alla chiave segreta (salva entrambe insieme).
• 404 sull'URL del webhook: l'integrazione non è attivata o il token dell'URL è cambiato. Riattiva e ricopia l'URL su Stripe.
• Non succede nulla quando generi il link: l'integrazione è inerte per mancanza di una chiave. Incolla prima la chiave segreta e attiva.

Apri questo articolo dentro il sistema →