Poradniki

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.

Otwórz jako Markdown

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	Przedpłacone kredyty, zużycie za zapytanie	`sell-credits`	`api-credits` (Hono)
Subskrypcja SaaS	Plan miesięczny, odnowienie fakturą	`sell-subscription`	`saas-subscription` (Next.js)
Klucze licencyjne	Aplikacja lub wtyczka odblokowywana kluczem	`sell-license-keys`	`license-keys` (Node CLI)
Bot w Telegramie	Płatne komendy, role, grupy	`sell-bot-access`	`telegram-bot` (Node)
Płatny serwer MCP	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.