Stripe Sync Subscriptions: abbonamenti e documenti

Dipendenza dal gateway Stripe

Il modulo riutilizza chiave pubblica, chiave privata e signing secret configurati nel Gateway di pagamento Stripe. Le impostazioni mostrano valori mascherati e lo stesso endpoint webhook; se una delle tre chiavi manca, completare prima il gateway.

Test e produzione non devono essere mescolati. Controllare prefissi delle chiavi, account Stripe e endpoint prima di sincronizzare.

Webhook e eventi

Gli eventi degli abbonamenti arrivano al webhook Stripe già registrato per il gateway. Il signing secret serve a verificare la firma; una risposta HTTP non valida o un secret errato impediscono l’elaborazione.

Controllare nella dashboard Stripe consegna, tentativi, tipo evento e risposta. Non creare documenti manuali per compensare un webhook non funzionante senza prima evitare duplicazioni.

Creazione automatica documenti

L’opzione può essere attivata e il tipo scelto fra fattura, ricevuta e proforma. La funzione crea un documento soltanto quando Stripe comunica una fattura generata da un abbonamento sincronizzato; pagamenti Stripe normali e altri eventi non producono documenti tramite questo modulo.

Prima di attivare definire numerazione, imposte, anagrafica, valuta e riconciliazione. Verificare il primo ciclo su dati test e controllare che lo stesso evento non sia già stato archiviato.

Sincronizzazione manuale

Sincronizza abbonamenti scorre tutte le pagine Stripe, crea i record assenti e aggiorna quelli esistenti per ID abbonamento. Il log registra processati, creati, aggiornati o errore.

L’azione interroga davvero Stripe. Avviarla con l’account corretto, attendere il completamento e non ripeterla durante un timeout senza controllare elenco e log.

Associazione e creazione cliente

Il modulo usa Stripe Customer ID ed e-mail per risolvere il cliente. Se necessario può creare un’anagrafica CRM dai dati Stripe, conservando il riferimento al customer remoto. Prima dell’uso massivo eliminare duplicati e assicurarsi che e-mail e ragione sociale siano affidabili.

Un cliente creato dalla sincronizzazione può richiedere completamento di dati fiscali e indirizzo prima della fatturazione valida.

Elenco e stati

La tabella mostra Subscription ID, collegamento Stripe, cliente, Customer ID, importo/valuta, stato, inizio/fine periodo e data importazione. I filtri cercano ID e stato; il collegamento apre l’abbonamento nell’ambiente Stripe configurato.

Attivo, annullato, scaduto/past_due e incompleto descrivono lo stato remoto, non automaticamente quello del servizio ISP Billing. Riconciliare sospensione, cessazione e recupero credito con il processo commerciale.

Checklist

• Configurare prima il gateway Stripe
• Non mescolare test e produzione
• Registrare e verificare il webhook
• Scegliere consapevolmente il tipo documento
• Controllare fiscalità e numerazione
• Deduplicare i clienti
• Avviare una sincronizzazione alla volta
• Leggere contatori e log
• Confrontare stato remoto e servizio
• Controllare il primo documento generato
• Evitare creazioni manuali duplicate