Rehberler

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.

Markdown olarak aç

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	Ön ödemeli krediler, istek başına harcama	`sell-credits`	`api-credits` (Hono)
SaaS aboneliği	Aylık plan, faturayla yenileme	`sell-subscription`	`saas-subscription` (Next.js)
Lisans anahtarları	Anahtarla açılan uygulama ya da eklenti	`sell-license-keys`	`license-keys` (Node CLI)
Telegram botu	Ücretli komutlar, roller, gruplar	`sell-bot-access`	`telegram-bot` (Node)
Ücretli MCP sunucusu	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.