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

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](https://pay.perly.io/docs/recipe-api-credits.md) | Vorausbezahlte Credits, Verbrauch pro Anfrage | `sell-credits` | `api-credits` (Hono) |
| [SaaS-Abo](https://pay.perly.io/docs/recipe-saas-subscription.md) | Monatstarif, Verlängerung per Rechnung | `sell-subscription` | `saas-subscription` (Next.js) |
| [Lizenzschlüssel](https://pay.perly.io/docs/recipe-license-keys.md) | Eine App oder ein Plugin, per Schlüssel freigeschaltet | `sell-license-keys` | `license-keys` (Node CLI) |
| [Telegram-Bot](https://pay.perly.io/docs/recipe-telegram-bot.md) | Bezahlte Befehle, Rollen, Gruppen | `sell-bot-access` | `telegram-bot` (Node) |
| [Bezahlter MCP-Server](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | 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.