# Рецепти для AI-асистентів

> Продавайте API, SaaS-план, застосунок, бота чи MCP-інструменти за криптовалюту одним запитом до асистента, що пише код.

Попросіть асистента «дай людям купувати API-кредити за USDC» — і він має зробити це правильно: спершу тестовий режим, підписаний вебхук, доступ лише після виконаної оплати. Ці рецепти його цього вчать. Кожен — скіл для Claude Code, правило для Cursor і блок для `AGENTS.md` з одного джерела, плюс маленький застосунок, який можна запустити. Нам вони нічого не коштують: це файли у вашому проєкті, що звертаються до Perly Pay вашим власним ключем.

| Рецепт | Що продає | Скіл | Приклад |
| --- | --- | --- | --- |
| [API-кредити](https://pay.perly.io/docs/recipe-api-credits.md) | Передплачені кредити, витрата за запит | `sell-credits` | `api-credits` (Hono) |
| [SaaS-підписка](https://pay.perly.io/docs/recipe-saas-subscription.md) | Місячний план, поновлення рахунком | `sell-subscription` | `saas-subscription` (Next.js) |
| [Ліцензійні ключі](https://pay.perly.io/docs/recipe-license-keys.md) | Застосунок чи плагін, що відкривається ключем | `sell-license-keys` | `license-keys` (Node CLI) |
| [Telegram-бот](https://pay.perly.io/docs/recipe-telegram-bot.md) | Платні команди, ролі, групи | `sell-bot-access` | `telegram-bot` (Node) |
| [Платний MCP-сервер](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | MCP-інструменти, кредити за виклик | `paid-mcp-tools` | `paid-mcp-server` (MCP SDK) |

З ними ще три скіли: `add-crypto-checkout` для будь-якого разового продажу, `verify-webhooks` для правильного маршруту вебхука в кожному фреймворку і `test-and-go-live` для імітації оплат і переходу на справжні гроші.

## Claude Code

> **Примітка:** Плагін уже на шляху до свого публічного репозиторію. Команди нижче запрацюють, щойно він там з'явиться.

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

Далі просіть звичайними словами або викличте скіл: `/perly-pay:sell-credits`.

## Cursor

Скопіюйте `cursor/rules/*.mdc` з плагіна в `.cursor/rules/` свого проєкту. `perly-pay.mdc` містить правила; кожен рецепт має свій файл, який підключається, коли розмова про нього.

## AGENTS.md

Вставте `AGENTS-snippet.md` з плагіна у свій `AGENTS.md` (його читають Codex, Jules, Copilot, Zed, Cursor та інші). Він стоїть між `BEGIN perly-pay` і `END perly-pay`, тож оновлення замінює його цілком.

## Будь-який асистент

Скіли для будь-якого асистента перелічено в `/.well-known/skills/index.json`, а кожна сторінка документації є й у Markdown — додайте `.md` до її адреси або прочитайте всі разом у `/llms-full.txt`.

## Чого тримається кожен рецепт

- Спершу тестовий режим: ключ `sk_test_…` і `invoices.simulate`. Справжні гроші не рухаються.
- Секретний ключ лишається на вашому сервері, у `PERLY_PAY_SECRET_KEY`. Застосунки, які ви розповсюджуєте, перевіряють ліцензії взагалі без ключа.
- Доступ лише за `invoice.fulfilled` або `entitlements.check` — ніколи за поверненням з оплати і ніколи за `invoice.paid`.
- Вебхуки перевіряються на сирому тілі, кожна подія обробляється раз.
- Ключі ідемпотентності на всьому, що може повторитися, наприклад на витраті кредитів.
- Суми в центах, USD або EUR. Ніколи дроби з плаваючою комою.
- Жодного автосписання: поновлення й поповнення — це рахунки, які покупець сплачує зі свого гаманця.