- المساعدة
- الدفع والشحن
اربط تلر
تلر بوابة بطاقات تعمل في السعودية والإمارات والبحرين والأردن. رقم المتجر ومفتاح التوثيق وكلمة سر الويبهوك وأين تجدها، وماذا يفعل وضع التجربة.
- 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 افتح إعدادات المتجر ثم الدفع، واختر تلر.
- 2 تحت خانة كلمة سر الويبهوك يظهر رابط الويبهوك جاهزاً. انسخه كما هو، لا تكتبه بيدك. ينتهي بـ /telr-webhook.
- 3 افتح لوحة تلر، ثم Payment Page أو Security، وابحث عن Transaction advice. الصق الرابط هناك.
- 4 في الشاشة نفسها عندهم ستجد كلمة سر الويبهوك. احفظ الكلمة نفسها عندنا في خانة كلمة سر الويبهوك، ثم احفظ.
التوقيع وحده لا يكفي عندنا. حتى حين يصل التوقيع صحيحاً، لا نصدّق مبلغ الرسالة. نسأل تلر مرة أخرى عن الطلب، ولا نكتب مدفوع إلا إذا وافق جوابها على مبلغ طلبك وعملته. هذه هي القاعدة نفسها المتّبعة مع ميسر وباي لينك.
لكل متجر رابط ويبهوك خاص به. إن كان عندك أكثر من متجر، افتح شاشة الدفع داخل كل متجر وانسخ رابطه هو. ورابط الويبهوك يحتاج متجراً منشوراً على الإنترنت: تلر لا تصل إلى جهازك أنت.
الشاشة اليوم
افتح إعدادات المتجر ثم الدفع. صندوق البوابة فيه ميسر وباي لينك وتلر وبدون بوابة (تحويل بنكي فقط)، وتحته التحويل البنكي. اختر تلر فتفتح حقول مفاتيحها تحته مباشرة، واحفظ. تحت الحقول يظهر رابط الويبهوك في خانة للقراءة فقط: انسخه والصقه في لوحة تلر كما في القسم السابق.
بعد الحفظ، وإن كانت عملة متجرك واحدة من الأربع أعلاه، يرى المشتري بطاقة في صفحة إتمام الطلب. وإن كانت عملتك غير ذلك، يظهر لك فوق الصندوق تنبيه الدفع بالبطاقة غير جاهز بعملة متجرك، ويدفع المشتري بالتحويل البنكي.
تقدر كذلك تُشغّل التحويل البنكي بجانب تلر، فيرى المشتري الطريقتين ويأخذ ما يريحه. وإن فضّلت بوابة أخرى فاقرأ اربط ميسر أو اربط باي لينك.
أسئلة شائعة
اخترت تلر وحفظت المفاتيح، فلماذا لا يرى المشتري البطاقة؟
سببان. الأول أن عملة متجرك ليست واحدة من الأربع (SAR، AED، BHD، JOD)، وعندها تقرأ فوق صندوق البوابة تنبيه الدفع بالبطاقة غير جاهز بعملة متجرك. الثاني أن إحدى الخانتين فارغة: رقم المتجر أو مفتاح التوثيق. املأ الاثنتين واحفظ، ثم جرّب طلباً بنفسك.
هل أستطيع تشغيل تلر مع ميسر أو باي لينك معاً؟
لا. صندوق البوابة يقبل بوابة واحدة، وتلر واحدة من الثلاث. لكن التحويل البنكي يعمل بجانب أي بوابة.
بأي عملة تعمل تلر؟
بأربع عملات: SAR وAED وBHD وJOD — السعودية والإمارات والبحرين والأردن. وهي الوحيدة بين بواباتنا التي تخرج من السعودية: ميسر وباي لينك بوابتان سعوديتان تعملان بالريال السعودي.
هل كلمة سر الويبهوك إجبارية؟
إجبارية إن أردت الويبهوك. بدون كلمة السر نرفض رسائل الويبهوك، لأن تلر توقّع كل رسالة بها ولا نستطيع التحقق من التوقيع بدونها. اتركها فارغة فقط إن لم تضبط Transaction advice عندهم أصلاً. في هذه الحالة تتأكد الطلبات عند رجوع المشتري إلى متجرك، ويضيع الطلب الذي أغلق صاحبه اللسان.
أين خانة الويبهوك في لوحة تلر؟ لا أجد كلمة webhook.
لأن اسمها عندهم Transaction advice، لا webhook. ابحث عنها في Payment Page أو Security. أسماء الصفحات قد تتغيّر عندهم، لكن هذه الكلمة هي الثابتة.
أين أضع رابط العودة بعد الدفع؟
في أي مكان. نبني هذا العنوان لكل طلب وحده، كما نفعل مع باي لينك. الخانات التي تملأها بيدك هي قيم حسابك فقط.
ماذا يحدث لمفاتيح ميسر أو باي لينك إن انتقلت إلى تلر لاحقاً؟
تبقى محفوظة كما هي وتتوقف عن العمل، وتعود إن رجعت إليها. حفظ مفاتيح بوابة لا يمسّ مفاتيح غيرها أبداً.
الخطوة التالية
بعد أن تحفظ مفاتيحك:
- اختر بوابة الدفع — الشاشة كلها في صفحة واحدة.
- اربط ميسر — المفاتيح ورابط الويبهوك خطوة بخطوة.
- اربط باي لينك — المعرّف والمفتاح ووضع التجربة.
- التحويل البنكي — طريقة تعمل بلا أي بوابة.
- دفع المشتري ولم يتأكد الطلب — ماذا تفعل حين يبقى طلب مدفوع مكتوباً عليه غير مدفوع.
هل ساعدك هذا الشرح؟
إن بقي عندك سؤال، تواصل معنا من صفحة الدعم.