Skip to main content
Stripe è il modo con cui lo studente incassa online. La sua chiave serve a due cose con una sola credenziale: i link di pagamento che l’agente Conduit genera in chat (extra a listino) e il checkout del sito direct booking.
Questo è lo Stripe dello studente (incassa lui). È una cosa diversa dal canone che lo studente paga a Mattone per il Servizio AI Ospiti (quello passa da un abbonamento Stripe intestato a Mattone, non da questa chiave). Le due cose si confondono facilmente: vedi Stripe dello studente vs fatturazione Conduit per la disambiguazione completa.

​
Regola d’oro: una chiave a permessi minimi

Si usa una chiave a permessi minimi (Restricted Key, rk_live_…), non la Secret Key (quella dà accesso a tutto).
  • Cosa deve poter fare: creare prodotti, prezzi e link di pagamento (Products / Prices / Payment Links = Write) e leggere i movimenti per la riconciliazione (Balance / Balance transactions = Read, Payouts = Read). Nient’altro.
  • Cosa NON deve poter fare: rimborsi, leggere i dati dei clienti, toccare l’account, spostare soldi. Tutto il resto = None.
  • La piattaforma accetta rk_live_… (consigliata) e, per chi l’ha già inserita, sk_live_…; per le prove rk_test_ / sk_test_. La verifica legge GET /v1/products (non /v1/account, che una chiave ristretta non può leggere).
  • La chiave sta cifrata nel Vault, mai nei repo, mai in chat.
Stripe è opzionale/fallback: si monta solo per chi vende extra a listino. Il pagamento di prenotazioni/allunghi va sul flusso nativo del PMS (online check-in), mai su Stripe autonomo. Se il nativo non incassa → escala a umano.

​
Collegamento

1

Lo studente crea la Restricted key

Dashboard Stripe → Developers → API keys → Create restricted key. Nome: Mattone. Permessi: Products = Write, Prices = Write, Payment Links = Write, Balance = Read, Payouts = Read; tutto il resto None. Copia la chiave subito: Stripe la mostra una volta sola.
2

La incolla nella piattaforma

app.mattone.co → Operatività → Connessioni → Stripe: incolla la chiave e conferma. La piattaforma la verifica su Stripe e la salva nel Vault: lo studente non la manda a nessuno, mai in chat di gruppo. Se la card dice «chiave rifiutata», i permessi sopra non ci sono tutti: si rifà la chiave, non si passa alla Secret Key.
3

Monta tool + skill (per gli extra Conduit)

Custom tool stripe (MCP Gateway mcp.mattone.co/api/mcp/stripe, metodo create_payment_link, params amount+description) + skill payment-link-generator. Senza la skill l’agente ignora il tool.
Prima la chiave vera nel Vault, poi il tool. Una chiave mancante/fasulla rompe l’agente nativo.

​
Doppio uso della stessa chiave

​
Come verificare

  • T1 gateway: create_payment_link con amount:"1.00" → torna una URL Stripe valida.
  • T2 agente: “Vorrei il late check-out” → quota dal listino e, a “sì”, genera il link. Prezzo non a listino → escala, non inventa.
  • T3 causale: il link ha description specifica per la riconciliazione.
Fonti: conduit-custom-tool/STRIPE-PAYMENT-LINK-attivazione-e-test.md, memoria reference_conduit_stripe_payments. Attivazione step-by-step: Onboarding · Pagamenti Stripe. Uso sul sito: Direct Booking.
▷ Prompt Claude Code: Collega Stripe · incolla in Claude Code:

Stripe → API keys

Lo studente crea la Restricted key

Extra / Upsell (casistica)

Come l’agente vende dal listino

​
Fonti ufficiali