Pagamenti online, passo passo

Per il tecnico che installa EventPrint Studio: collegare il conto Stripe del negozio e accendere carta, Apple Pay, Google Pay, PayPal, Satispay e Revolut Pay. Una ventina di minuti la prima volta.

In breve

Su Stripe crei una chiave con restrizioni con due soli permessi.
In Studio la incolli e premi Collega.
Accendi i canali e li verifichi con un pagamento di prova da 1 €.
Quando funziona tutto, rifai il punto 1 in modalità live per incassare davvero.

Di chi è il conto. Il conto Stripe è del negozio, intestato a lui, col suo IBAN: i soldi arrivano a lui. Stripe trattiene la sua commissione su ogni pagamento; EventPrint niente.

Parte 1 — Su Stripe: la chiave

1Entra nel conto Stripe del negozio

Se il negozio non ce l'ha, si crea su dashboard.stripe.com/register. Per provare non serve completare l'attivazione (azienda, IBAN, documento): la modalità di prova (sandbox) c'è subito. Per incassare sì.

2Apri la pagina delle chiavi (non cercarla nel menu)

Nel menu a sinistra della Dashboard la voce « Sviluppatori » non si vede. Vai direttamente a:

https://dashboard.stripe.com/test/apikeys per provare

https://dashboard.stripe.com/apikeys per incassare (modalità live)

In alternativa scrivi « chiavi API » nella ricerca in cima alla Dashboard.

Il menu della Dashboard Stripe: Pagina iniziale, Saldi, Transazioni, Clienti, Catalogo prodotti, Payments, Billing, Reportistica, App, Altro. Sviluppatori non c'è.

Il menu della Dashboard: « Sviluppatori » non c'è. Si usa il link qui sopra.

3Crea una chiave con restrizioni ▸ « Creare la tua integrazione »

Nella pagina delle chiavi premi Crea chiave con restrizioni. Alla domanda « Scegli come utilizzerai questa chiave » scegli la prima:

Scegli come utilizzerai questa chiave: evidenziata « Creare la tua integrazione ».

(1) La chiave la usa il programma del negozio: non è un agente di IA né un'app di terzi.

4« Autorizzazioni personalizzate »

Assegna le autorizzazioni: evidenziata « Autorizzazioni personalizzate ».

(1) Le altre danno troppo: « Accesso completo » e « tranne operazioni sensibili » permettono di fare quasi tutto sul conto.

5Due permessi in Scrittura, tutto il resto Nessuna

Usa la ricerca in alto (1) e metti Scrittura (2) su:

Webhook Endpoints — serve a EventPrint per registrare l'indirizzo a cui Stripe conferma i pagamenti;
Checkout Sessions — serve a creare la pagina di pagamento per il cliente.

Le scelte restano anche cambiando la ricerca. Tutto il resto lascialo su Nessuna.

Ricerca « Webhook Endpoints » con il permesso Scrittura selezionato.

(1) La ricerca. (2) Scrittura su « Webhook Endpoints, Event Destinations ». Poi lo stesso con « Checkout Sessions », e Continua.

6Nome, controllo e « Crea chiave »

Nome EventPrint. Nella Nota scrivi dove la usi (per esempio « Worker EventPrint di Foto Rossi »): servirà a chi un giorno dovrà revocarla. Controlla che il riepilogo dica 2 autorizzazioni, 2 in scrittura (1), poi Crea chiave (2).

Riepilogo: nome EventPrint, 2 autorizzazioni in scrittura, Checkout Sessions e Webhook Endpoints; pulsante Crea chiave.

Copia la chiave: comincia con rk_test_ (prova) o rk_live_ (incassa).

La chiave live Stripe la mostra una volta sola. Incollala subito in Studio. Non mandarla per email o in chat: se finisce in giro, su Stripe la si revoca e se ne crea un'altra.

7Accendi i metodi su Stripe

Nella Dashboard: Impostazioni ▸ Metodi di pagamento.

Carte è già attivo. Attiva anche Apple Pay e Google Pay: compaiono da soli a chi paga da iPhone o da Chrome/Android.
PayPal: attivalo e collega il conto PayPal Business del negozio.
Satispay: attivalo (può chiedere di accettare le condizioni di Satispay). Solo euro, clienti in Italia.
Revolut Pay: attivalo.

Accendi solo quelli che il negozio vuole offrire: in Studio si sceglie di nuovo.

Parte 2 — In EventPrint Studio

8Incolla la chiave e premi « Collega »

Impostazioni ▸ Pagamenti ▸ Conto Stripe: incolla la chiave nella casella e premi Collega (1). In alto deve comparire ✓ Collegato (2).

Studio, Impostazioni ▸ Pagamenti: casella della chiave e pulsante Collega; sopra, « Collegato: conto Stripe — modalità di PROVA, non incassa ».

Il nome del conto non compare: con la chiave con restrizioni è normale. « Modalità di PROVA » vuol dire che la chiave è rk_test_.

Al resto pensa EventPrint: registra da solo su Stripe l'indirizzo delle conferme di pagamento. La chiave viene custodita cifrata nello spazio online del negozio: Studio non la tiene, e la casella si svuota.

9Accendi un canale e premi « Verifica »

Spunta Attivo sul canale (1): deve dire « ✓ attivo ».
Premi Verifica (2): si apre una pagina di pagamento di Stripe da 1 €.
Paga coi dati di prova: carta 4242 4242 4242 4242, una scadenza futura (per esempio 12/30), CVC 123, un nome qualsiasi. Per PayPal, Satispay e Revolut Pay Stripe mostra una pagina di prova con « Autorizza ».
Torna in Studio e aspetta fino a mezzo minuto: deve comparire ✓ La conferma di Stripe è arrivata (3).

Studio: carta attiva, pulsante Verifica, e in alto « La conferma di Stripe è arrivata: pagamento, conferma e canale funzionano ».

La scritta (3) è la prova che funziona tutto il giro: pagamento, conferma di Stripe allo spazio online del negozio, canale.

Ripeti per ogni canale acceso.

10Passa alla modalità live

Quando la prova va: in Stripe passa a live, rifai i passi 3–6 (chiave rk_live_) e 7 (i metodi vanno accesi anche in live), incolla la nuova chiave e premi Collega: sostituisce quella di prova. In Studio deve dire INCASSA DAVVERO. In live « Verifica » controlla solo che Stripe accetti il canale, senza aprire un pagamento vero.

Parte 3 — Bonifico, contrassegno, negozio

Bonifico anticipato: IBAN e intestatario (anche un conto Wise o Revolut Business, col suo IBAN) e « Salva i dati del bonifico ». Studio controlla l'IBAN.
Contrassegno: per tutti i clienti; chiede l'indirizzo e si paga alla consegna.
In negozio: sempre disponibile per chi entra col codice VIP; non va attivato.

Col codice CLIENTI (quello su locandina e QR) si paga in tutti i modi attivi tranne il pagamento al ritiro in negozio. Il codice VIP il negozio lo dà ai clienti che conosce: in Clienti, la spunta VIP fa arrivare a quella persona il codice VIP, e chi entra dal QR col telefono di un VIP della rubrica viene riconosciuto VIP.

Se qualcosa non va

Cosa vedi	Cosa vuol dire, cosa fare
« Il tuo spazio online è di una versione precedente »	Lo spazio online del negozio non conosce ancora i pagamenti. Va aggiornato: arriva con l'aggiornamento, o chi ha dato la licenza lo ripubblica.
« Stripe rifiuta la chiave »	È stata copiata la chiave pubblicabile (`pk_…`) o una chiave revocata. Serve quella con restrizioni (`rk_…`).
« Non riesco a registrare l'indirizzo delle conferme »	Alla chiave manca Scrittura su « Webhook Endpoints » (passo 5).
Verifica: « non attivo su Stripe »	Il metodo non è acceso in Impostazioni ▸ Metodi di pagamento (passo 7), o non ancora: alcuni chiedono qualche minuto.
La conferma non arriva	Il pagamento di prova non è stato completato, o è stato annullato. Riprova la Verifica e paga fino in fondo.
« Modalità di PROVA » con le gallerie aperte	I clienti vedrebbero pagamenti finti: collega la chiave live (passo 10).

EventPrint · guida ai pagamenti online. Il capitolo « Pagamenti online: attivare i canali » del manuale spiega anche il perché delle scelte.