Registra vendite e rimborsi Gumroad e Payhip in Google Sheets

Centralizza in Google Sheets gli ordini Gumroad e Payhip, aggiornando le vendite in caso di rimborsi Payhip senza creare duplicati.

· a cura di Bernardo Mannelli · template originale di zecro su n8n.io

Google Sheets

In breve

  • Ideale per: chi vende prodotti digitali su Gumroad e Payhip e vuole un registro unico degli ordini.
  • Cosa serve: account Gumroad e/o Payhip, Google Sheets e un’istanza n8n raggiungibile pubblicamente.
  • Attenzione: prepara seller ID e hash della API key Payhip e verifica intestazioni del foglio e URL dei webhook.

Questo workflow raccoglie in un unico foglio Google Sheets i dati degli ordini ricevuti tramite Gumroad e Payhip. I webhook ricevono gli eventi delle due piattaforme; il workflow verifica le richieste e normalizza i dati in un formato comune. Le righe vengono aggiunte o aggiornate usando l’ID dell’ordine, così un nuovo invio dello stesso webhook non crea duplicati e un rimborso Payhip aggiorna la vendita originale.

A cosa serve

È pensato per chi vende prodotti digitali su Gumroad e Payhip e vuole consultare le vendite in un registro unico, invece di gestire esportazioni CSV separate. Nel foglio si possono raccogliere ID dell’ordine, piattaforma, stato, data, prodotto, quantità, valuta, importo lordo, commissioni, netto ed email dell’acquirente.

Il foglio centralizza le informazioni, ma non sostituisce gli strumenti di vendita delle piattaforme. La vista dipende anche dalle colonne e dalle intestazioni predisposte nel foglio Google Sheets.

Come funziona

Due webhook ricevono gli eventi: Gumroad invia il proprio evento Ping, mentre Payhip invia gli eventi di pagamento e rimborso. Prima di elaborare i dati, il workflow controlla che le richieste siano valide. Per Gumroad usa il seller ID; per Payhip verifica la firma, calcolata con SHA-256 della API key. Le richieste che non superano i controlli vengono ignorate.

Dopo la verifica, i dati delle due piattaforme sono ricondotti allo stesso schema. Google Sheets riceve quindi le informazioni sull’ordine in colonne coerenti. Il workflow usa l’ID dell’ordine per aggiungere una riga o aggiornare quella esistente: in questo modo i tentativi ripetuti di consegna del webhook non producono righe duplicate e i rimborsi Payhip aggiornano la vendita originale. Le commissioni Payhip vengono incluse nel calcolo del netto.

Cosa ti serve

Servono un account Gumroad e/o Payhip, un account Google con accesso a Google Sheets e un’istanza n8n raggiungibile pubblicamente. Per collegare Google Sheets occorrono le credenziali del servizio. Nel workflow vanno inseriti il seller ID Gumroad e l’hash SHA-256 della API key Payhip nei rispettivi controlli; se usi entrambe le piattaforme, prepara entrambi i valori.

Crea un foglio con una scheda chiamata “Sales” e la riga di intestazione prevista dalla nota principale del workflow. Dopo aver collegato Google Sheets, inserisci l’URL del foglio. Prima di attivare l’automazione, controlla che scheda, intestazioni e dati attesi siano coerenti con il foglio che vuoi usare.

Come importarlo e configurarlo

Puoi importare il workflow dalla sua pagina su n8n.io scegliendo “Use for free”, oppure copiare il JSON e incollarlo in un nuovo workflow n8n. Dopo l’importazione, configura le credenziali per i nodi che si collegano a servizi esterni: in questo caso Google Sheets. Inserisci inoltre il seller ID e l’hash richiesto nei controlli previsti, e incolla l’URL del foglio.

Quando la configurazione è pronta, pubblica il workflow. Copia gli URL di produzione dei webhook e inseriscili nelle impostazioni di Gumroad, in Settings > Advanced > Ping, e di Payhip, in Settings > Developer > Webhooks. Verifica che gli URL configurati corrispondano a quelli di produzione e che l’istanza n8n sia raggiungibile dall’esterno.

Personalizzazioni e limiti

Se vuoi registrare altri campi, il workflow prevede la possibilità di aggiungere colonne modificando i due nodi Code che normalizzano i dati. In tal caso controlla che le nuove colonne siano presenti nella scheda “Sales” e che la mappatura dei dati corrisponda alle intestazioni. Anche il formato del foglio va verificato prima dell’uso: non dare per scontato che un foglio esistente abbia le colonne richieste.

Il flusso dipende dalla corretta consegna degli eventi ai webhook e dalla configurazione dei controlli di autenticità. Un ID o un hash inserito in modo errato può far ignorare le richieste. L’automazione è quindi adatta a chi può configurare gli account e verificare il foglio e i webhook dopo l’importazione.

n8n Cloud o self-hosted

Il workflow usa nodi nativi di n8n, quindi può essere eseguito sia su n8n Cloud sia su un’installazione self-hosted. In entrambi i casi, l’istanza deve essere raggiungibile pubblicamente perché Gumroad e Payhip possano inviare gli eventi ai webhook.

Le app usate in questa automazione

Per far funzionare il template ti serve un account su queste app.

I link «Prova» sono link di affiliazione: se ti abboni, possiamo ricevere una commissione senza costi aggiuntivi per te.

Vuoi provarla? Il template si importa in n8n con un clic.

Usalo su n8n(si apre in una nuova scheda)