# Przepisy dla asystentów AI

> Sprzedawaj API, plan SaaS, aplikację, bota lub narzędzia MCP za kryptowaluty jednym poleceniem do asystenta, który pisze kod.

Poproś asystenta: „pozwól ludziom kupować kredyty API za USDC” — i powinien zrobić to dobrze: najpierw tryb testowy, podpisany webhook, dostęp dopiero po zrealizowanej płatności. Te przepisy go tego uczą. Każdy to skill dla Claude Code, reguła dla Cursor i blok dla `AGENTS.md` z jednego źródła, plus mała aplikacja, którą można uruchomić. Nic nas nie kosztują: to pliki w Twoim projekcie, które łączą się z Perly Pay Twoim własnym kluczem.

| Przepis | Co sprzedaje | Skill | Przykład |
| --- | --- | --- | --- |
| [Kredyty API](https://pay.perly.io/docs/recipe-api-credits.md) | Przedpłacone kredyty, zużycie za zapytanie | `sell-credits` | `api-credits` (Hono) |
| [Subskrypcja SaaS](https://pay.perly.io/docs/recipe-saas-subscription.md) | Plan miesięczny, odnowienie fakturą | `sell-subscription` | `saas-subscription` (Next.js) |
| [Klucze licencyjne](https://pay.perly.io/docs/recipe-license-keys.md) | Aplikacja lub wtyczka odblokowywana kluczem | `sell-license-keys` | `license-keys` (Node CLI) |
| [Bot w Telegramie](https://pay.perly.io/docs/recipe-telegram-bot.md) | Płatne komendy, role, grupy | `sell-bot-access` | `telegram-bot` (Node) |
| [Płatny serwer MCP](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | Narzędzia MCP, kredyty za wywołanie | `paid-mcp-tools` | `paid-mcp-server` (MCP SDK) |

Do tego trzy skille: `add-crypto-checkout` dla dowolnej sprzedaży jednorazowej, `verify-webhooks` dla poprawnej trasy webhooka w każdym frameworku i `test-and-go-live` do symulowania płatności i przejścia na prawdziwe pieniądze.

## Claude Code

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

Potem proś zwykłymi słowami albo wywołaj skill: `/perly-pay:sell-credits`.

## Cursor

Skopiuj `cursor/rules/*.mdc` z wtyczki do `.cursor/rules/` swojego projektu. `perly-pay.mdc` zawiera reguły; każdy przepis ma własny plik, który włącza się, gdy rozmowa go dotyczy.

## AGENTS.md

Wklej `AGENTS-snippet.md` z wtyczki do swojego `AGENTS.md` (czytają go Codex, Jules, Copilot, Zed, Cursor i inne). Stoi między `BEGIN perly-pay` a `END perly-pay`, więc aktualizacja zastępuje go w całości.

## Dowolny asystent

Skille dla dowolnego asystenta są wymienione w `/.well-known/skills/index.json`, a każda strona dokumentacji jest też w Markdown — dodaj `.md` do jej adresu albo przeczytaj wszystkie naraz w `/llms-full.txt`.

## Czego trzyma się każdy przepis

- Najpierw tryb testowy: klucz `sk_test_…` i `invoices.simulate`. Prawdziwe pieniądze się nie ruszają.
- Klucz tajny zostaje na Twoim serwerze, w `PERLY_PAY_SECRET_KEY`. Aplikacje, które dystrybuujesz, sprawdzają licencje w ogóle bez klucza.
- Dostęp tylko na `invoice.fulfilled` lub `entitlements.check` — nigdy na powrót z płatności i nigdy na `invoice.paid`.
- Webhooki są weryfikowane na surowym body, każde zdarzenie obsługiwane raz.
- Klucze idempotencji na wszystkim, co może się powtórzyć, na przykład na zużyciu kredytów.
- Kwoty w centach, USD lub EUR. Nigdy ułamki zmiennoprzecinkowe.
- Żadnego automatycznego pobierania: odnowienia i doładowania to faktury, które kupujący opłaca ze swojego portfela.