1. المساعدة
  2. الدفع والشحن
الدفع والشحن

اربط تلر

تلر بوابة بطاقات تعمل في السعودية والإمارات والبحرين والأردن. رقم المتجر ومفتاح التوثيق وكلمة سر الويبهوك وأين تجدها، وماذا يفعل وضع التجربة.

  • 6 دقائق قراءة
  • آخر تحديث: 2026-09-21

تلر (Telr) بوابة دفع تعمل في الإمارات والسعودية والبحرين والأردن. هذا الشرح يجعلك تجمع بياناتها وتحفظها في متجرك.

تنبيه مهم: تظهر تلر الآن في صندوق البوابة، وتلر مفتوحة الآن للمشترين. بعد أن تختارها وتحفظ مفاتيحها يرى المشتري البطاقة في صفحة الدفع — بشرط واحد: أن تكون عملة متجرك واحدة من الأربع التي تعمل بها تلر.

في أي دولة تعمل تلر؟

تلر تعمل في أربع دول، وعملة متجرك هي التي تقرر. والعملة تأتي من دولة الشحن التي اخترتها عند إنشاء المتجر، ولا تتغير بعدها.

الدولةالعملةهل تعمل تلر؟
السعوديةSARنعم
الإماراتAEDنعم
البحرينBHDنعم
الأردنJODنعم
أي دولة أخرىغير هذه الأربعلا. المشتري يدفع بـالتحويل البنكي
مهم: إن كانت عملة متجرك غير هذه الأربع، فلن تظهر البطاقة للمشتري مهما أدخلت من مفاتيح صحيحة. هذا مقصود: بوابة لا تستطيع تحصيل عملتك تعني مشترياً يدفع ولا يصل طلبه. شغّل التحويل البنكي، واقرأ الدولة والعملة.

الدينار البحريني والدينار الأردني يُكتبان بثلاث خانات بعد الفاصلة، مثل 9.500 لا 9.50. الرقم نفسه يظهر في صفحة إتمام الطلب، وفي صفحة تلر، وفي الطلب، وفي الفاتورة. لا تقلق إن رأيت خانة زائدة: هذه هي عملتك.

قبل أن تبدأ

  • حساب تاجر في تلر. الحساب حسابك أنت، مثل باي لينك وميسر تماماً. المال يذهب إلى حسابك مباشرة، ولا نلمسه نحن.
  • مستند نظامي وحساب بنكي. الشروط شروطهم هم، فاسأل دعمهم قبل أن تبدأ. هذا يأخذ أياماً عادةً، فابدأه مبكراً.
  • صفحة التكاملات في لوحتهم. منها تأخذ القيم الثلاث أدناه. ابحث عن Integrations.

القيم الثلاث التي ستحتاجها

القيمةما هيأين تجدها
رقم المتجر (Store ID) رقم يعرّف متجرك عندهم. ليس سراً، وستراه في الشاشة بعد حفظه. لوحة تلر ← Integrations.
مفتاح التوثيق (Auth Key) سر. يثبت أن الطلب قادم من متجرك أنت لا من غيره. الصفحة نفسها، بجانب رقم المتجر.
كلمة سر الويبهوك سر أيضاً. تلر توقّع كل رسالة ويبهوك بها، ونحن نتأكد من التوقيع قبل أن نصدّق الرسالة. لوحة تلر ← Payment Page أو Security، في الخانة نفسها التي تضع فيها رابط الويبهوك.

السران لا يُعرضان مرة أخرى بعد حفظهما. تظهر بجانب كل واحد شارة محفوظ وتعود خانته فارغة. المفتاح لم يُحذف: اتركها فارغة ليبقى، أو اكتب مفتاحاً جديداً ليحل محله. هذه هي القاعدة نفسها المتّبعة مع ميسر وباي لينك.

أسماء الصفحات داخل لوحة تلر قد تتغيّر عندهم. ابحث عن الكلمتين Store ID وAuth Key، فهما الاسمان الثابتان.

ما يفعله وضع التجربة

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

تنبيه: أطفئ وضع التجربة قبل أول طلب حقيقي. متجر مفتوح للناس ووضع التجربة مُشغّل يعني أن أحداً لن يدفع لك شيئاً، والطلبات ستبدو مدفوعة وهي ليست كذلك.

رابط الويبهوك: انسخه من عندنا والصقه عندهم

الويبهوك رسالة ترسلها تلر إلى متجرك بمجرد أن ينتهي الدفع، من غير حاجة إلى المشتري. هو الطريق الاحتياطي للمشتري الذي دفع ثم أغلق اللسان قبل أن يرجع إلى متجرك. بدونه تبقى بعض الطلبات غير مدفوعة وهي مدفوعة فعلاً.

  1. 1 افتح إعدادات المتجر ثم الدفع، واختر تلر.
  2. 2 تحت خانة كلمة سر الويبهوك يظهر رابط الويبهوك جاهزاً. انسخه كما هو، لا تكتبه بيدك. ينتهي بـ /telr-webhook.
  3. 3 افتح لوحة تلر، ثم Payment Page أو Security، وابحث عن Transaction advice. الصق الرابط هناك.
  4. 4 في الشاشة نفسها عندهم ستجد كلمة سر الويبهوك. احفظ الكلمة نفسها عندنا في خانة كلمة سر الويبهوك، ثم احفظ.
مهم: بدون كلمة السر نرفض رسائل الويبهوك. تلر توقّع كل رسالة بكلمة السر، ونحن نتحقق من التوقيع قبل أن نصدّق الرسالة. إن كانت الخانة عندنا فارغة، أو كانت كلمة سر مختلفة عن التي عندهم، فلا يمكننا التحقق، فنرفض الرسالة ولا نغيّر الطلب. الطلبات تبقى تتأكد عند رجوع المشتري إلى متجرك، لكن الطريق الاحتياطي يكون مقفلاً.

التوقيع وحده لا يكفي عندنا. حتى حين يصل التوقيع صحيحاً، لا نصدّق مبلغ الرسالة. نسأل تلر مرة أخرى عن الطلب، ولا نكتب مدفوع إلا إذا وافق جوابها على مبلغ طلبك وعملته. هذه هي القاعدة نفسها المتّبعة مع ميسر وباي لينك.

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

الشاشة اليوم

افتح إعدادات المتجر ثم الدفع. صندوق البوابة فيه ميسر وباي لينك وتلر وبدون بوابة (تحويل بنكي فقط)، وتحته التحويل البنكي. اختر تلر فتفتح حقول مفاتيحها تحته مباشرة، واحفظ. تحت الحقول يظهر رابط الويبهوك في خانة للقراءة فقط: انسخه والصقه في لوحة تلر كما في القسم السابق.

بعد الحفظ، وإن كانت عملة متجرك واحدة من الأربع أعلاه، يرى المشتري بطاقة في صفحة إتمام الطلب. وإن كانت عملتك غير ذلك، يظهر لك فوق الصندوق تنبيه الدفع بالبطاقة غير جاهز بعملة متجرك، ويدفع المشتري بالتحويل البنكي.

شاشة إعدادات المتجر وقد فُتح فيها قسم الدفع لمتجر الدليل، ويظهر فيها صندوق اختيار البوابة، ومفتاح تفعيل التحويل البنكي وحقول الآيبان واسم البنك واسم صاحب الحساب.
شاشة الدفع. صندوق البوابة يقبل تلر الآن، والصورة أُخذت قبل إضافتها.

تقدر كذلك تُشغّل التحويل البنكي بجانب تلر، فيرى المشتري الطريقتين ويأخذ ما يريحه. وإن فضّلت بوابة أخرى فاقرأ اربط ميسر أو اربط باي لينك.

أسئلة شائعة

اخترت تلر وحفظت المفاتيح، فلماذا لا يرى المشتري البطاقة؟

سببان. الأول أن عملة متجرك ليست واحدة من الأربع (SAR، AED، BHD، JOD)، وعندها تقرأ فوق صندوق البوابة تنبيه الدفع بالبطاقة غير جاهز بعملة متجرك. الثاني أن إحدى الخانتين فارغة: رقم المتجر أو مفتاح التوثيق. املأ الاثنتين واحفظ، ثم جرّب طلباً بنفسك.

هل أستطيع تشغيل تلر مع ميسر أو باي لينك معاً؟

لا. صندوق البوابة يقبل بوابة واحدة، وتلر واحدة من الثلاث. لكن التحويل البنكي يعمل بجانب أي بوابة.

بأي عملة تعمل تلر؟

بأربع عملات: SAR وAED وBHD وJOD — السعودية والإمارات والبحرين والأردن. وهي الوحيدة بين بواباتنا التي تخرج من السعودية: ميسر وباي لينك بوابتان سعوديتان تعملان بالريال السعودي.

هل كلمة سر الويبهوك إجبارية؟

إجبارية إن أردت الويبهوك. بدون كلمة السر نرفض رسائل الويبهوك، لأن تلر توقّع كل رسالة بها ولا نستطيع التحقق من التوقيع بدونها. اتركها فارغة فقط إن لم تضبط Transaction advice عندهم أصلاً. في هذه الحالة تتأكد الطلبات عند رجوع المشتري إلى متجرك، ويضيع الطلب الذي أغلق صاحبه اللسان.

أين خانة الويبهوك في لوحة تلر؟ لا أجد كلمة webhook.

لأن اسمها عندهم Transaction advice، لا webhook. ابحث عنها في Payment Page أو Security. أسماء الصفحات قد تتغيّر عندهم، لكن هذه الكلمة هي الثابتة.

أين أضع رابط العودة بعد الدفع؟

في أي مكان. نبني هذا العنوان لكل طلب وحده، كما نفعل مع باي لينك. الخانات التي تملأها بيدك هي قيم حسابك فقط.

ماذا يحدث لمفاتيح ميسر أو باي لينك إن انتقلت إلى تلر لاحقاً؟

تبقى محفوظة كما هي وتتوقف عن العمل، وتعود إن رجعت إليها. حفظ مفاتيح بوابة لا يمسّ مفاتيح غيرها أبداً.

الخطوة التالية

بعد أن تحفظ مفاتيحك:

هل ساعدك هذا الشرح؟

إن بقي عندك سؤال، تواصل معنا من صفحة الدعم.

اقرأ أيضاً

← كل الشروحات