Issuing a full refund

Go to Admin → Orders and click any order row to open the detail view. At the top right you'll see a 'Refund' button. Click it and a panel slides out showing the order total pre-filled — just confirm and hit 'Process refund.' VeloCMS calls the Stripe API with the full charge amount, marks the order status as 'refunded,' and fires the customer notification email through Resend. The whole round-trip takes two or three seconds. For digital product orders, a full refund automatically revokes all d...

Same refund panel, but instead of accepting the pre-filled total, you type a lower amount. Useful for shipping disputes, minor product defects where you're offering a goodwill discount rather than a full return, or when you've negotiated a compromise with the customer. The order status stays 'completed' (since it wasn't fully refunded), and a refund record appears in the order's timeline showing the partial amount, timestamp, and reason. You can issue multiple partial refunds on a single orde...

Behind the scenes, VeloCMS listens to the Stripe 'charge.refunded' event at the /api/stripe/webhook endpoint. This means refunds you initiate outside VeloCMS — say, directly in the Stripe Dashboard for some reason — also get picked up automatically. The webhook handler updates the order status, creates the refund record, and handles access revocation for digital orders. It's idempotent: if the same event arrives twice (Stripe does retry on transient failures), the second run is a no-op.

VeloCMS doesn't enforce a return window automatically — that would be too opinionated for the variety of things people sell. Instead, go to Admin → Settings → Store Policies and paste or write your return policy text. It renders on a /policies/returns page and is linked from the checkout footer automatically. Whether you offer 30-day no-questions-asked returns or a strict no-refund policy for custom work is entirely up to you; the platform just makes sure the policy text is discoverable by cu...

Physical returns and inventory

VeloCMS doesn't have a built-in returns management workflow for physical products — there's no 'mark as returned' button that automatically restocks inventory. The recommended flow: issue the Stripe refund from the order screen (which handles the money side), then manually adjust the inventory quantity on the relevant product variant once the item physically lands back with you. It's a two-step process, but it keeps inventory numbers accurate rather than restocking speculatively when the refu...

كيف أتعامل مع المبالغ المستردة وطلبات الإرجاع؟

لا أحد يستمتع بعمليات الاسترداد، غير أن التعامل معها بنظافة واحترافية يبني ثقة العملاء أسرع من كثير مما يمكنك فعله بوصفك صاحب متجر. يتيح لك VeloCMS إصدار مبالغ Stripe المستردة مباشرةً من شاشة تفاصيل الطلب — دون الحاجة إلى تسجيل الدخول في Stripe بشكل منفصل، ودون خطر الخطأ في المبلغ. كل شيء يبقى متزامنًا تلقائيًا.

إصدار استرداد كامل

انتقل إلى Admin → Orders وانقر على أي صف طلب لفتح عرض التفاصيل. في الزاوية العلوية اليمنى ستجد زر 'Refund'. انقر عليه فتنزلق لوحة تعرض إجمالي الطلب مملوءًا مسبقًا — ما عليك سوى التأكيد والضغط على 'Process refund'. يستدعي VeloCMS واجهة Stripe البرمجية بالمبلغ الكامل للرسوم، ويضع حالة الطلب على 'refunded'، ويُرسل بريد إشعار للعميل عبر Resend. تكتمل العملية بأسرها في ثانيتين أو ثلاث.

بالنسبة لطلبات المنتجات الرقمية، يُلغي الاسترداد الكامل تلقائيًا جميع روابط التنزيل المرتبطة بذلك الطلب. أي نقرة على رابط مُلغى تعيد استجابة 410 Gone. يحدث هذا في آنٍ واحد مع استدعاء Stripe — لا توجد فترة فاصلة قد يتمكن فيها أحد من النقر بين الاسترداد والإلغاء.

الاسترداد الجزئي

اللوحة ذاتها، لكن بدلًا من قبول الإجمالي المملوء مسبقًا، تكتب مبلغًا أقل. هذا مفيد للنزاعات المتعلقة بالشحن، أو عيوب المنتج البسيطة التي تقدم فيها خصمًا بنية حسن النية بدلًا من الإرجاع الكامل، أو حين توصلت مع العميل إلى حلٍّ وسط. تبقى حالة الطلب على 'completed' (إذ لم يُستردّ كاملًا)، ويظهر سجل الاسترداد في الجدول الزمني للطلب مُبيِّنًا المبلغ الجزئي والتوقيت والسبب. يمكنك إصدار مبالغ مستردة جزئية متعددة على طلب واحد طالما لم يتجاوز الإجمالي التراكمي قيمة الرسوم الأصلية — Stripe يفرض هذا السقف.

تُخصَم المبالغ المستردة مباشرةً من رصيد Stripe الخاص بك. إن كان رصيدك منخفضًا نسبةً إلى مبلغ الاسترداد، قد يؤجل Stripe المعالجة حتى يُجدّد رصيدك دورةُ الدفع التالية. تحقق من Stripe Dashboard → Balance قبل إصدار مبالغ مستردة كبيرة بصورة غير اعتيادية.

الـ webhook الخاص بالاسترداد

خلف الكواليس، يستمع VeloCMS إلى حدث 'charge.refunded' الصادر من Stripe على نقطة النهاية /api/stripe/webhook. هذا يعني أن المبالغ المستردة التي تُصدرها خارج VeloCMS — مثلًا مباشرةً من لوحة تحكم Stripe لأي سبب — تُرصَد تلقائيًا أيضًا. يُحدّث معالج الـ webhook حالة الطلب، وينشئ سجل الاسترداد، ويتولى إلغاء الوصول للطلبات الرقمية. العملية لا تكرارية: إن وصل الحدث ذاته مرتين (تُعيد Stripe المحاولة عند الأعطال العابرة)، تصبح الاستجابة الثانية عملية لا أثر لها.

سياسات الإرجاع

لا يفرض VeloCMS نافذة إرجاع تلقائيًا — فالتنوع الهائل في ما يبيعه الناس يجعل أي تقييد مسبق متعسفًا. بدلًا من ذلك، انتقل إلى Admin → Settings → Store Policies والصق نص سياسة الإرجاع الخاصة بك أو اكتبها. تظهر على صفحة /policies/returns وتُرفَق في تذييل صفحة الدفع تلقائيًا. سواء أتحت إرجاعًا لمدة 30 يومًا دون أسئلة، أو اعتمدت سياسة عدم الاسترداد الصارمة للأعمال المخصصة، فالقرار عائد إليك بالكامل؛ المنصة تضمن فحسب أن يتمكن العملاء من العثور على سياستك بسهولة.

الإرجاع المادي والمخزون

لا يمتلك VeloCMS سير عمل مدمجًا لإدارة مرتجعات المنتجات المادية — فلا يوجد زر 'mark as returned' يُعيد المخزون تلقائيًا. الإجراء الموصى به: أصدر الاسترداد عبر Stripe من شاشة الطلب (وهو يتولى الجانب المالي)، ثم عدّل كمية المخزون يدويًا على متغير المنتج المعني حين يعود الصنف فعليًا إليك. إنها خطوتان، لكنهما تحافظان على دقة أرقام المخزون بدلًا من إعادة إضافته استباقيًا عند إصدار الاسترداد.