指南

AI 助手配方

向写代码的助手提一个请求，就能用加密货币出售 API、SaaS 套餐、应用、机器人或 MCP 工具。

让助手“让大家用 USDC 购买 API 额度” — 它就应该做对：先用测试模式、签名 Webhook、付款交付后才开通访问。这些配方就是教它这样做的。每个配方都由同一来源生成 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 为每个框架写出正确的 Webhook 路由，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。
Webhook 在原始请求体上校验，每个事件只处理一次。
所有可能重复的操作都用幂等键，例如扣减额度。
金额以分为单位，USD 或 EUR。绝不用浮点小数。
绝不自动扣款：续订和充值都是账单，由买家从自己的钱包支付。