Guides

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.

Voir en Markdown

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	Crédits prépayés, consommés par requête	`sell-credits`	`api-credits` (Hono)
Abonnement SaaS	Une offre mensuelle, renouvelée par facture	`sell-subscription`	`saas-subscription` (Next.js)
Clés de licence	Une app ou un plugin débloqué par une clé	`sell-license-keys`	`license-keys` (Node CLI)
Bot Telegram	Commandes payantes, rôles, groupes	`sell-bot-access`	`telegram-bot` (Node)
Serveur MCP payant	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.