# 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](https://pay.perly.io/docs/recipe-api-credits.md) | Créditos pré-pagos, gasto por chamada | `sell-credits` | `api-credits` (Hono) |
| [Assinatura SaaS](https://pay.perly.io/docs/recipe-saas-subscription.md) | Um plano mensal, renovado por fatura | `sell-subscription` | `saas-subscription` (Next.js) |
| [Chaves de licença](https://pay.perly.io/docs/recipe-license-keys.md) | Um app ou um plugin desbloqueado com uma chave | `sell-license-keys` | `license-keys` (Node CLI) |
| [Bot do Telegram](https://pay.perly.io/docs/recipe-telegram-bot.md) | Comandos pagos, cargos, grupos | `sell-bot-access` | `telegram-bot` (Node) |
| [Servidor MCP pago](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | 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.