Vai al contenuto
Kaiross

E-commerce e pagamenti

Stripe

Pagamenti, clienti, fatture e saldo Stripe; link di pagamento e rimborsi con conferma.

  • Token o credenziali
  • Azioni con conferma

Strumenti per l’agente

L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.

StrumentoCosa faTipo
list_payments Pagamenti (PaymentIntent) recenti con importo, stato e cliente; tabella. Lettura
search_customers Cerca clienti per email o nome. Lettura
list_invoices Fatture Stripe (stato: draft, open, paid, uncollectible, void). Lettura
get_balance Saldo disponibile e in arrivo per valuta. Lettura
create_payment_link Crea un link di pagamento per un importo e una descrizione. Richiede conferma. Con conferma
refund_payment Rimborsa (del tutto o in parte) un pagamento. Richiede conferma. Con conferma

Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti link di pagamento e rimborsi (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.

Configurazione passo per passo

In Kaiross apri Integrazioni, scegli Stripe e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.

  1. Stripe Dashboard → Sviluppatori → Chiavi API → Crea chiave limitata.
  2. Permessi in lettura: Charges, Customers, Invoices, PaymentIntents, Balance. Per le azioni: Payment Links e Refunds in scrittura.
  3. Usa prima le chiavi di test (rk_test_…) per provare.

Da incollare (cifrato nel Vault, poi non più visibile): Restricted key.

Collegarla a un agente

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
  2. In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
  3. Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
  4. Premi Prova in chat e fai una domanda che richiede i dati del servizio.

Errori frequenti

Credenziali non valide
Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
Permessi insufficienti
All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
Troppe richieste
Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.

Altre integrazioni della categoria E-commerce e pagamenti

Tutte le integrazioni