Vai al contenuto principale

Integrazione Stripe - Guida alla configurazione

Collega il tuo account Stripe a Goodweek per gestire pagamenti, clienti, abbonamenti, fatture e dati di fatturazione direttamente dal tuo spazio di lavoro AI.

A
Scritto da Antoine Stempien

Collega il tuo account Stripe a Goodweek per gestire pagamenti, clienti, abbonamenti, fatture e dati di fatturazione direttamente dal tuo spazio di lavoro AI.

ℹ️ Nota sulla governance

Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di Stripe, garantendo l'allineamento con le politiche di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare a seconda delle autorizzazioni specifiche e dell'accesso autenticato di ciascun utente.

📋 Prerequisiti

Prima che qualsiasi utente possa vedere e connettere l'integrazione Stripe, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Configurazione amministratore

L'integrazione Stripe utilizza OAuth 2.0 e non richiede alcuna approvazione a livello di amministratore all'interno di Stripe prima che gli utenti possano connettersi.

⚠️ Importante: Modalità live e di test

Stripe opera in due modalità: live e test. Al momento della connessione, assicurati di autorizzare dalla modalità corretta per l'uso previsto. Le azioni eseguite tramite Goodweek influenzeranno l'ambiente live di Stripe, a meno che tu non stia connettendo un account di test.

Connessione utente

  1. In Goodweek, vai su Integrazioni.

  2. Trova Stripe e fai clic su Connetti.

  3. Verrai reindirizzato a Stripe, dove ti verrà chiesto di accedere e autorizzare l'accesso.

  4. Fai clic su Connetti per concedere l'accesso e tornare a Goodweek.

Note importanti

  • Ogni utente deve connettere il proprio account Stripe individualmente.

  • Goodweek funzionerà nella modalità (live o test) dell'account che autorizzi.

  • Puoi revocare l'accesso di Goodweek in qualsiasi momento dalla Dashboard di Stripe → Impostazioni → Applicazioni connesse → Composio → Disconnetti.


Strumenti disponibili

Strumento

Descrizione

Tipo

Crea cliente

Crea un nuovo cliente in Stripe, necessario per creare addebiti o abbonamenti.

Scrittura

Recupera account

Recupera informazioni dettagliate per l'account Stripe autenticato.

Lettura

Crea intento di pagamento

Crea un PaymentIntent Stripe per avviare ed elaborare il pagamento di un cliente.

Scrittura

Conferma intento di pagamento

Conferma un PaymentIntent per finalizzare il pagamento con il metodo di pagamento fornito.

Lettura

Cattura intento di pagamento

Cattura i fondi da un PaymentIntent autorizzato quando si trova nello stato requires_capture.

Lettura

Recupera fattura

Recupera una fattura specifica tramite il suo ID.

Lettura

Crea fattura

Crea una nuova fattura Stripe in bozza per un cliente.

Scrittura

Crea elemento fattura

Aggiunge una voce a una fattura in bozza prima della finalizzazione.

Scrittura

Aggiungi righe alla fattura

Aggiunge più voci a una fattura Stripe in bozza esistente in un'unica chiamata.

Scrittura

Finalizza fattura

Finalizza una fattura in bozza rendendola aperta e pronta per l'incasso.

Lettura

Ottieni voci della fattura

Recupera un elenco paginato delle voci di una fattura specifica.

Lettura

Crea nota di credito

Emette una nota di credito per rettificare l'importo di una fattura finalizzata.

Scrittura

Anteprima nota di credito

Mostra un'anteprima di una nota di credito senza crearla in Stripe.

Lettura

Crea abbonamento cliente

Crea un nuovo abbonamento per un cliente Stripe esistente con elementi e prezzi.

Scrittura

Crea abbonamento

Crea un abbonamento altamente configurabile che supporta più elementi, periodi di prova e sconti.

Scrittura

Recupera abbonamento cliente

Recupera un abbonamento specifico per un cliente.

Lettura

Crea elemento abbonamento

Aggiunge un nuovo elemento a un abbonamento esistente senza modificare gli elementi esistenti.

Scrittura

Crea rimborso

Crea un rimborso totale o parziale in Stripe destinato a un addebito o un intento di pagamento.

Scrittura

Crea rimborso addebito

Crea un rimborso per un addebito creato in precedenza.

Scrittura

Crea coupon

Crea un nuovo coupon sconto con sconto percentuale o a importo fisso.

Scrittura

Crea codice promozionale

Crea un codice promozionale riscattabile dal cliente collegato a un coupon sottostante.

Scrittura

Crea prodotto

Crea un nuovo prodotto in Stripe per rappresentare un bene o un servizio.

Scrittura

Crea un prezzo

Crea un nuovo prezzo Stripe per un prodotto, definendone gli addebiti (una tantum o ricorrenti).

Scrittura

Crea sessione di pagamento

Crea una sessione Checkout Stripe per una pagina di pagamento o abbonamento ospitata.

Scrittura

Crea link di pagamento

Crea un URL di pagamento ospitato e condivisibile che può essere inviato direttamente ai clienti.

Scrittura

Crea intento di configurazione

Crea un SetupIntent per raccogliere le autorizzazioni del metodo di pagamento per un uso futuro.

Scrittura

Elenca eventi

Recupera un elenco di eventi Stripe degli ultimi 30 giorni con filtro e paginazione.

Lettura

Recupera evento

Recupera i dettagli di un evento webhook Stripe specifico tramite il suo ID.

Lettura

Crea esecuzione report

Crea e avvia l'esecuzione asincrona di un report finanziario Stripe.

Scrittura

Elenca misuratori di fatturazione

Recupera un elenco di misuratori di fatturazione configurati per la fatturazione basata sull'utilizzo.

Lettura

Crea misuratore di fatturazione

Crea un misuratore di fatturazione per tracciare gli eventi di utilizzo per la tariffazione a consumo.

Scrittura

Crea sessione del portale di fatturazione

Crea un URL di sessione del portale di fatturazione per consentire ai clienti di gestire i propri abbonamenti e fatture.

Scrittura

Crea calcolo imposte

Calcola le imposte per un acquisto del cliente prima di creare un ordine.

Scrittura

Crea trasferimento

Crea un trasferimento per spostare fondi tra account Stripe nell'ambito di Connect.

Scrittura

Annulla intento di pagamento

Annulla un PaymentIntent non più necessario.

⚠️ Distruttivo

Annulla abbonamento

Annulla l'abbonamento attivo di un cliente Stripe.

⚠️ Distruttivo

Elimina cliente

Elimina definitivamente un cliente e annulla i suoi abbonamenti attivi.

⚠️ Distruttivo

Elimina fattura in bozza

Elimina definitivamente una fattura in bozza. Questa azione non può essere annullata.

⚠️ Distruttivo

Annulla fattura

Contrassegna definitivamente una fattura finalizzata come annullata, impedendone l'incasso.

⚠️ Distruttivo

Elimina prodotto

Elimina un prodotto da Stripe. Possibile solo se non sono associati prezzi.

⚠️ Distruttivo

Casi d'uso

  • Crea fatture e incassa pagamenti dalle conversazioni. Redigi fatture Stripe, aggiungi voci, finalizzale e crea link di pagamento direttamente da Goodweek — utile per fatturare i clienti su richiesta senza navigare nella dashboard di Stripe.

  • Gestisci abbonamenti e clienti. Crea nuovi abbonamenti, aggiungi prodotti a quelli esistenti e recupera i dettagli di abbonamento per clienti specifici da Goodweek per gestire rapidamente le modifiche di fatturazione.

  • Emetti rimborsi e note di credito. Crea rimborsi per addebiti o intenti di pagamento ed emetti note di credito su fatture finalizzate da Goodweek quando gestisci controversie con i clienti o correzioni di fatturazione.

  • Monitora eventi e attività di fatturazione. Recupera gli eventi Stripe recenti e filtrali per tipo da Goodweek per indagare su problemi di pagamento, modifiche degli abbonamenti o attività dei webhook senza usare la dashboard di Stripe.


Risoluzione dei problemi

Le azioni influenzano l'ambiente Stripe sbagliato

Verifica di aver autorizzato Goodweek con l'account Stripe corretto (live o di test). Disconnetti e riconnetti se necessario, assicurandoti di selezionare l'account corretto durante il flusso di autorizzazione di Stripe.

Integrazione non visibile in Goodweek

Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione Stripe dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.

Riferimenti

Hai ricevuto la risposta alla tua domanda?