Guide

Ricette per assistenti AI

Vendi un’API, un piano SaaS, un’app, un bot o tool MCP in crypto con una sola richiesta al tuo assistente di programmazione.

Vedi come Markdown

Chiedi al tuo assistente «fai comprare crediti API in USDC» e dovrebbe farlo bene: prima la modalità test, un webhook firmato, l’accesso solo dopo un pagamento consegnato. Queste ricette glielo insegnano. Ognuna è una skill per Claude Code, una regola per Cursor e un blocco per AGENTS.md da un’unica fonte, più una piccola app che puoi eseguire. Non ci costano nulla: sono file nel tuo progetto che chiamano Perly Pay con la tua chiave.

Ricetta	Cosa vende	Skill	Esempio
Crediti API	Crediti prepagati, consumo a chiamata	`sell-credits`	`api-credits` (Hono)
Abbonamento SaaS	Un piano mensile, rinnovato a fattura	`sell-subscription`	`saas-subscription` (Next.js)
Chiavi di licenza	Un’app o un plugin sbloccato da una chiave	`sell-license-keys`	`license-keys` (Node CLI)
Bot Telegram	Comandi a pagamento, ruoli, gruppi	`sell-bot-access`	`telegram-bot` (Node)
Server MCP a pagamento	Tool MCP, crediti a chiamata	`paid-mcp-tools`	`paid-mcp-server` (MCP SDK)

Le accompagnano altre tre skill: add-crypto-checkout per qualsiasi vendita una tantum, verify-webhooks per la route webhook giusta in ogni framework e test-and-go-live per simulare pagamenti e passare al denaro reale.

Claude Code

bash

claude plugin marketplace add volodymyrslipak/perly-pay-ai && claude plugin install perly-pay@perly

Poi chiedi le cose a parole o richiama una skill: /perly-pay:sell-credits.

Cursor

Copia cursor/rules/*.mdc dal plugin in .cursor/rules/ del tuo progetto. perly-pay.mdc contiene le regole; ogni ricetta ha il suo file, che si carica quando la conversazione ne parla.

AGENTS.md

Incolla AGENTS-snippet.md dal plugin nel tuo AGENTS.md (lo leggono Codex, Jules, Copilot, Zed, Cursor e altri). Sta tra BEGIN perly-pay e END perly-pay, quindi un aggiornamento lo sostituisce per intero.

Qualsiasi assistente

Le skill per qualsiasi assistente sono elencate in /.well-known/skills/index.json, e ogni pagina della documentazione esiste anche in Markdown: aggiungi .md al suo indirizzo o leggile tutte insieme in /llms-full.txt.

Cosa rispetta ogni ricetta

Prima la modalità test: una chiave sk_test_… e invoices.simulate. Non si muove denaro reale.
La chiave segreta resta sul tuo server, in PERLY_PAY_SECRET_KEY. Le app che distribuisci verificano le licenze senza alcuna chiave.
Accesso solo con invoice.fulfilled o entitlements.check: mai al ritorno dal checkout e mai con invoice.paid.
I webhook si verificano sul body grezzo e ogni evento si elabora una volta.
Chiavi di idempotenza su tutto ciò che può ripetersi, come il consumo di crediti.
Importi in centesimi, USD o EUR. Mai numeri in virgola mobile.
Nessun addebito automatico: rinnovi e ricariche sono fatture che l’acquirente paga dal suo wallet.