Посібники

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

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

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

Рецепт	Що продає	Скіл	Приклад
API-кредити	Передплачені кредити, витрата за запит	`sell-credits`	`api-credits` (Hono)
SaaS-підписка	Місячний план, поновлення рахунком	`sell-subscription`	`saas-subscription` (Next.js)
Ліцензійні ключі	Застосунок чи плагін, що відкривається ключем	`sell-license-keys`	`license-keys` (Node CLI)
Telegram-бот	Платні команди, ролі, групи	`sell-bot-access`	`telegram-bot` (Node)
Платний MCP-сервер	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. Ніколи дроби з плаваючою комою.
Жодного автосписання: поновлення й поповнення — це рахунки, які покупець сплачує зі свого гаманця.