Guias

Receitas para assistentes de IA

Venda uma API, um plano SaaS, um app, um bot ou ferramentas MCP em cripto com um só pedido ao seu assistente de código.

Peça ao seu assistente “deixe as pessoas comprarem créditos de API com USDC” e ele deve acertar: primeiro o modo de teste, um webhook assinado, acesso só depois de um pagamento entregue. Estas receitas ensinam isso a ele. Cada uma é uma skill para o Claude Code, uma regra para o Cursor e um bloco para o AGENTS.md a partir de uma mesma fonte, mais um app pequeno que você pode executar. Elas não nos custam nada: são arquivos no seu projeto que chamam o Perly Pay com a sua própria chave.

Receita	O que vende	Skill	Exemplo
Créditos de API	Créditos pré-pagos, gasto por chamada	`sell-credits`	`api-credits` (Hono)
Assinatura SaaS	Um plano mensal, renovado por fatura	`sell-subscription`	`saas-subscription` (Next.js)
Chaves de licença	Um app ou um plugin desbloqueado com uma chave	`sell-license-keys`	`license-keys` (Node CLI)
Bot do Telegram	Comandos pagos, cargos, grupos	`sell-bot-access`	`telegram-bot` (Node)
Servidor MCP pago	Ferramentas MCP, créditos por chamada	`paid-mcp-tools`	`paid-mcp-server` (MCP SDK)

Junto com elas vêm mais três skills: add-crypto-checkout para qualquer venda única, verify-webhooks para a rota de webhook correta em cada framework e test-and-go-live para simular pagamentos e passar para dinheiro real.

Claude Code

bash

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

Depois peça as coisas com palavras normais ou chame uma skill: /perly-pay:sell-credits.

Cursor

Copie cursor/rules/*.mdc do plugin para .cursor/rules/ do seu projeto. perly-pay.mdc contém as regras; cada receita tem o próprio arquivo, carregado quando a conversa trata dela.

AGENTS.md

Cole AGENTS-snippet.md do plugin no seu AGENTS.md (lido por Codex, Jules, Copilot, Zed, Cursor e outros). Ele fica entre BEGIN perly-pay e END perly-pay, então uma atualização o substitui por inteiro.

Qualquer assistente

As skills para qualquer assistente estão listadas em /.well-known/skills/index.json, e cada página da documentação existe também em Markdown: adicione .md ao endereço dela ou leia todas juntas em /llms-full.txt.

O que cada receita respeita

Primeiro o modo de teste: uma chave sk_test_… e invoices.simulate. Nenhum dinheiro real se move.
A chave secreta fica no seu servidor, em PERLY_PAY_SECRET_KEY. Os apps que você distribui verificam licenças sem nenhuma chave.
Acesso só com invoice.fulfilled ou entitlements.check: nunca na volta do checkout e nunca com invoice.paid.
Os webhooks são verificados sobre o corpo bruto e cada evento é processado uma vez.
Chaves de idempotência em tudo o que pode se repetir, como o gasto de créditos.
Valores em centavos, USD ou EUR. Nunca números de ponto flutuante.
Nenhuma cobrança automática: renovações e recargas são faturas que o comprador paga da própria carteira.