Loading...

Stripe

Pagamenti, abbonamenti, fatture e clienti dal tuo account Stripe.

Il connettore Stripe porta nel foglio pagamenti, transazioni di bilancio, rimborsi, contestazioni, versamenti, clienti, abbonamenti e fatture del tuo account Stripe.

Autenticazione diversa dagli altri connettori: non usa un login OAuth, ma una restricted key in sola lettura creata dalla tua Dashboard Stripe (Developers > API keys > Create restricted key). Durante la connessione scegli anche un nome per la connessione, utile per distinguere più account Stripe collegati; la modalità (Test o Live, in base al prefisso rk_test_/rk_live_ della chiave) resta sempre visibile tra parentesi accanto al nome.

Una sola categoria per report: Payments, Balance Transactions, Refunds, Disputes, Payouts, Customers, Subscriptions e Invoices sono otto fonti dati distinte, non combinabili tra loro nello stesso report (un tentativo di mischiarle restituisce un errore esplicito invece di un risultato sbagliato). La categoria è indicata tra parentesi per ciascuna voce qui sotto.

Permessi richiesti

  • Balance: Read : Obbligatorio: usato anche per validare la chiave al momento della connessione.
  • Charges: Read : Necessario per la categoria Payments.
  • Customers: Read : Necessario per la categoria Customers.
  • Billing: Read : Necessario per le categorie Subscriptions e Invoices.
  • Payment Intents: Read : Necessario per la categoria Refunds.
  • Payment Disputes: Read : Necessario per la categoria Disputes.
  • Payouts: Read : Necessario per la categoria Payouts.

Metriche disponibili

Metrica Periodo Aggregazione Note
Numero (Payments)
Importo (Payments)
Importo incassato (Payments)
Importo rimborsato (Payments)
Valore medio (Payments)
Numero (Balance Transactions)
Lordo (Balance Transactions)
Commissioni (Balance Transactions)
Netto (Balance Transactions)
Numero (Refunds)
Importo (Refunds)
Numero (Disputes)
Importo (Disputes)
Numero (Payouts)
Importo (Payouts)
Numero (Customers)
Nuovi clienti (Customers)
Numero (Subscriptions)
Nuovi (Subscriptions)
Cancellati (Subscriptions)
Quantita' (Subscriptions)
MRR (Subscriptions)
Tasso di abbandono - per numero, solo totale (Subscriptions)
Tasso di abbandono - per MRR, solo totale (Subscriptions)
Numero (Invoices)
Totale (Invoices)
Subtotale (Invoices)
Tasse (Invoices)
Importo dovuto (Invoices)
Importo pagato (Invoices)
Importo residuo (Invoices)

Dimensioni disponibili

Dimensione Note
Data (Payments)
Stato (Payments)
Valuta (Payments)
Metodo di pagamento / circuito carta (Payments)
Paese carta (Payments)
Paese di fatturazione (Payments)
Codice fallimento (Payments)
Motivo fallimento (Payments)
Livello di rischio (Payments)
Cliente (Payments)
Descrizione (Payments)
Data (Balance Transactions)
Data disponibilita' (Balance Transactions)
Tipo (Balance Transactions)
Categoria contabile (Balance Transactions)
Valuta (Balance Transactions)
Stato (Balance Transactions)
Data (Refunds)
Motivo (Refunds)
Stato (Refunds)
Valuta (Refunds)
Data (Disputes)
Motivo (Disputes)
Stato (Disputes)
Valuta (Disputes)
Data di arrivo (Payouts)
Stato (Payouts)
Metodo (Payouts)
Valuta (Payouts)
Data di creazione (Customers)
Paese (Customers)
Valuta (Customers)
Insolvenza (Customers)
Email (Customers)
Stato (Subscriptions)
Data di creazione (Subscriptions)
Data cancellazione (Subscriptions)
Cancellazione a fine periodo (Subscriptions)
Prodotto (Subscriptions)
Prezzo (Subscriptions)
Intervallo di fatturazione (Subscriptions)
Modalita' di incasso (Subscriptions)
Data (Invoices)
Stato (Invoices)
Motivo di emissione (Invoices)
Valuta (Invoices)
Inizio periodo (Invoices)
Fine periodo (Invoices)

Limiti noti

  • Righe massime per report
    Fino a 2.500 righe per categoria (5.000 per Subscriptions, per includere anche abbonamenti aperti prima del periodo del report ma ancora attivi, necessario per calcolare MRR e Churn correttamente).
  • Permesso mancante su una categoria
    Se la restricted key non ha il permesso di lettura necessario per la categoria scelta, il report fallisce con un errore che indica esattamente quale permesso manca - le altre categorie restano comunque utilizzabili con la stessa chiave.
  • Motivo rimborso spesso vuoto
    Il campo "Motivo" (Refunds/Disputes) è vuoto quando il rimborso è stato creato senza selezionare esplicitamente un motivo (es. da Dashboard senza usare il menu a tendina): è un dato reale mancante lato Stripe, non un errore del connettore.

Tempi di esecuzione

MRR e Churn (categoria Subscriptions) sono calcolati da noi, Stripe non li espone direttamente: il MRR normalizza su base mensile qualunque intervallo di fatturazione (annuale, settimanale, ecc.), esclude di default gli abbonamenti in prova gratuita (trialing) e gli sconti a importo fisso (solo quelli percentuali riducono il MRR). Il Churn (sia per numero di abbonamenti che per MRR perso) è un rapporto calcolato sull'intero report, non ha senso riga per riga.

Importi e valute: convertiti automaticamente dall'unità minima usata da Stripe (es. centesimi) in base alla valuta, incluse le valute senza decimali (es. JPY) e quelle a tre decimali (es. BHD). La valuta non viene mai sommata tra connessioni/valute diverse.

Date: mostrate nel fuso orario del foglio Google, non in UTC.