Anleitungen

Rezepte für AI-Assistenten

Verkaufen Sie eine API, einen SaaS-Tarif, eine App, einen Bot oder MCP-Tools gegen Krypto – mit einer Bitte an Ihren Coding-Assistenten.

Als Markdown ansehen

Bitten Sie Ihren Assistenten: „Lass Leute API-Credits mit USDC kaufen“ – und er soll es richtig machen: zuerst Testmodus, ein signierter Webhook, Zugang erst nach erfüllter Zahlung. Diese Rezepte bringen ihm das bei. Jedes ist ein Skill für Claude Code, eine Regel für Cursor und ein Block für AGENTS.md aus einer Quelle, plus eine kleine App, die Sie starten können. Uns kosten sie nichts: Es sind Dateien in Ihrem Projekt, die Perly Pay mit Ihrem eigenen Schlüssel aufrufen.

Rezept	Was es verkauft	Skill	Beispiel
API-Credits	Vorausbezahlte Credits, Verbrauch pro Anfrage	`sell-credits`	`api-credits` (Hono)
SaaS-Abo	Monatstarif, Verlängerung per Rechnung	`sell-subscription`	`saas-subscription` (Next.js)
Lizenzschlüssel	Eine App oder ein Plugin, per Schlüssel freigeschaltet	`sell-license-keys`	`license-keys` (Node CLI)
Telegram-Bot	Bezahlte Befehle, Rollen, Gruppen	`sell-bot-access`	`telegram-bot` (Node)
Bezahlter MCP-Server	MCP-Tools, Credits pro Aufruf	`paid-mcp-tools`	`paid-mcp-server` (MCP SDK)

Dazu kommen drei Skills: add-crypto-checkout für jeden Einmalverkauf, verify-webhooks für die richtige Webhook-Route in jedem Framework und test-and-go-live zum Simulieren von Zahlungen und für den Wechsel zu echtem Geld.

Claude Code

bash

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

Dann bitten Sie in normalen Worten oder rufen einen Skill auf: /perly-pay:sell-credits.

Cursor

Kopieren Sie cursor/rules/*.mdc aus dem Plugin in .cursor/rules/ Ihres Projekts. perly-pay.mdc enthält die Regeln; jedes Rezept hat eine eigene Datei, die greift, wenn es im Gespräch um es geht.

AGENTS.md

Fügen Sie AGENTS-snippet.md aus dem Plugin in Ihre AGENTS.md ein (gelesen von Codex, Jules, Copilot, Zed, Cursor und anderen). Es steht zwischen BEGIN perly-pay und END perly-pay, sodass ein Update es vollständig ersetzt.

Jeder Assistent

Die Skills für jeden Assistenten stehen in /.well-known/skills/index.json, und jede Doku-Seite gibt es auch als Markdown – hängen Sie .md an ihre Adresse an oder lesen Sie alle zusammen unter /llms-full.txt.

Woran sich jedes Rezept hält

Zuerst der Testmodus: ein Schlüssel sk_test_… und invoices.simulate. Echtes Geld bewegt sich nicht.
Der geheime Schlüssel bleibt auf Ihrem Server, in PERLY_PAY_SECRET_KEY. Apps, die Sie verteilen, prüfen Lizenzen ganz ohne Schlüssel.
Zugang nur bei invoice.fulfilled oder entitlements.check – nie bei der Rückkehr vom Bezahlen und nie bei invoice.paid.
Webhooks werden auf dem rohen Body geprüft, jedes Ereignis wird einmal verarbeitet.
Idempotenzschlüssel auf allem, was sich wiederholen kann, etwa beim Verbrauch von Credits.
Beträge in Cent, USD oder EUR. Nie Gleitkommazahlen.
Keine automatische Abbuchung: Verlängerungen und Aufladungen sind Rechnungen, die der Käufer aus seiner Wallet bezahlt.