Guías

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.

Ver como Markdown

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	Créditos prepagados, gasto por llamada	`sell-credits`	`api-credits` (Hono)
Suscripción SaaS	Un plan mensual, renovado por factura	`sell-subscription`	`saas-subscription` (Next.js)
Claves de licencia	Una app o un plugin que se desbloquea con una clave	`sell-license-keys`	`license-keys` (Node CLI)
Bot de Telegram	Comandos de pago, roles, grupos	`sell-bot-access`	`telegram-bot` (Node)
Servidor MCP de pago	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.