الدفع بالبريد

تدفّق الدفع بالبريد

1. ينقر المشتري زر Coin Moebius على موقعك ويختار "الدفع بالبريد" في القائمة. يرون معاينة أولاً: عنوانك البريدي، والمبلغ المستحق، وأي تعليمات ضبطتها، مع زر <strong>"أؤكّد، سأرسل الدفعة"</strong>. ولا شيء يُسجَّل بعد، ولا رمز مرجعي في هذه المرحلة.
2. ينقر المشتري "أؤكّد، سأرسل الدفعة." تلك هي الخطوة التي تنشئ المعاملة: يولّد Coin Moebius رمزاً مرجعياً فريداً مثل X2M-K9P-R7QW ويعرضه بجانب عنوانك البريدي. ويضع المشتري الرمز المرجعي داخل الطرد أو على الشيك.
3. بمجرد تأكيدهم، يظهر صف في تبويب المعاملات بلوحة تحكمك بحالة pending_manual. ويعرض أعلى القائمة أيضاً تنبيهاً يذكّرك بأن تأكيدات الدفعات البريدية تنتظر.
4. حين تصل دفعة المشتري إلى صندوق بريدك (نقد، أو شيك، أو Goldback، أو أياً كانت العملة المتوقعة)، اكتب الرمز المرجعي في صندوق البحث بتبويب المعاملات لإيجاد الصف المطابق. انقر تأشير بالاستلام. يُطلَق عنوان نجاح المشتري (فيحصلون على صفحة تأكيد)، وتتابع لشحن ما اشتروه.
5. إن لم تصل دفعة المشتري أبداً، تنتهي صلاحية الصف تلقائياً بعد 30 يوماً. ويمكنك أيضاً إلغاء صف يدوياً قبل ذلك.
6. إن أكّدت الاستلام لكنك اكتشفت لاحقاً أن الدفعة غير صالحة (مزيّفة، أو صنف خاطئ، أو مظروف فارغ)، فانقر تراجع عن التأكيد على الصف. تتغير الحالة إلى manual_revoked. هذا يصحّح سجلاتك في لوحة التحكم. والتواصل مع المشتري بشأن ما يحدث بعد ذلك بينك وبينه.

اختبار الدفع بالبريد

الدفع بالبريد بلا بيئة اختبار، ولا مفاتيح اختبار، ولا حساب خارجي للتهيئة. يحدث التدفّق كله بين موقعك ولوحة تحكمك. وهناك طريقتان لاختباره: الجولة الكاملة من زر شراء على صفحة، أو اختبار سريع مباشرة من لوحة التحكم.

اختبار سريع من لوحة التحكم

تستطيع لوحة التحكم إنشاء معاملة اختبار لأي مزود دون إشراك دفعة حقيقية. وهذا مفيد لرؤية كيف يبدو صف معاملة، أو التمرّن على تدفّق "تأشير بالاستلام" للدفع بالبريد، أو معاينة كيف تظهر دفعة عملة رقمية في قائمتك قبل إنفاق مال حقيقي.

1. افتح تبويب المعاملات على مشروعك وانقر إرسال حدث اختبار.
2. اختر منتجاً، واختر ما حدث (دفعة، أو مبلغ مسترد، أو دفع بالبريد، أو تجديد اشتراك)، واختر المزود الذي تريد محاكاته (Stripe، أو NOWPayments، أو الدفع بالبريد). ولأحداث الدفع بالبريد، يُضبَط المزود تلقائياً.
3. انقر إرسال حدث الاختبار. يظهر صف جديد موسوم بـ "test" فلا يختلط بالبيانات الحية. ويظهر الصف تحت مرشّح المزود الصحيح، تماماً كما تفعل معاملة حقيقية.

للدفع بالبريد تحديداً، اختر "طلب دفع بالبريد ينتظر" لإنشاء صف pending_manual برمز مرجعي حقيقي. ويمكنك حينها التمرّن على النقر على "تأشير بالاستلام،" و"إلغاء،" و"تراجع عن التأكيد" عليه.

أحداث الاختبار لا تُحتسَب ضمن حصة معاملاتك الشهرية.

الجولة الكاملة من زر شراء

لاختبار التدفّق الكامل (ما يراه مشتريك حتى ما تراه أنت)، سر عبر هذه الخطوات. يستغرق كل ذلك نحو دقيقتين.

1. أعدّ المزود. في لوحة تحكمك، اذهب إلى تبويب المزودين بمشروعك وانقر "إضافة مزود" → الدفع بالبريد. أدخل أي عنوان بريدي (عنوانك جيد للاختبار) وأي عملة (مثل USD، أو GBK). احفظ.
2. أضف منتجاً. في تبويب المنتجات، أنشئ منتجاً باسم مثل "صنف اختبار" وسعر. واضبط العملة لتطابق ما أدخلته للمزود.
3. ضع زر الشراء على صفحة. الصق HTML زر الشراء على أي صفحة، حتى ملف HTML مجرد على حاسوبك. وجّه خاصية endpoint إلى عنوان مشروعك في الـ Cloud. وإن كنت تشغّل الـ worker محلياً، فاستخدم http://localhost:8787 بدلاً من ذلك.
4. انقر الزر واختر "الدفع بالبريد." تفتح القائمة عارضةً كل مزود ربطته. اختر "الدفع بالبريد." سترى معاينة بعنوانك البريدي، والمبلغ والعملة المتوقعَين، وزر "أؤكّد، سأرسل الدفعة". ولا رمز مرجعي بعد.
5. انقر "أؤكّد، سأرسل الدفعة." هذا التزام المشتري بإرسال الدفعة. يسجّل Coin Moebius المعاملة ويعرض رمزاً مرجعياً مثل X2M-K9P-R7QW.
6. افتح لوحة التحكم. اذهب إلى تبويب المعاملات. يظهر صف جديد بحالة pending_manual وبالرمز المرجعي نفسه الذي رأيته للتو. وإن كان هذا أول صف معلّق لك، فإن تنبيهاً أعلى القائمة يذكّرك بأن الدفعات البريدية تنتظر التأكيد.
7. انقر "تأشير بالاستلام." تتغير حالة الصف إلى succeeded. تلك هي المسار السعيد الكامل، من نقرة المشتري إلى تأكيدك.

إيجاد معاملة بالرمز المرجعي

حين تصل دفعة إلى صندوق بريدك، ابحث عن الرمز المرجعي الذي أرفقه المشتري (مطبوعاً على المظروف، أو مكتوباً على مذكرة الشيك، أو مدسوساً داخل الطرد). ثم اكتب ذلك الرمز في صندوق البحث بتبويب المعاملات واضغط Enter. يرشّح الجدول الصفوف المطابقة فيمكنك النقر على "تأشير بالاستلام" على الصف الصحيح دون تصفّح كامل تاريخ معاملاتك.

اختبار النتائج الأخرى

سر عبر الخطوات نفسها مجدداً، لكن بدلاً من تأشير الصف بالاستلام، جرّب كلاً من هذه:

• ألغِه. انقر "إلغاء" على الصف المعلّق. تتغير الحالة إلى manual_canceled. هذا ما ستفعله حين يخبرك مشترٍ بأنه غيّر رأيه قبل إرسال أي شيء بالبريد.
• دعه ينتهي. اترك صفاً معلّقاً وشأنه. بعد 30 يوماً تنتهي صلاحيته تلقائياً إلى manual_expired. ولا تحتاج إلى انتظار 30 يوماً للتحقق من السلوك. ويعمل الانتهاء كما يعمل الإلغاء، إلا أنه يحدث تلقائياً وفق جدول.
• أدخل مبلغاً مختلفاً. عند النقر على "تأشير بالاستلام،" أدخل مبلغاً مستلَماً يختلف عمّا كان متوقعاً (مثلاً أرسل المشتري 4 Goldbacks بدلاً من 5). تنجح المعاملة رغم ذلك، لكن لوحة التحكم تُظهر المبلغين المتوقع والمستلَم فتعكس سجلاتك ما وصل فعلاً.
• تراجع عن تأكيد. أشّر أولاً بصف بالاستلام فيظهر succeeded، ثم انقر "تراجع عن التأكيد" على ذلك الصف. تتغير الحالة إلى manual_revoked. هكذا تصحّح خطأً أو تعلّم دفعة تبيّن أنها غير صالحة لاحقاً.

ما الذي تبحث عنه

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

معاملات الجولة الكاملة المنشأة أثناء الاختبار تُحتسَب ضمن حصتك الشهرية. وعلى الطبقة المجانية (150 معاملة/شهرياً)، حفنة من جولات الاختبار لن تُحدِث أثراً. أما أحداث الاختبار المرسَلة من زر "إرسال حدث اختبار" في لوحة التحكم فلا تُحتسَب إطلاقاً.