# 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.

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](https://pay.perly.io/docs/recipe-api-credits.md) | Crediti prepagati, consumo a chiamata | `sell-credits` | `api-credits` (Hono) |
| [Abbonamento SaaS](https://pay.perly.io/docs/recipe-saas-subscription.md) | Un piano mensile, rinnovato a fattura | `sell-subscription` | `saas-subscription` (Next.js) |
| [Chiavi di licenza](https://pay.perly.io/docs/recipe-license-keys.md) | Un’app o un plugin sbloccato da una chiave | `sell-license-keys` | `license-keys` (Node CLI) |
| [Bot Telegram](https://pay.perly.io/docs/recipe-telegram-bot.md) | Comandi a pagamento, ruoli, gruppi | `sell-bot-access` | `telegram-bot` (Node) |
| [Server MCP a pagamento](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | 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.