Kurulum

Gereksinimler

• Node.js 18+
• Next.js 15+ (Next.js entegrasyonu için)
• React 19+
• Bir PayTR Direct API hesabı — recurring (tekrarlayan ödeme) yetkisi aktif olmalıdır

PayTR Recurring Yetkisi

recurr yalnızca PayTR'nin recurring (abonelik/tekrarlayan ödeme) özelliğiyle çalışır. Bu yetki varsayılan olarak kapalıdır; mağaza destek birimine yazarak açtırmanız gerekir.

Yetki tanımlanmadan ilk ödeme denemesinde şu hatayı alırsınız:

{ "status": "failed", "reason": "Bu islem icin magazanin yetkisi yok (recurring)" }

Yetki Talebi

PayTR destek sayfasından talep açın. Mesajınıza şunu yazabilirsiniz:

Yetki aktif edildikten sonra PayTR panelinden Direct API kimlik bilgilerinizi (Merchant ID, Merchant Key, Merchant Salt) alabilirsiniz.

Kurulum

You are installing **recurr** — a PayTR subscription layer for Next.js.## Important: When to ask the user

npm install @vinenastudio/recurr

pnpm add @vinenastudio/recurr

yarn add @vinenastudio/recurr

bun add @vinenastudio/recurr

Ortam Değişkenleri

.env.local dosyanıza aşağıdaki değişkenleri ekleyin:

# PayTR kimlik bilgileri
PAYTR_MERCHANT_ID=your_merchant_id
PAYTR_MERCHANT_KEY=your_merchant_key
PAYTR_MERCHANT_SALT=your_merchant_salt

# Uygulama
NEXT_PUBLIC_APP_URL=http://localhost:3000

# Cron güvenliği
CRON_SECRET=your_random_secret

# Yönetim paneli (opsiyonel)
ADMIN_USER=admin
ADMIN_PASS=strong_password

Sonraki Adımlar