متابعة الدفعات — الرابط المُرسَل والمتأخّر والمنتهي
سلّم الدفعات، وحالة كل رابط، ولماذا لا تُقيَّد الدفعة لمجرّد أن العميل قال «حوّلت».
٦ دقائقافتح الدرس
- الرئيسية
- المركز التعليمي
- المال
- تفعيل بوابة دفع — وحقولها كما تسمّيها هي
تفعيل بوابة دفع — وحقولها كما تسمّيها هي
كل بوابة تسمّي مفاتيحها باسمها الخاصّ. أين تجد كلاًّ منها، والفرق بين مفتاح التجربة والمفتاح الحيّ.
المال · ٧ دقائق قراءة
كل بوابة دفعٍ سعودية تسمّي مفاتيحها باسمها الخاصّ، وتطلب عدداً مختلفاً منها. وشاشة البوابات تكتبها كما تسمّيها البوابة في وثائقها لا كما يريحنا توحيدها — فالنسخ واللصق ينجح من أول مرّة.
هذا الدرس يقول أين تجد مفاتيح كل بوابة، والفرق بين مفتاح التجربة والمفتاح الحيّ، ولماذا لا يملك النظام تحديد مبلغٍ أبداً.
ابدأ بالتجربة دائماً
فعّل بمفتاح التجربة، وأصدر رابطاً، وافتحه بنفسك. ثم بدّل إلى المفتاح الحيّ — لا العكس.
المفاتيح
ما تطلبه كلُّ بوابة بالضبط
| البوابة | الحقول | ملاحظة |
|---|---|---|
| مُيسّر | المفتاح السرّي | يُستعمل اسمَ مستخدمٍ وكلمةُ المرور فارغة |
| Paylink | apiId و secretKey | يُبدَّلان بتوكن مؤقّت قبل كل طلب |
| تاب | المفتاح السرّي | ومنه تمرّ STC Pay كوسيلة دفع |
وبقيّة البوابات السعودية معروضةٌ في الشاشة بآليّاتها الصحيحة كي تعرف ما ينتظرك — وتُوصَل حين تطلبها.
التفعيل
خمس خطواتٍ من صفر إلى رابطٍ يعمل
- ١افتح لوحة البوابة وانسخ مفاتيح التجربة.
هي غالباً تحت «المطوّرون» أو «مفاتيح API». وانتبه: بعض البوابات تعرض المفتاح السرّي مرّةً واحدة فقط.
- ٢الصقها في صفّ البوابة وفعّل المفتاح.
الحقول مكتوبةٌ بأسمائها الأصلية، فلا تحتاج أن تخمّن أيَّ مفتاحٍ يذهب أين.
- ٣اعتمد عقداً تجريبياً.
ولا تُصدر الرابط يدوياً — دعه يخرج من مساره الطبيعي، فهذا ما تختبره فعلاً.
- ٤افتح الرابط على جوّالك.
وتأكّد أن المبلغ والوصف واسم نشاطك تظهر كما تريد أن يراها عميلك.
- ٥بدّل إلى المفتاح الحيّ.
ويطلب النظام إقراراً صريحاً قبل حفظه — لأن ما بعده يسحب من بطاقةٍ حقيقية.
الحارس
لا يملك النظام أداةً تقبل مبلغاً
هذا أهمّ سطرٍ في الدرس. لا توجد في النظام وظيفةٌ اسمها «أنشئ رابط دفع بمبلغ كذا» يستطيع النموذج استدعاءها. المبلغ يُقرأ من جدول دفعات العقد الذي اعتمدتَه أنت، ويؤلّف الكودُ رسالة الرابط ويرسلها.
والسبب أن نموذجاً يملك تحديد مبلغٍ هو نموذجٌ يملك قارئ بطاقات: تكفي رسالةٌ ذكيّة الصياغة من عميلٍ ليُصدر رابطاً بريالٍ واحد عن عقدٍ بعشرين ألفاً.
ولا يُصدَّق تأكيد الدفع من رسالة.
قول العميل «حوّلت» ليس دليلاً، ولا صورةُ إيصال. الدفعة تُقيَّد حين تؤكّدها البوابة نفسها — ثم يُعاد سؤالها مرّةً أخرى قبل القيد. تحقّق، لا تثق.
وما يحدث بعد ذلك في متابعة الدفعات.
أسئلة متكرّرة
ما الفرق بين مفتاح التجربة والمفتاح الحيّ؟
مفتاح التجربة يُنتج روابط دفعٍ تعمل شكلاً ولا تحرّك ريالاً — وهو ما تختبر به. والمفتاح الحيّ يسحب من بطاقة العميل فعلاً، ولهذا يطلب إقراراً صريحاً قبل حفظه.
هل يستطيع النظام تحديد المبلغ بنفسه؟
لا، ولا توجد أداةٌ تُمكّنه من ذلك. المبلغ يُقرأ من جدول دفعات العقد الذي اعتمدتَه أنت، ويؤلّف الكودُ رسالةَ الرابط. ونموذجٌ يملك تحديد مبلغٍ هو نموذجٌ يملك قارئ بطاقات.
الدرس التالي
اعتماد عرض سعر أو عقد — الخطوة التي لا يتخطّاها النظام
النظام يُجهّز المستند ولا يُصدره. لماذا الاعتماد يدويّ دائماً، وكيف تعتمد من واتساب في رسالة واحدة.
٧ دقائقافتح الدرس