# Recetas para asistentes de IA

> Vende una API, un plan SaaS, una app, un bot o herramientas MCP en cripto con una sola petición a tu asistente de código.

Pide a tu asistente «deja que la gente compre créditos de API con USDC» y debería hacerlo bien: primero el modo de prueba, un webhook firmado, acceso solo tras un pago entregado. Estas recetas se lo enseñan. Cada una es una skill para Claude Code, una regla para Cursor y un bloque para `AGENTS.md` desde una misma fuente, más una app pequeña que puedes ejecutar. No nos cuestan nada: son archivos en tu proyecto que llaman a Perly Pay con tu propia clave.

| Receta | Qué vende | Skill | Ejemplo |
| --- | --- | --- | --- |
| [Créditos de API](https://pay.perly.io/docs/recipe-api-credits.md) | Créditos prepagados, gasto por llamada | `sell-credits` | `api-credits` (Hono) |
| [Suscripción SaaS](https://pay.perly.io/docs/recipe-saas-subscription.md) | Un plan mensual, renovado por factura | `sell-subscription` | `saas-subscription` (Next.js) |
| [Claves de licencia](https://pay.perly.io/docs/recipe-license-keys.md) | Una app o un plugin que se desbloquea con una clave | `sell-license-keys` | `license-keys` (Node CLI) |
| [Bot de Telegram](https://pay.perly.io/docs/recipe-telegram-bot.md) | Comandos de pago, roles, grupos | `sell-bot-access` | `telegram-bot` (Node) |
| [Servidor MCP de pago](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | Herramientas MCP, créditos por llamada | `paid-mcp-tools` | `paid-mcp-server` (MCP SDK) |

Las acompañan tres skills más: `add-crypto-checkout` para cualquier venta única, `verify-webhooks` para la ruta de webhook correcta en cada framework y `test-and-go-live` para simular pagos y pasar a dinero real.

## Claude Code

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

Luego pide las cosas con palabras normales o llama a una skill: `/perly-pay:sell-credits`.

## Cursor

Copia `cursor/rules/*.mdc` del plugin a `.cursor/rules/` de tu proyecto. `perly-pay.mdc` contiene las reglas; cada receta tiene su propio archivo, que se carga cuando la conversación trata de ella.

## AGENTS.md

Pega `AGENTS-snippet.md` del plugin en tu `AGENTS.md` (lo leen Codex, Jules, Copilot, Zed, Cursor y otros). Va entre `BEGIN perly-pay` y `END perly-pay`, así que una actualización lo reemplaza entero.

## Cualquier asistente

Las skills para cualquier asistente están listadas en `/.well-known/skills/index.json`, y cada página de la documentación existe también en Markdown: añade `.md` a su dirección o léelas todas juntas en `/llms-full.txt`.

## Lo que respeta cada receta

- Primero el modo de prueba: una clave `sk_test_…` e `invoices.simulate`. No se mueve dinero real.
- La clave secreta se queda en tu servidor, en `PERLY_PAY_SECRET_KEY`. Las apps que distribuyes verifican licencias sin ninguna clave.
- Acceso solo con `invoice.fulfilled` o `entitlements.check`: nunca al volver del pago y nunca con `invoice.paid`.
- Los webhooks se verifican sobre el cuerpo en bruto y cada evento se procesa una vez.
- Claves de idempotencia en todo lo que pueda repetirse, como el gasto de créditos.
- Importes en centavos, USD o EUR. Nunca decimales de coma flotante.
- Ningún cobro automático: las renovaciones y las recargas son facturas que el comprador paga desde su billetera.