- المساعدة
- الدفع والشحن
اربط باي لينك
معرّف API والمفتاح السري، ومفتاح وضع التجربة ومتى تطفئه، ورابطا الويبهوك، وأين يرجع المشتري بعد الدفع.
- 9 دقائق قراءة
- آخر تحديث: 2026-08-04
باي لينك (Paylink) بوابة دفع سعودية، وهي البديل الثاني لميسر في متجرك. هذا الشرح ينقل معرّفك ومفتاحك من لوحتهم إلى متجرك، ويجعلك تجرّب قبل أن تبيع بمال حقيقي.
قبل أن تبدأ
- حساب في باي لينك. يطلبون مستنداً نظامياً — سجل تجاري أو وثيقة عمل حر — وحساباً بنكياً، مثل أي بوابة مرخّصة. والشروط شروطهم هم، فاسأل دعمهم قبل أن تبدأ.
- صفحة تكامل API في لوحتهم. هناك المعرّف والمفتاح. الطريق: الإعدادات ← تكامل API.
- قرار: بوابة واحدة. اختيار باي لينك يلغي ميسر في هذا المتجر. مفاتيح ميسر تبقى محفوظة لكنها تتوقف عن العمل.
-
اختر باي لينك والصق المعرّف والمفتاح
افتح إعدادات المتجر ثم الدفع، واجعل صندوق البوابة على باي لينك. تظهر تحته كل حقول باي لينك دفعة واحدة.
معرّف API (API ID) اسم حسابك عند باي لينك، والمفتاح السري (Secret Key) كلمة السر التي تثبت أن الطلب قادم منك أنت. الاثنان في صفحة تكامل API في لوحتهم.
- 1 صندوق البوابة على باي لينك.
- 2 معرّف API (API ID) من لوحة باي لينك ← الإعدادات ← تكامل API.
- 3 المفتاح السري (Secret Key) من الصفحة نفسها. الخانة تخفي ما تكتبه.
- 4 مفتاح وضع التجربة. مطفأ في الصورة. شغّله قبل أول تجربة.
- 5 كلمة سر الويبهوك (اختياري). اتركها فارغة إن لم تضبط ويبهوك عندهم.
- 6 روابط الويبهوك. خانتان لا تُكتبان بيدك: انسخ منهما والصق في لوحة باي لينك.
يعمل أيضاً: بعد الحفظ تظهر شارة محفوظ بجانب المفتاح السري وتعود خانته فارغة. المفتاح لم يُحذف. اتركها فارغة ليبقى، أو اكتب مفتاحاً جديداً ليحل محله. -
شغّل وضع التجربة أولاً
وضع التجربة يحوّل كل اتصالاتنا إلى خادم باي لينك التجريبي بدل الخادم الحقيقي. لا ينتقل ريال واحد وأنت فيه. استعمله لتتأكد أن الربط سليم قبل أن يدفع مشترٍ حقيقي.
بعد تشغيله، افتح متجرك واشترِ منتجاً بنفسك حتى النهاية، ثم ارجع إلى طلبات المتجر وتأكد أن الطلب صار مدفوع.
تنبيه: أطفئ وضع التجربة قبل أول طلب حقيقي. متجر مفتوح للناس ووضع التجربة مُشغّل يعني أن أحداً لن يدفع لك شيئاً، والطلبات ستبدو مدفوعة وهي ليست كذلك. -
الصق رابطَي الويبهوك في لوحة باي لينك
الويبهوك رسالة يرسلها باي لينك إلى متجرك عند حدوث شيء. عندك رابطان:
الرابط ينتهي بـ أين تضعه الأول /paylink-webhook في ويبهوك الدفع داخل لوحة باي لينك. يخبر متجرك أن الطلب دُفع. الثاني /paylink-refund-webhook في ويبهوك الاسترجاع. يخبر متجرك أن مبلغاً أُعيد للمشتري. انسخ كل رابط من خانته كما هو. الخانتان للقراءة، فلا تقدر تغيّرهما بالخطأ.
- 1 مفتاح وضع التجربة. أطفئه قبل البيع الحقيقي.
- 2 رابط ويبهوك الدفع، ينتهي بـ /paylink-webhook.
- 3 رابط ويبهوك الاسترجاع، ينتهي بـ /paylink-refund-webhook.
- 4 زر حفظ إعدادات الدفع. لا شيء يُحفظ قبله.
-
انتقل إلى الوضع الحقيقي
حين ينجح طلب التجربة، افتح الشاشة مرة أخرى، أطفئ وضع التجربة، وضع معرّف API والمفتاح السري لحسابك الحقيقي عند باي لينك، ثم اضغط حفظ إعدادات الدفع.
بيانات التجربة وبيانات الحساب الحقيقي مختلفة عند باي لينك، فلا تنسَ استبدالها.
أين يرجع المشتري بعد الدفع
بعد أن يدفع المشتري في صفحة باي لينك، يعيده باي لينك إلى متجرك تلقائياً. هذا العنوان لا يُكتب في أي خانة. نبنيه لكل طلب وحده وننتهي بـ /paylink-callback.
فإن قرأت في مكان ما عن «رابط العودة» أو «الكولباك» ولم تجد له خانة في الشاشة، فهذا هو السبب. الخانتان اللتان تملأهما في لوحة باي لينك هما رابطا الويبهوك لا غير.
إذا لم ينجح
| ما تراه | معناه | ما تفعله |
|---|---|---|
| المشتري يصل إلى صفحة فشل الدفع فوراً بلا صفحة باي لينك | لم نستطع فتح فاتورة عندهم. غالباً المعرّف أو المفتاح خاطئ. | انسخ الاثنين من صفحة تكامل API مرة أخرى واحفظ. وتأكد أنهما من الوضع نفسه: تجربة مع تجربة، حقيقي مع حقيقي. |
| الدفع نجح والطلب ما زال غير مدفوع | ويبهوك الدفع غير مضاف في لوحتهم. | الصق الرابط الأول في ويبهوك الدفع عندهم، ثم جرّب طلباً جديداً. |
| كل الطلبات تنجح ولا يصل مال | وضع التجربة ما زال مُشغّلاً. | افتح الشاشة، أطفئه، ضع بيانات حسابك الحقيقي، واحفظ. |
| خانتا الويبهوك تعرضان عنواناً قديماً | غيّرت رابط متجرك بعد أن ربطت باي لينك. | انسخ العنوانين الجديدين من هنا واستبدلهما في لوحة باي لينك. |
| لا أعرف ماذا أضع في كلمة سر الويبهوك (اختياري) | لم تضبط ويبهوك بكلمة سر عندهم. | اتركها فارغة. اسمها يقول إنها اختيارية. |
| اخترت باي لينك فاختفت حقول ميسر | هذا هو المقصود. المتجر يعمل ببوابة واحدة. | لا تفعل شيئاً. مفاتيح ميسر تبقى محفوظة وتعود إن رجعت إليها. |
أسئلة شائعة
ميسر أم باي لينك؟
الاثنان مرخّصان ويقبلان مدى والبطاقات. القرار عملي: أيهما أعطاك نسبة أفضل، وأيهما وافق على أوراقك أسرع. المقارنة الكاملة في اختر بوابة الدفع.
هل أستطيع تشغيل الاثنين معاً؟
لا. صندوق البوابة يقبل واحدة. لكن التحويل البنكي يعمل مع أي منهما.
هل ينفع وضع التجربة على متجر منشور؟
ينفع تقنياً ويضرّك عملياً. أي مشترٍ حقيقي يمرّ في تلك اللحظة سيُسجَّل طلبه كمدفوع بلا مال. جرّب بسرعة، ثم أطفئه.
أين أضع رابط العودة (الكولباك)؟
لا تضعه في أي مكان. نبنيه لكل طلب تلقائياً. الخانتان اللتان تملأهما عندهم هما ويبهوك الدفع وويبهوك الاسترجاع.
هل الاسترجاع يعمل من داخل متجري؟
نعم، من صفحة الطلب. ولهذا يوجد رابط ويبهوك ثانٍ: باي لينك يخبر متجرك حين يتم الاسترجاع فعلاً، فتتحدّث حالة الطلب وحدها.
غيّرت المفتاح السري عندهم. هل يتوقف متجري؟
نعم، حتى تلصق المفتاح الجديد هنا وتحفظ. المفتاح القديم يتوقف عن العمل في اللحظة نفسها.
الخطوة التالية
باي لينك يعمل. أكمل صورة الدفع:
- ما يراه المشتري عند الدفع — ما يحدث بعد ضغط تأكيد الطلب.
- التحويل البنكي — طريقة ثانية تعمل بجانب باي لينك.
- اربط ميسر — البوابة الأخرى، إن أردت المقارنة.
- اختر بوابة الدفع — الشاشة كلها في صفحة واحدة.
هل ساعدك هذا الشرح؟
إن بقي عندك سؤال، تواصل معنا من صفحة الدعم.