Invia fatture utilizzando Stripe

Come funziona questa estensione

Utilizza questa estensione per creare e inviare fatture cliente personalizzabili utilizzando la piattaforma di pagamenti Stripe .

Le fatture vengono personalizzate automaticamente con il logo e il tema del colore della tua attività che hai impostato in Stripe. Dopo che la fattura è stata inviata, puoi utilizzare la dashboard di Stripe per monitorare se il cliente ha pagato e quanti soldi hai elaborato con report e grafici dettagliati.

Questa estensione ascolta la raccolta Cloud Firestore specificata per i nuovi documenti (come nell'esempio di seguito). Quando aggiungi un documento, Stripe utilizza le informazioni sulla fattura nel documento per creare una fattura nel proprio sistema, quindi invia la fattura all'indirizzo e-mail specificato nel documento. Facoltativamente, puoi gestire gli indirizzi email dei tuoi clienti utilizzando gli ID utente di Firebase Authentication .

email: "customer@example.com",
items: [{
    amount: 2000,
    currency: "usd",
    quantity: 2, // Optional, defaults to 1.
    description: "Growth plan"
}]

Ecco un esempio di come apparirà la tua fattura personalizzata!

Una funzionalità opzionale di questa estensione è aggiornare automaticamente lo stato della fattura nel documento Cloud Firestore. È possibile configurare questa funzione dopo aver installato l'estensione registrando un webhook Stripe che ascolta gli eventi di fatturazione Stripe . Se si desidera utilizzare questa funzione opzionale, lasciare vuoto il parametro Stripe webhook secret durante l'installazione, quindi riconfigurare l'estensione installata in un secondo momento con il valore effettivo per il webhook registrato. Ulteriori dettagli su questo processo vengono forniti dopo l'installazione.

Configurazione aggiuntiva

Prima di installare questa estensione, configura i seguenti servizi Firebase nel tuo progetto Firebase:

• Cloud Firestore per archiviare le informazioni sulla fattura e, facoltativamente, lo stato della fattura.
  • Segui i passaggi nella documentazione per creare un database Cloud Firestore.
• Firebase Authentication per gestire facoltativamente e-mail e dati dei clienti.
  • Abilita i metodi di accesso nella console Firebase che desideri offrire ai tuoi utenti.

È inoltre necessario disporre di un account Stripe e di una chiave API Stripe prima di installare questa estensione.

Nota: Stripe ha una modalità di test che ti consente di effettuare chiamate API senza effettuare pagamenti effettivi. Per utilizzare questa estensione con la modalità di test di Stripe, impostare il parametro della Stripe API key dell'estensione (durante la configurazione dell'estensione) per utilizzare una chiave della modalità di test. Una chiave in modalità test è simile a rk_test_12345 , mentre una chiave in modalità live sarebbe rk_live_12345 . Poiché questa estensione richiede solo l'accesso in scrittura ai tuoi customers Stripe e alle risorse di invoices , ti consigliamo di creare una chiave con accesso limitato solo a queste risorse anziché utilizzare la tua chiave segreta.

Fatturazione

Questa estensione utilizza i seguenti servizi Firebase che potrebbero avere costi associati:

• Cloud Firestore
• Cloud Functions
• Firebase Authentication (opzionale)

Questa estensione utilizza anche i seguenti servizi di terze parti:

• Stripe Billing ( informazioni sui prezzi )

Sei responsabile per qualsiasi costo associato al tuo utilizzo di questi servizi.

Nota di Firebase

Per installare questa estensione, il tuo progetto Firebase deve essere sul piano Blaze (pay-as-you-go). Ti verranno addebitate solo le risorse che utilizzi. La maggior parte dei servizi Firebase offre un livello gratuito per un utilizzo a basso volume. Ulteriori informazioni sulla fatturazione Firebase.

A partire dal 17 agosto 2020, ti verrà fatturato un piccolo importo (in genere inferiore a $ 0,10) quando installi o riconfiguri questa estensione. Consulta le domande frequenti sulla fatturazione di Cloud Functions per Firebase per una spiegazione dettagliata.