Where do I find my Stripe keys?

Log into your Stripe Dashboard at dashboard.stripe.com. Click the Developers tab in the top navigation, then API Keys. You'll see a Publishable key and a Secret key. Copy both. The publishable key starts with pk_live_ (or pk_test_ in test mode) and is safe to expose in the browser. The secret key starts with sk_live_ — treat it like a password, never share it publicly.

How do I enter my keys in VeloCMS?

Go to Admin → Settings → Membership → Stripe Setup. Click the BYOK Wizard button. The wizard walks through three steps: paste your publishable key, paste your secret key, and optionally paste a webhook signing secret if you want to receive Stripe events (recommended for subscription renewals and cancellations). After saving, VeloCMS validates both keys against the Stripe API and shows a green checkmark when they're confirmed working. Your keys are encrypted with AES-256-GCM before storage — t...

How do I set the subscription price?

After your keys are connected, go to Settings → Membership → Pricing. Enter a monthly price (minimum $1) and optionally an annual price — the wizard suggests an annual price at 20% off monthly by default. Hit Save and VeloCMS creates the Stripe Price objects on your account automatically. There's no need to manually create products or prices in the Stripe Dashboard.

What content can I put behind the paywall?

Individual posts can be gated — toggle the Members Only switch in the post's Settings panel. You can also gate by tag: mark a tag as members-only and every post with that tag is paywalled automatically. Free readers see a preview up to the paywall cutoff marker you drag into the post body, then a subscribe prompt. Existing free subscribers can be grandfathered in by marking them as Complimentary in the Members tab.

كيف أُعدّ اشتراكات مدفوعة مع Stripe؟

يعتمد VeloCMS نموذج BYOK (أحضر مفاتيحك الخاصة) لاشتراكات القراء — تربط حساب Stripe الخاص بك وتذهب كل قرش من القراء المدفوعين مباشرة إليك. لا يأخذ VeloCMS أي عمولة من إيرادات الأعضاء.

أين أجد مفاتيح Stripe الخاصة بي؟

سجّل الدخول إلى لوحة تحكم Stripe على dashboard.stripe.com. اضغط على تبويب المطورين في التنقل العلوي، ثم على مفاتيح API. ستجد مفتاحاً للنشر ومفتاحاً سرياً. انسخهما معاً. يبدأ مفتاح النشر بـ pk_live_ (أو pk_test_ في وضع الاختبار) وهو آمن للظهور في المتصفح. أما المفتاح السري فيبدأ بـ sk_live_ — تعامل معه كما تتعامل مع كلمة مرور ولا تشاركه مع أحد.

كيف أدخل مفاتيحي في VeloCMS؟

انتقل إلى لوحة الإدارة ← الإعدادات ← العضوية ← إعداد Stripe. اضغط على زر معالج BYOK. يأخذك المعالج عبر ثلاث خطوات: لصق مفتاح النشر، ولصق المفتاح السري، ثم إدخال سر توقيع الـ webhook اختيارياً إذا أردت تلقّي أحداث Stripe (يُوصى به لتجديد الاشتراكات وإلغائها). بعد الحفظ، يتحقق VeloCMS من صحة المفتاحين عبر Stripe API ويعرض علامة خضراء عند تأكيد عملهما. تُشفَّر مفاتيحك باستخدام AES-256-GCM قبل التخزين — لا تُحفظ أبداً في نص عادي.

يأتي سر توقيع الـ webhook من لوحة Stripe ← المطورون ← Webhooks. أنشئ نقطة نهاية تشير إلى yourblog.velocms.org/api/member-webhook/your-slug وانسخ السر الذي تُولّده Stripe.

كيف أحدد سعر الاشتراك؟

بعد ربط مفاتيحك، انتقل إلى الإعدادات ← العضوية ← التسعير. أدخل سعراً شهرياً (الحد الأدنى دولار واحد) وسعراً سنوياً اختيارياً — يقترح المعالج خصم 20% على السعر الشهري كسعر سنوي افتراضي. اضغط حفظ ويُنشئ VeloCMS كائنات Stripe Price على حسابك تلقائياً. لا حاجة لإنشاء منتجات أو أسعار يدوياً في لوحة Stripe.

ما المحتوى الذي يمكنني وضعه خلف الجدار المدفوع؟

يمكن تقييد المنشورات الفردية — فعّل مفتاح "للأعضاء فقط" في لوحة إعدادات المنشور. كما يمكنك التقييد بوسم: حدد وسماً للأعضاء فقط وتُقيَّد تلقائياً كل المنشورات التي تحمله. يرى القراء المجانيون معاينة حتى علامة قطع المحتوى التي تسحبها إلى جسم المنشور، ثم تظهر لهم دعوة للاشتراك. يمكن منح المشتركين المجانيين الحاليين وصولاً مجانياً دائماً بتمييزهم بوصف "تكميلي" من تبويب الأعضاء.