Order Invoicer
Stripe

Configurare Stripe

Crei una chiave con restrizioni Stripe e colleghi i suoi pagamenti a Order Invoicer

Prerequisiti

Prima di iniziare, si assicuri che:

  • Disponga di un account Stripe attivo (modalità test o live)
  • Disponga dell'accesso di amministratore alla dashboard Stripe
  • Il suo account Stripe abbia accettato i Termini di servizio Stripe (altrimenti i Payment Links non sono abilitati)

Order Invoicer utilizza una chiave API con restrizioni (prefisso rk_test_ o rk_live_). Non è richiesta alcuna installazione di app Stripe Connect: lei mantiene il pieno controllo della chiave e può revocarla in qualsiasi momento dalla sua dashboard Stripe.

Creare una chiave con restrizioni

Vada alle chiavi API di Stripe

  1. Acceda a dashboard.stripe.com
  2. Selezioni l'account (o sandbox) da collegare
  3. Vada su Developers > API keys
  4. Scorra fino a Restricted keys e clicchi su + Create restricted key

Assegni un nome alla chiave

Utilizzi un nome descrittivo, ad esempio Order Invoicer — Payment Links. Il nome è visibile solo nella sua dashboard Stripe; le sarà utile per ritrovare la chiave nel caso in cui dovesse revocarla.

Attivi i permessi richiesti

Order Invoicer necessita dei seguenti permessi per sincronizzare i Payment Links e creare le fatture corrispondenti:

Read

  • ✅ Account (per identificare il suo account Stripe alla connessione)
  • ✅ Balance Transactions
  • ✅ Charges
  • ✅ Checkout Sessions
  • ✅ Customers
  • ✅ Payment Intents
  • ✅ Payment Links
  • ✅ Payouts
  • ✅ Products

Write

  • ✅ Webhook Endpoints (Order Invoicer crea automaticamente il webhook alla connessione)

Tutti questi permessi sono obbligatori. Se ne manca uno, Order Invoicer rifiuterà la chiave con un messaggio che indica il permesso mancante: sarà sufficiente aggiungerlo e riprovare.

Generi e copi la chiave

  1. Clicchi su Create key
  2. Stripe mostra la chiave una sola volta: la copi immediatamente
  3. Inizia con rk_live_ (modalità produzione) o rk_test_ (modalità test)

La chiave non è più visibile dopo la chiusura della finestra. Se la perde, ne crei una nuova e revochi la vecchia.

Inserisca la chiave in Order Invoicer

  1. In Order Invoicer, selezioni Stripe come piattaforma e-commerce
  2. Incolli la chiave con restrizioni nel campo Restricted API key
  3. Clicchi su Avanti

Order Invoicer procederà a:

  • Verificare la chiave leggendo le informazioni del suo account Stripe
  • Registrare automaticamente un webhook sul suo account Stripe (per ricevere gli eventi checkout.session.completed, checkout.session.async_payment_succeeded e charge.refunded)
  • Avviare una prima sincronizzazione dei suoi Payment Links esistenti

Risoluzione dei problemi

"La chiave non è riconosciuta" / Credenziali non valide

  • Verifichi che la chiave inizi effettivamente con rk_test_ o rk_live_ (le chiavi publishable pk_… e le chiavi secret sk_… non funzionano per questo flusso)
  • Si assicuri di aver copiato la chiave completa, senza spazi iniziali o finali
  • Verifichi che la chiave non sia stata revocata dalla dashboard Stripe

"Restricted key is missing the 'Account: Read' permission"

La chiave è stata creata senza il permesso Account → Read. Stripe non lo include per impostazione predefinita, quindi deve essere aggiunto esplicitamente:

  1. Torni su Developers > API keys su Stripe
  2. Clicchi su Edit accanto alla sua chiave con restrizioni
  3. Attivi Account: Read
  4. Salvi e riprovi la connessione in Order Invoicer

"Failed to create Stripe webhook endpoint"

La chiave non dispone del permesso per scrivere webhook. Modifichi la chiave e attivi Webhook Endpoints: Write, quindi riprovi.

Testare la chiave manualmente

Può verificare che una chiave con restrizioni funzioni tramite cURL:

curl https://api.stripe.com/v1/account \
  -u "rk_test_votre_cle:"

Una risposta JSON che descrive il suo account (con "id": "acct_...") conferma che la chiave è valida e dispone del permesso Account: Read.

Sicurezza

  • La chiave con restrizioni viene memorizzata in forma cifrata lato Order Invoicer
  • Può revocarla in qualsiasi momento da Developers > API keys su Stripe: la connessione verrà interrotta immediatamente
  • Order Invoicer non esegue alcuna operazione di scrittura sul suo account Stripe, a parte la creazione iniziale del webhook

Assistenza

Se incontra difficoltà:

  1. Consulti la sezione sulla risoluzione dei problemi qui sopra
  2. Verifichi lo stato di Stripe su status.stripe.com
  3. Contatti la nostra assistenza: contact@orderinvoicer.com

Configurare Squarespace

Crei una chiave API Squarespace per collegare Order Invoicer

Installare Sylius

Configuri Sylius per l'integrazione con Order Invoicer

In questa pagina

PrerequisitiCreare una chiave con restrizioniVada alle chiavi API di StripeAssegni un nome alla chiaveAttivi i permessi richiestiGeneri e copi la chiaveInserisca la chiave in Order InvoicerRisoluzione dei problemi"La chiave non è riconosciuta" / Credenziali non valide"Restricted key is missing the 'Account: Read' permission""Failed to create Stripe webhook endpoint"Testare la chiave manualmenteSicurezzaAssistenza