# AI asistanları için tarifler

> Bir API'yi, SaaS planını, uygulamayı, botu ya da MCP araçlarını, kod yazan asistanına tek bir istekle kriptoya karşı sat.

Asistanına "insanlar USDC ile API kredisi alabilsin" de — ve doğru yapmalı: önce test modu, imzalı webhook, erişim yalnızca teslim edilmiş ödemeden sonra. Bu tarifler ona bunu öğretir. Her biri tek kaynaktan bir Claude Code skill'i, bir Cursor kuralı ve bir `AGENTS.md` bloğu, artı çalıştırabileceğin küçük bir uygulama. Bize bir maliyeti yok: bunlar projendeki, Perly Pay'e senin kendi anahtarınla bağlanan dosyalar.

| Tarif | Ne satar | Skill | Örnek |
| --- | --- | --- | --- |
| [API kredileri](https://pay.perly.io/docs/recipe-api-credits.md) | Ön ödemeli krediler, istek başına harcama | `sell-credits` | `api-credits` (Hono) |
| [SaaS aboneliği](https://pay.perly.io/docs/recipe-saas-subscription.md) | Aylık plan, faturayla yenileme | `sell-subscription` | `saas-subscription` (Next.js) |
| [Lisans anahtarları](https://pay.perly.io/docs/recipe-license-keys.md) | Anahtarla açılan uygulama ya da eklenti | `sell-license-keys` | `license-keys` (Node CLI) |
| [Telegram botu](https://pay.perly.io/docs/recipe-telegram-bot.md) | Ücretli komutlar, roller, gruplar | `sell-bot-access` | `telegram-bot` (Node) |
| [Ücretli MCP sunucusu](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | MCP araçları, çağrı başına kredi | `paid-mcp-tools` | `paid-mcp-server` (MCP SDK) |

Yanlarında üç skill daha var: her tek seferlik satış için `add-crypto-checkout`, her framework'te doğru webhook rotası için `verify-webhooks` ve ödemeleri simüle edip gerçek paraya geçmek için `test-and-go-live`.

## Claude Code

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

Sonra sade kelimelerle iste ya da skill'i çağır: `/perly-pay:sell-credits`.

## Cursor

Eklentideki `cursor/rules/*.mdc` dosyalarını projendeki `.cursor/rules/` klasörüne kopyala. `perly-pay.mdc` kuralları içerir; her tarifin, konuşma onunla ilgili olduğunda devreye giren kendi dosyası var.

## AGENTS.md

Eklentideki `AGENTS-snippet.md` dosyasını kendi `AGENTS.md` dosyana yapıştır (Codex, Jules, Copilot, Zed, Cursor ve diğerleri okur). `BEGIN perly-pay` ile `END perly-pay` arasında durur, bu yüzden güncelleme onu bütünüyle değiştirir.

## Herhangi bir asistan

Her asistan için skill'ler `/.well-known/skills/index.json` içinde listelenir; belgelerin her sayfası Markdown olarak da var — adresine `.md` ekle ya da hepsini birlikte `/llms-full.txt` içinde oku.

## Her tarifin uyduğu kurallar

- Önce test modu: `sk_test_…` anahtarı ve `invoices.simulate`. Gerçek para hareket etmez.
- Gizli anahtar sunucunda, `PERLY_PAY_SECRET_KEY` içinde kalır. Dağıttığın uygulamalar lisansları hiç anahtar olmadan doğrular.
- Erişim yalnızca `invoice.fulfilled` ya da `entitlements.check` ile — asla ödemeden dönüşle, asla `invoice.paid` ile.
- Webhook'lar ham gövde üzerinde doğrulanır, her olay bir kez işlenir.
- Tekrarlanabilecek her şeyde idempotency anahtarları, örneğin kredi harcamada.
- Tutarlar sent cinsinden, USD ya da EUR. Asla kayan noktalı kesirler.
- Otomatik tahsilat yok: yenilemeler ve yüklemeler, alıcının kendi cüzdanından ödediği faturalardır.