# Recettes pour assistants IA

> Vendez une API, une offre SaaS, une app, un bot ou des outils MCP contre de la crypto, en un prompt à votre assistant de code.

Demandez à votre assistant de « laisser les gens acheter des crédits API en USDC » et il doit le faire correctement : mode test d’abord, un webhook signé, l’accès seulement une fois le paiement honoré. Ces recettes le lui apprennent. Chacune est un skill pour Claude Code, une règle pour Cursor et un bloc pour `AGENTS.md`, issus d’une seule source, plus une petite app à lancer. Elles ne coûtent rien : ce sont des fichiers dans votre projet, qui appellent Perly Pay avec votre propre clé.

| Recette | Vend | Skill | Exemple |
| --- | --- | --- | --- |
| [Crédits API](https://pay.perly.io/docs/recipe-api-credits.md) | Crédits prépayés, consommés par requête | `sell-credits` | `api-credits` (Hono) |
| [Abonnement SaaS](https://pay.perly.io/docs/recipe-saas-subscription.md) | Une offre mensuelle, renouvelée par facture | `sell-subscription` | `saas-subscription` (Next.js) |
| [Clés de licence](https://pay.perly.io/docs/recipe-license-keys.md) | Une app ou un plugin débloqué par une clé | `sell-license-keys` | `license-keys` (Node CLI) |
| [Bot Telegram](https://pay.perly.io/docs/recipe-telegram-bot.md) | Commandes payantes, rôles, groupes | `sell-bot-access` | `telegram-bot` (Node) |
| [Serveur MCP payant](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | Outils MCP, crédits par appel | `paid-mcp-tools` | `paid-mcp-server` (MCP SDK) |

Trois autres skills les accompagnent : `add-crypto-checkout` pour toute vente unique, `verify-webhooks` pour une route de webhook correcte dans chaque framework, et `test-and-go-live` pour les paiements simulés et le passage à l’argent réel.

## Claude Code

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

Ensuite, demandez en langage courant, ou appelez un skill : `/perly-pay:sell-credits`.

## Cursor

Copiez les `cursor/rules/*.mdc` du plugin dans le `.cursor/rules/` de votre projet. `perly-pay.mdc` contient les règles ; chaque recette a son propre fichier, joint quand la conversation porte dessus.

## AGENTS.md

Collez le `AGENTS-snippet.md` du plugin dans votre `AGENTS.md` (Codex, Jules, Copilot, Zed, Cursor et d’autres le lisent). Il se place entre `BEGIN perly-pay` et `END perly-pay`, donc une mise à jour le remplace en entier.

## Tout assistant

Les skills pour tout assistant sont listés dans `/.well-known/skills/index.json`, et chaque page de la doc existe aussi en Markdown — ajoutez `.md` à son adresse, ou lisez-les toutes dans `/llms-full.txt`.

## Ce que respecte chaque recette

- Mode test d’abord : une clé `sk_test_…` et `invoices.simulate`. Aucun argent réel ne bouge.
- La clé secrète reste sur votre serveur, dans `PERLY_PAY_SECRET_KEY`. Les apps distribuées vérifient les licences sans aucune clé.
- L’accès seulement sur `invoice.fulfilled` ou `entitlements.check` — jamais au retour de paiement, jamais sur `invoice.paid`.
- Webhooks vérifiés sur le corps brut, chaque événement traité une seule fois.
- Clés d’idempotence sur tout ce qui peut se répéter, comme la consommation de crédits.
- Montants en centimes, en USD ou EUR. Jamais de nombres à virgule flottante.
- Aucun prélèvement automatique, jamais : renouvellements et recharges sont des factures que l’acheteur paie depuis son portefeuille.