가이드

AI 어시스턴트용 레시피

코드를 쓰는 어시스턴트에게 한 번 요청해 API, SaaS 요금제, 앱, 봇, MCP 도구를 암호화폐로 판매하세요.

어시스턴트에게 "USDC로 API 크레딧을 살 수 있게 해 줘"라고 하면 제대로 해야 합니다: 테스트 모드 먼저, 서명된 웹훅, 결제가 이행된 뒤에만 이용권. 이 레시피가 그걸 가르칩니다. 각각 한 소스에서 나온 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)

스킬이 세 개 더 있습니다: 모든 1회 판매용 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. 부동소수점은 절대 쓰지 않습니다.
자동 청구 없음: 갱신과 충전은 구매자가 자기 지갑에서 결제하는 청구서입니다.