كيف تربط سيريتل كاش بمتجرك الإلكتروني
ربط سيريتل كاش يمر عبر بوابة جاهزة: الزبون يدخل رقم العملية بعد التحويل، والموقع يتحقق من المبلغ ويمنع تكرار الرقم. دولاران للرقم شهريًا. ابدأ برقمك الحي، جرّب sandbox، ثم افتح الدفع بعد قائمة التحقق.
لماذا يبقى التأكيد على واتساب
أول متجر لمست فيه المشكلة بوضوح كان متجر ألبسة بحلب. الزبون يطلب من الموقع، يحوّل على رقم سيريتل كاش، ثم يرسل لقطة شاشة على واتساب. صاحب المتجر يفتح التطبيق، يقلّب العمليات، يطابق المبلغ، وبعدها يغيّر حالة الطلب ويجهّز الشحنة. يوم فيه عشرة طلبات يمشي الحال. يوم فيه أربعون، اللقطات تتراكم، وطلب يبقى معلّقًا لأن العملية وصلت والموظف كان مشغولًا في طلب آخر. وكل مرة يتكرر السؤال نفسه: كيف تربط سيريتل كاش بمتجرك الإلكتروني من غير ما يبقى التأكيد على واتساب؟
إظهار رقم المحفظة في صفحة الدفع لا يأخذ وقتًا طويلًا. التعب يأتي بعد التحويل، حين يطابق شخص كل عملية يدويًا. الربط الذي أقصده أبسط من صورته عند كثير من أصحاب المتاجر: رقم سيريتل كاش تملكه أصلًا، وبوابة دفع جاهزة أقدّمها تصل إلى حسابك، وكود في موقعك يستقبل رقم العملية من الزبون ويطلب من البوابة التحقق منه.
في البحث تظهر أحيانًا أخطاء إملائية في اسم المحفظة. الاسم الصحيح سيريتل كاش، وهو ما نستخدمه في الصفحات الرسمية.
التأكيد اليدوي يمشي إلى حد معيّن
شفت المشهد نفسه في مطعم بدمشق يستقبل طلبات التوصيل على موقعه، وفي صفحة إنستغرام تبيع ملابس عبر الرسائل ثم تطلب تحويلًا. الطريقة واحدة: يصل إشعار أو لقطة شاشة، وشخص يفتح التطبيق ويتأكد.
هذا ينهار لسببين عمليين. الأول السرعة: الزبون دفع وهو ينتظر، وأنت بين تطبيق المحفظة وواتساب ولوحة المتجر. الثاني الخطأ: مبلغان متقاربان في الدقيقة نفسها، أو لقطة لعملية قديمة. وأحيانًا يُشحن الطلب مرتين لأن موظفًا أكّده ثم أكّده زميله، أو لأن رقم عملية استُخدم على طلبين.
كتبت التدفق العام (طلب، دفع، مطابقة، تأكيد) في مقال التأكيد التلقائي. في المتجر الذي يستقبل سيريتل كاش، التفاصيل التي تفرق هي تجهيز الرقم، وطلب رقم العملية من الزبون، وما تفعله حين لا ينطبق المبلغ أو حين يُعاد استخدام نفس الرقم.
ما الذي تحتاجه قبل الربط
تحتاج رقم سيريتل كاش باسمك أو باسم النشاط. البوابة التي أقدّمها تتصل بحساب تملكه أصلًا؛ تسجيل الرقم نفسه ليس جزءًا منها. إذا ما عندك رقم بعد، ابدأ من فتح المحفظة وتفعيلها، وبعدين نأتي للواجهة.
والمتجر نفسه يجب أن يُنشئ طلبًا واضحًا قبل الدفع: مبلغًا، ورقم طلب، وحالة (بانتظار الدفع، مدفوع، يحتاج مراجعة، منتهٍ). يستوي أن يكون ووكومرس أو نظامًا مخصصًا أو بوت طلبات، بشرط أن يتولد الطلب قبل تحويل الزبون، وأن تتغيّر الحالة من جهة السيرفر لا من لقطة الشاشة.
تحويل سيريتل كاش لا يتيح حقل ملاحظة أو مرجع يكتبه الزبون. لا تطلب منه أن يكتب رقم الطلب داخل التحويل، لأن الحقل غير موجود. بعد الدفع يظهر له رقم العملية في التطبيق أو في الرسالة، وهذا الرقم هو ما يدخله في موقعك.
إذا كنت تطوّر من خارج سوريا، البوابة تعمل من دون وسيط سوري ومن دون VPN. وأبقِ في اللوحة زرًا للتأكيد أو الرفض يدويًا. الحالات الغريبة ستظهر ولو بعد أسابيع من عمل النظام بشكل سليم: رقم مكتوب خطأ، أو تحويل يصل قبل أن يعود الزبون إلى الصفحة.
سعر API سيريتل كاش معلن: دولاران للرقم في الشهر. لا توجد رسوم إعداد للرقم الواحد. ربط عدة أرقام في نظام واحد يُسعَّر بحسب احتياجك. الإعداد يتم في اليوم نفسه، ويمكن طلب وصول تجريبي (sandbox) حتى تجرّب التدفق على بيانات غير إنتاجية.
البوابة مستضافة لسيريتل كاش وشام كاش. بنيتها وأشغّلها بنفسي، والتسليم من دون كود مصدري. موقعك يتصل بالواجهة الجاهزة ويؤكد التحويل في نفس اليوم الذي يُعدّ فيه الربط.
تدفق الدفع من الطلب حتى التأكيد
زبون في متجر الألبسة يطلب قطعتين، والمجموع 85,000 ل.س. نظامك ينشئ الطلب بهذا المبلغ، ويعطيه رقمًا داخليًا، ويعرض رقم التحويل وتعليمات قصيرة: حوّل المبلغ كما هو، ثم اكتب رقم العملية الذي يظهر لك بعد نجاح التحويل.
الزبون يفتح سيريتل كاش ويحوّل إلى رقمك. بعد نجاح التحويل يأخذ رقم العملية ويدخله في صفحة الطلب أو في حقل التأكيد عندك. موقعك يرسل هذا الرقم إلى البوابة، والبوابة تُرجع العملية إن وُجدت: المبلغ، ووقت الوصول، ورقم العملية، ورقم المرسل. رقم المرسل يعود دائمًا مع كل تحويل. أحفظه على الطلب لأنه يفيد عند الدعم أو النزاع. لا أستخدمه كشرط للمطابقة؛ كثير من الزبائن يدفعون من محفظة أخ أو زميل.
المطابقة تتم هكذا. إذا كان رقم العملية مستخدمًا من قبل على طلب آخر، ارفضه ولا تعلّم الطلب الجديد مدفوعًا. إذا لم تظهر العملية بعد، لا تغلق الطلب ولا تستهلك الرقم؛ قد يكون الزبون أخطأ في الكتابة، أو التحويل لم يظهر بعد في الواجهة. اطلب منه أن ينتظر قليلًا ويعيد المحاولة، أو أن يراجع الرقم. إذا وُجدت العملية والمبلغ لا يساوي مبلغ الطلب، علّق الطلب للمراجعة، واربط رقم العملية بهذا الطلب حتى لا يُستخدم على طلب آخر. إذا وُجدت العملية والمبلغ ينطبق ولم يُستخدم الرقم من قبل، علّم الطلب مدفوعًا، واحفظ رقم العملية ورقم المرسل، وأَخطر الزبون وصاحب المتجر.
المهلة تحدّدها أنت. بعض المتاجر تعطي ساعة، وبعضها يبقي الطلب مفتوحًا حتى نهاية اليوم. المهم أن تكون القاعدة مكتوبة في النظام، لا متروكة لمزاج الوردية.
خطوات ربط سيريتل كاش بمتجرك الإلكتروني
أرسل عبر نموذج التواصل نوع المحفظة وعدد الأرقام. بعد الاتفاق تحصل على وصول لبوابة الدفع المستضافة. التسليم خدمة جاهزة، من دون تسليم كود مصدري. هذا يناسب من يريد أن يؤكد التحويلات برمجيًا من دون أن يشغّل قارئ محفظة بنفسه.
في الوصول التجريبي تُنشئ طلبات تجريبية، وتدفع (أو تُحاكي الدفع)، وتدخل رقم العملية، وتتأكد أن البوابة تُرجع العملية وأن المطابقة تغيّر الحالة كما توقعت. لا تنتقل للإنتاج قبل أن تجرب حالة النجاح وحالات اللبس: رقم عملية مكرّر، ومبلغ غير مطابق، ورقم لم يظهر بعد.
على السيرفر خزّن رقم العملية بعد استخدامه، وامنع معالجته مرة ثانية. اربط حالة المتجر بما يحدث بعد التأكيد. في ووكومرس مثلًا تنتقل من pending إلى processing أو completed حسب ما إذا كان المنتج رقميًا أو يحتاج شحنًا. اضبط إشعار الزبون (رسالة، بريد، أو تحديث صفحة الطلب) وإشعارك أنت، حتى لا تبقى تعتمد على تفقد اللوحة كل ربع ساعة.
من نفس الواجهة يمكن فحص الرصيد وحالة الحساب في لوحة داخلية. هذا لا يغني عن المطابقة برقم العملية، لكنه يفيدك إذا أردت أن ترى إن كان الرقم يستقبل كما يجب.
تفصيل المقارنة مع شام كاش، والسعر المنفصل لكل محفظة، موجود في مقال المقارنة بين الواجهتين.
كيف يتحدث موقعك مع بوابة الدفع
المثال التالي يوضح القرار في باك إندك: تستقبل رقم العملية من الزبون، تسأل البوابة عنه، ثم تقرر. العنوان YOUR_GATEWAY_URL وأسماء الحقول أمثلة تُستبدل بالقيم التي تصلك عند إعداد البوابة. لا تعتمد على مسار مخترع في الإنتاج.
```javascript // كيف يتحدث موقعك مع بوابة الدفع الجاهزة // استبدل YOUR_GATEWAY_URL وYOUR_API_KEY وأسماء الحقول بما يصلك عند الإعداد
async function confirmByTransactionId( { order, transactionId }, { usedTxIds, orders } ) { if (await usedTxIds.has(transactionId)) { return { status: "rejected", reason: "transaction_already_used" }; }
const response = await fetch("YOUR_GATEWAY_URL", { method: "POST", headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ transactionId }), });
const result = await response.json(); // حقول تقريبية في الرد: found, amount, receivedAt, senderNumber
if (!result || !result.found) { return { status: "not_found" }; }
if (Number(result.amount) !== Number(order.amount)) { await usedTxIds.add(transactionId); await orders.flagForReview({ orderId: order.id, transactionId, expected: order.amount, paid: result.amount, senderNumber: result.senderNumber, }); return { status: "wrong_amount", paid: result.amount }; }
await usedTxIds.add(transactionId); await orders.markPaid(order.id, { transactionId, paidAt: result.receivedAt, senderNumber: result.senderNumber, }); await notifyCustomerAndMerchant(order); return { status: "paid", orderId: order.id }; } ```
قبل الإنتاج أراجع ثلاثة قيود. رقم العملية يُحفظ بقيد فريد حتى لو أُعيد الضغط على زر التأكيد أو أُعيد إرسال الطلب بعد انقطاع شبكة. المبلغ يُقارن كعدد، لا كنص، حتى لا تفشل مقارنة 85000 مع 85000.00. ورقم المرسل يُحفظ ولا يُشترط تطابقه مع هاتف الفاتورة.
الإشعار يأتي بعد حفظ الحالة في قاعدة البيانات، لا قبله. إذا نجح markPaid وفشل الإشعار، تعيد الإرسال، ولا تعيد تعليم الطلب من جديد.
حالات تكسر التأكيد إذا لم تُعالَج
أكثر خطأ أراه: الزبون يكتب رقم العملية ناقصًا أو ينقل رقمًا من تحويل قديم. إذا لم تجد البوابة العملية، لا تخمّن طلبًا مفتوحًا بالمبلغ. أظهر رسالة واضحة: راجع الرقم، وانتظر دقيقة إن كان التحويل للتو، ثم أعد المحاولة.
إعادة استخدام رقم العملية أخطر من غلطة الكتابة. بلا جدول للأرقام المستخدمة، رقم واحد قد يُغلق طلبين إذا نسخه زبون آخر أو إذا أُعيد إرسال النموذج مرتين. ارفض الرقم المستخدم، واحتفظ بالأثر: لأي طلب ارتبط أول مرة، ومتى.
الدفع الناقص أو الزائد يحتاج قاعدة مكتوبة. لا تفترض السبب. قد يكون الزبون أخطأ في الرقم، أو حوّل على دفعتين، أو زاد مبلغًا عن قصد. علّق الطلب، واربط رقم العملية به حتى لا يُستعمل على طلب ثانٍ، وأبلغ الطرفين. الشحن أو التسليم لا يتم حتى ينطبق المبلغ على قاعدتك، أو حتى يؤكدها شخص من اللوحة.
الدفع المتأخر شائع. الزبون يبدأ التحويل قبل انتهاء المهلة، ثم يدخل الرقم بعدها بدقائق، أو يدفع بعد أن أُلغي الطلب لأنه انشغل. قرّر مسبقًا ماذا يحدث: مراجعة يدوية، أو رفض مع طلب تواصل لإعادة المبلغ أو إنشاء طلب جديد. أنا أميل إلى المراجعة اليدوية مع إشعار فوري لصاحب المتجر.
يبقى أن الزبون يحوّل ولا يعود إلى الصفحة ليكتب الرقم، أو يحوّل على رقم خطأ، أو من محفظة أخرى. البوابة ترى ما وصل إلى رقمك فقط. إذا كتب إنه دفع ولم يدخل رقم العملية، أو دخل رقمًا لا يظهر، استخدم التدقيق اليدوي في اللوحة. يمكنك أنت أن تدخل الرقم من لقطة الشاشة وتشغّل نفس التحقق.
طلبان بنفس المبلغ لا يفسدان المطابقة هنا، لأن المفتاح هو رقم العملية لا المبلغ وحده. المبلغ شرط تحقق بعد إيجاد العملية، لا أداة للتخمين بين الطلبات المفتوحة.
إذا كان متجرك على ووكومرس
كثير من شروحات ووردبريس تقف عند خطوة يدوية: بوابة تعرض رقم المحفظة، والزبون يرفع إثباتًا أو يكتب رقم العملية، ومدير المتجر يضغط تأكيد بعد أن يفتح التطبيق. هذا يعمل في البداية، ويضيق أول ما تزيد الطلبات. التأكيد التلقائي على ووكومرس يعني أن المتجر يأخذ رقم العملية من الزبون، يسأل البوابة عنه، ويغيّر حالة الطلب إذا انطبق المبلغ ولم يُستخدم الرقم من قبل.
لا تحتاج أن تعيد بناء المتجر. قائمة الطلبات في ووكومرس تبقى المصدر، وكود أو إضافة صغيرة تستدعي البوابة ثم تستعمل دوال الطلب لتحديث الحالة ومخزون المنتج. احتفظ داخل الطلب برقم العملية والمبلغ ووقت التأكيد ورقم المرسل. هذا يغنيك لاحقًا عن الرجوع إلى تطبيق المحفظة ساعة النزاع.
كتبت المقارنة بين المسار اليدوي والتلقائي، مع مثال خطاف، في سيريتل كاش على ووكومرس: يدوي أم تلقائي؟.
إذا كنت تبيع من موقع مطعم أو من نظام مخصص، المنطق نفسه. يتغيّر مكان حقل رقم العملية فقط: في صفحة الطلب، أو في بوت تيليغرام وواتساب إذا كان البيع أصلًا داخل المحادثة. باقة بوت الدفع عندي تبدأ من 120 دولارًا مرة واحدة، وتتصل بسيريتل كاش أو شام كاش بحسب السوق، وتؤكد الدفع داخل المحادثة. للمتجر على موقع، الاشتراك الشهري مع باك إندك عادةً يكفي.
قائمة تحقق قبل الإطلاق
أنسى أحيانًا بندًا واحدًا، فيُفتح الدفع والرقم ما زال تجريبيًا. لهذا أمرّ على القائمة التالية قبل أول زبائن حقيقيين:
- رقم سيريتل كاش مفعّل وأنت تملك الدخول إليه، والبوابة متصلة بهذا الرقم لا برقم تجريبي نُسي في الإنتاج.
- كل طلب يُنشأ بمبلغ ومهلة وحالة واضحة قبل أن يظهر رقم التحويل للزبون.
- في صفحة التأكيد حقل واضح لرقم العملية، وتعليمات بأن التحويل لا يحتاج ملاحظة.
- رقم العملية يُحفظ بقيد فريد، ويُرفض إذا أُعيد استخدامه على طلب آخر.
- المبلغ يُتحقق منه بعد إيجاد العملية، والدفع الناقص أو الزائد يدخل المراجعة ويُربط رقمه بهذا الطلب.
- رقم لم يظهر بعد لا يُستهلك، والزبون يستطيع إعادة المحاولة.
- رقم المرسل يُحفظ على الطلب ولا يُشترط تطابقه مع هاتف الفاتورة.
- في اللوحة زر تأكيد وزر رفض، مع أثر مكتوب (من أكّد، ومتى، وأي رقم عملية رُبط).
- إشعار الزبون وإشعارك يعملان بعد حفظ حالة "مدفوع"، مع إعادة محاولة إذا فشل الإرسال.
- جرّبت مسار النجاح ومسار اللبس في الوصول التجريبي: رقم صحيح، رقم مكرّر، مبلغ مختلف، ورقم غير موجود بعد.
إذا نقص بند من هذه القائمة، أُبقي التأكيد اليدوي موازيًا لأيام قليلة. أتمتة نصف جاهزة أسوأ من موظف يطابق عشر عمليات في اليوم.
أسئلة تتكرر
هل أحتاج رقم سيريتل كاش خاصًا بي؟
نعم. تربط رقمك الحالي، والبوابة تمنح تطبيقك وصولًا برمجيًا إليه. فتح الرقم وتسجيله عند الشركة ليسا جزءًا من الخدمة.
هل يكتب الزبون ملاحظة في التحويل؟
لا. تحويل سيريتل كاش ما فيه حقل ملاحظة. المطابقة تتم برقم العملية الذي يدخله الزبون في موقعك بعد الدفع.
هل يعمل هذا مع شام كاش في نفس المتجر؟
نعم. كثير من المتاجر التي يقبل عملاؤها المحفظتين تشترك في البوابتين. كل واحدة تُحاسب وتُدار بشكل منفصل. إذا كان هذا هو وضعك، كتبت خطوات شام كاش في مقال ربط شام كاش API بمتجرك.
ماذا لو دفع الزبون بعد إلغاء الطلب، أو دفع مبلغًا مختلفًا؟
لا تترك القرار للكود في اللحظة. اكتب القاعدة مسبقًا. مراجعة يدوية مع إشعار هي ما أنصح به في البداية. إذا وُجد رقم العملية ومبلغه مختلف، اربطه بالطلب المعلّق حتى لا يُستخدم في مكان آخر.
كم يستغرق الإعداد، وهل أجرب قبل الإنتاج؟
الإعداد يتم في اليوم نفسه. يمكن طلب وصول تجريبي قبل ربط الرقم الحي، حتى تختبر تدفق المطابقة على طلبات غير حقيقية.
بعد أن تجهز القائمة
إذا كان عملاؤك يدفعون بسيريتل كاش أصلًا، ابدأ بهذه المحفظة وحدها ومنتج واحد ومسار مراجعة يدوية للحالات الشاذة. بعد أسبوع من طلبات حقيقية تصير الثغرات أوضح من أي تجربة. ثم تضيف شام كاش إذا احتجتها، أو بوتًا إذا كان جزء من البيع يتم في المحادثة.
إذا بدك بوابة دفع جاهزة لسيريتل كاش، أو للمحفظتين مع بعض، راسلني من صفحة الموقع أو على fayezalshami.dev@gmail.com. اذكر نوع المحفظة، وعدد الأرقام، ونوع المتجر (ووكومرس، موقع مخصص، بوت).