انتقل إلى المحتوى
10 أيام مجاناً عند أول تسجيل

واجهة API واحدة لربط شام كاش وسيريتل كاش

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

لا حاجة لأي دفعة للبدء. تجربة مجانية واحدة لكل شخص.

  • REST + JSON
  • شام كاش وسيريتل كاش
  • PHP · Node.js · Python
GET /api/v1?resource=status
$ curl "https://api.eaglebot99.com?resource=status" \
    -H "X-Api-Key: YOUR_API_KEY"

{
  "success": true,
  "message": "API is working.",
  "user": { "id": 123, "name": "Your Name", "email": "[email protected]" },
  "limits": { "max_linked_accounts": 5 }
}
طلب حقيقي على هذا الموقع بمفتاحك الخاص.

مناسبة لـ

  • المواقع الإلكترونية
  • المتاجر الإلكترونية
  • الأنظمة الداخلية
  • بوتات المحادثة
  • الشركات والأفراد
عن المنصّة

ما هي هذه المنصّة؟ شرح كامل

منصّة وسيطة بين حساباتك في شام كاش (ShamCash) وسيريتل كاش (Syriatel Cash، وتُكتب أحياناً «سيرياتيل كاش») وبين برامجك: تربط محافظك مرة واحدة، فيصبح موقعك أو متجرك أو تطبيقك أو بوتك قادراً على قراءة الرصيد والحوالات والتحقّق من الدفعات وإرسال التحويلات بطلب API بسيط، بدل فتح التطبيق ومراجعة كل حوالة يدوياً.

المشكلة: التحقّق اليدوي من الدفعات

حين يدفع لك العميل بشام كاش أو سيريتل كاش عليك أن تفتح التطبيق وتبحث عن الحوالة وتطابق المبلغ ثم تؤكّد الطلب بنفسك، وغالباً بالاعتماد على صورة شاشة يرسلها العميل وقد تكون مزوّرة. ومع ازدياد الطلبات يصبح ذلك بطيئاً ومكلفاً وعرضة للأخطاء.

الحل: ربط مباشر لمحافظك ببرامجك

تربط حسابك في شام كاش بمسح رمز QR، ورقمك في سيريتل كاش بكلمة سر حسابك ورمز SMS. تحفظ المنصّة جلسة الربط مشفّرة، وتقرأ سجل حسابك نفسه، وتحفظ كل حوالة في أرشيف قابل للبحث. يستدعي موقعك الـ API بمفتاحه الخاص ويحصل على إجابة JSON واضحة: هل وصلت الدفعة، وبأي مبلغ، ومن أرسلها، ومتى.

ما لا تفعله المنصّة

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

أمثلة على الاستخدام

  • متجر إلكتروني يقبل الدفع بشام كاش وسيريتل كاش

    يحوّل العميل ثمن طلبه ويُدخل رقم العملية، فيتحقّق المتجر منها عبر الـ API ويؤكّد الطلب فوراً دون مراجعة يدوية.

  • بوت تيليغرام أو واتساب لتأكيد الدفع

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

  • إضافة الرصيد تلقائياً في تطبيقك أو منصّتك

    بعد التحقّق من الحوالة يضيف نظامك المبلغ إلى حساب المستخدم دون تدخّل أي موظّف.

  • المحاسبة ومطابقة الحوالات

    اسحب سجل الحوالات الواردة والصادرة إلى نظامك المحاسبي، وابحث في الأرشيف وصدّره متى احتجت.

  • عدة حسابات من لوحة واحدة

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

  • إرسال التحويلات من برنامجك

    أرسل تحويلات شام كاش وسيريتل كاش عبر الـ API، مع حماية من الإرسال المكرّر عند إعادة المحاولة.

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

شام كاش · ShamCash

API شام كاش: اربط حساب شام كاش بموقعك وتحقّق من الحوالات تلقائياً

شام كاش محفظة إلكترونية منتشرة في سوريا لإرسال الأموال واستقبالها والدفع. بعد ربط حسابك في شام كاش بالمنصّة يستطيع موقعك أو نظامك قراءة رصيدك بكل العملات وحوالاتك الواردة والصادرة، والتحقّق من أي دفعة برقم العملية، دون فتح التطبيق.

كيف تربط حساب شام كاش؟

  1. أنشئ حسابك في المنصّة وسجّل الدخول.
  2. افتح صفحة «شام كاش» في لوحة التحكم ليظهر لك رمز QR.
  3. امسح الرمز بتطبيق شام كاش على هاتفك، فيظهر حسابك مرتبطاً مع رصيده وحوالاته.

التحقّق من دفعة شام كاش برقم العملية

يحوّل عميلك المبلغ إلى حسابك في شام كاش ويعطيك رقم العملية. يرسل نظامك هذا الرقم إلى نقطة find_tx، فتبحث المنصّة عنه في الحوالات الواردة إلى حسابك وتعيد الحوالة بمبلغها وعملتها ومرسِلها وتاريخها، أو found: false إن لم تصل. والتحويل الذي أرسله حسابك نفسه لا يُقبل أبداً على أنه دفعة واردة.

curl -s "https://api.eaglebot99.com?resource=shamcash&action=find_tx&tx=TRANSACTION_NO&account_address=YOUR_ACCOUNT_ADDRESS" \
  -H "X-Api-Key: YOUR_API_KEY"
سيريتل كاش · Syriatel Cash

API سيريتل كاش: أتمتة استقبال الدفعات والتحويلات من رقمك

سيريتل كاش (Syriatel Cash) خدمة المحفظة الإلكترونية من سيريتل، تعمل برقم الموبايل لتحويل الأموال واستقبالها والدفع. بعد ربط رقمك بالمنصّة يقرأ نظامك رصيد سيريتل كاش والحوالات الواردة والصادرة، ويتحقّق من دفعات عملائك برقم العملية، ويرسل التحويلات إلى أرقام أخرى عبر الـ API.

كيف تربط رقم سيريتل كاش؟

  1. أنشئ حسابك في المنصّة وسجّل الدخول.
  2. من صفحة «الإعدادات» في لوحة التحكم اختر ربط الحساب، وأدخل رقمك وكلمة سر حسابك في سيريتل كاش.
  3. أدخل رمز التحقّق الذي يصلك من سيريتل برسالة SMS، فيُربط رقمك ويظهر رصيده وسجله.

التحقّق من دفعة سيريتل كاش برقم العملية

يحوّل عميلك إلى رقمك ويعطيك رقم العملية. يرسل نظامك الرقم إلى نقطة find_tx مع رقمك (gsm) والفترة (7 أيام أو 30 يوماً أو الكل)، فتبحث المنصّة في الحوالات الواردة إلى رقمك وتعيد الحوالة كما سجّلتها سيريتل، أو found: false إن لم تصل.

curl -s "https://api.eaglebot99.com?resource=syriatel&action=find_tx&tx=TRANSACTION_NO&gsm=09XXXXXXXX&period=7" \
  -H "X-Api-Key: YOUR_API_KEY"
مقارنة

شام كاش أم سيريتل كاش؟ ما يدعمه كل منهما على المنصّة

يمكنك ربط المحفظتين معاً واستخدامهما بالمفتاح نفسه ونفس أسلوب الطلبات. هذا ما يتيحه كل منهما الآن:

الميزة شام كاش سيريتل كاش
طريقة الربط مسح رمز QR بتطبيق شام كاش الرقم وكلمة سر الحساب ورمز SMS
الرصيد بكل العملات لرقم مرتبط أو كود الكاش
الحوالات الواردة مع المرسِل والعملة والملاحظة 7 أيام أو 30 يوماً أو الكل
الحوالات الصادرة متاح متاح
التحقّق من دفعة برقم العملية متاح متاح
التحويل عبر الـ API بعد 24 ساعة من الربط برمز PIN مع كل تحويل
عدد الحسابات عدة حسابات حسب باقتك رقم واحد لكل حساب
لوحة التحكم والأرشيف متاح متاح
المزايا

كل ما تحتاجه لاستقبال دفعات المحافظ الإلكترونية والتحقّق منها

توقّف عن مراجعة التطبيقات يدوياً: دع أنظمتك تقرأ محافظك وتؤكّد الدفعات نيابةً عنك.

واجهة واحدة للمحفظتين

نقطة اتصال واحدة ومفتاح واحد لسيريتل كاش وشام كاش، بنفس أسلوب الطلبات ونفس إجابات JSON للاثنتين.

لوحة تحكم واحدة لكل الحسابات

اربط عدة حسابات دفع وتابع الأرصدة والحوالات وسجل عملياتك من مكان واحد، بالعربية أو بالإنجليزية.

استعلام تلقائي عن الرصيد والسجل

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

تحقّق من دفعات العملاء

ابحث عن حوالة برقم العملية لتتأكّد من أن العميل دفع فعلاً، مع المبلغ والمرسِل والتاريخ.

أرشيف قابل للبحث

كل حوالة تُقرأ عبر الـ API أو لوحة التحكم أو الفحص المجدول تُحفظ في أرشيف يمكنك البحث فيه وتصديره.

تحويلات من برنامجك

أرسل تحويلات سيريتل كاش وشام كاش عبر الـ API، ومفاتيح عدم التكرار (Idempotency) تضمن ألّا تُدفع إعادة المحاولة مرتين.

تكامل سهل

HTTPS وJSON فقط: PHP أو Node.js أو Python أو أي لغة أخرى. أمثلة جاهزة للنسخ في الأسفل وفي التوثيق.

اشتراكات مرنة

باقات شهرية للشركات والأفراد، وعدة حسابات مرتبطة في كل باقة، تُدفع من رصيدك بالطريقة التي تناسبك.

كيف تعمل

ابدأ العمل في أربع خطوات

من التسجيل إلى أول طلب API خلال دقائق.

  1. 1

    أنشئ حسابك

    سجّل ببريدك الإلكتروني وتبدأ تجربتك المجانية (10 أيام) فوراً.

  2. 2

    اربط محافظك

    اربط شام كاش بمسح رمز QR من تطبيق شام كاش، واربط سيريتل كاش برقمك وكلمة سر حسابك في سيريتل كاش ورمز التحقّق الذي يصلك من سيريتل برسالة SMS.

  3. 3

    احصل على مفتاح API

    أنشئ مفتاحك من صفحة API في لوحة التحكم. يُعرض مرة واحدة ولا تُحفظ منه إلا بصمته (hash)، ويمكنك حصره بعناوين IP لخوادمك.

  4. 4

    استدعِ الـ API

    أرسل طلبات HTTPS مع الترويسة X-Api-Key واقرأ إجابات JSON: الأرصدة والسجلات والبحث عن العمليات والتحويلات.

الأسعار

باقات شهرية بسيطة

اشحن رصيدك واشترك من لوحة التحكم. تتجدّد باقتك تلقائياً ما دام رصيدك يكفي.

رقم سيريتل كاش واحد لكل حساب، وبقية الحسابات المرتبطة حسابات شام كاش.

تجربة مجانية لمدة 10 أيام، مرة واحدة لكل شخص

يحصل كل حساب جديد على 10 أيام مجاناً على باقة Basic عند أول تسجيل، دون أي دفعة.

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

طرق الدفع

اشحن رصيدك بأيٍّ من هذه الطرق، وتُدفع الاشتراكات والتجديدات منه.

يجري تجهيز طرق الدفع الإلكتروني. تواصل مع الإدارة للاشتراك.

للمطوّرين

تكامل خلال دقائق

نقطة اتصال واحدة، ومورد وإجراء، ومفتاحك في الترويسة، وتصلك الإجابة بصيغة JSON. هذا طلب الحالة على هذا الموقع:

عنوان الـ API https://api.eaglebot99.com
curl -s "https://api.eaglebot99.com?resource=status" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Accept: application/json"
<?php
$ch = curl_init('https://api.eaglebot99.com?resource=status');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-Api-Key: YOUR_API_KEY',
        'Accept: application/json',
    ],
    CURLOPT_TIMEOUT => 30,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

$data = json_decode((string) $body, true);
if ($data['success'] ?? false) {
    echo $data['message'], PHP_EOL; // "API is working."
} else {
    echo "Error {$status}: ", $data['error'] ?? 'no answer', PHP_EOL;
}
// Node.js 18+ (built-in fetch)
async function main() {
  const response = await fetch('https://api.eaglebot99.com?resource=status', {
    headers: {
      'X-Api-Key': process.env.API_KEY ?? 'YOUR_API_KEY',
      Accept: 'application/json',
    },
  });
  const data = await response.json();
  if (data.success) {
    console.log(data.message); // "API is working."
  } else {
    console.error(response.status, data.error);
  }
}

main().catch(console.error);
import requests

response = requests.get(
    "https://api.eaglebot99.com",
    params={"resource": "status"},
    headers={"X-Api-Key": "YOUR_API_KEY", "Accept": "application/json"},
    timeout=30,
)
data = response.json()
if data["success"]:
    print(data["message"])  # "API is working."
else:
    print(response.status_code, data["error"])

استبدل YOUR_API_KEY بالمفتاح من صفحة API في لوحة التحكم، وأرسله في الترويسة X-Api-Key بدلاً من الرابط.

200 OK application/json
{
    "success": true,
    "message": "API is working.",
    "user": {
        "id": 123,
        "name": "Your Name",
        "email": "[email protected]"
    },
    "limits": {
        "max_linked_accounts": 5
    }
}
  • المصادقة بمفتاحك في الترويسة X-Api-Key، أو في المُعامل api_key في الرابط.
  • كل إجابة بصيغة JSON: الحقل success يساوي true مع البيانات، أو false مع رسالة الخطأ في الحقل error.
  • حدّ للطلبات لكل مفتاح (حتى 60 طلباً في الدقيقة افتراضياً) مع الترويسة Retry-After.
  • الترويسة Idempotency-Key تجعل إعادة محاولة طلبات المال آمنة.

نقاط النهاية

GET للقراءة وPOST لإرسال الأموال. يشرح التوثيق كل مُعامل وكل إجابة.

توثيق الـ API الكامل
الطريقة نقطة النهاية الوصف
GET resource=status فحص مفتاحك: يعيد بيانات المستخدم وحدّ الحسابات.
GET resource=accounts&action=list حساباتك الفعّالة في سيريتل كاش وشام كاش.
GET resource=syriatel&action=balance رصيد سيريتل كاش لرقم مرتبط أو كود كاش.
GET resource=syriatel&action=history حوالات سيريتل كاش الواردة (7 أيام أو 30 يوماً أو الكل).
GET resource=syriatel&action=outgoing_history حوالات سيريتل كاش الصادرة.
GET resource=syriatel&action=find_tx البحث عن حوالة سيريتل كاش برقمها.
POST resource=syriatel&action=transfer_cash تحويل سيريتل كاش إلى رقم آخر (رمز PIN في جسم الطلب ولا يُحفظ أبداً).
POST resource=syriatel&action=mobile_recharge شحن رصيد الموبايل من سيريتل كاش. غير متاح بعد
GET resource=shamcash&action=balance أرصدة شام كاش بكل العملات.
GET resource=shamcash&action=logs حوالات شام كاش الواردة مع المرسِل والمبلغ والعملة والتاريخ والملاحظة.
GET resource=shamcash&action=outgoing_logs حوالات شام كاش الصادرة.
GET resource=shamcash&action=find_tx البحث عن حوالة شام كاش برقمها.
POST resource=shamcash&action=transfer التحويل من حساب شام كاش مرتبط (بعد 24 ساعة من الربط).

رموز HTTP قياسية: 400 طلب غير صالح، 401 مفتاح مفقود أو خاطئ، 403 غير مسموح، 404 نقطة نهاية أو حساب غير موجود، 405 طريقة غير مدعومة، 429 طلبات كثيرة، 500 خطأ داخلي، 502 خطأ من مزوّد الخدمة.

الأمان

الأمان أولاً

محافظك تحمل أموالاً حقيقية، وكل جزء من الخدمة مصمَّم على هذا الأساس.

مفاتيح API محفوظة بالتجزئة

يُعرض مفتاحك مرة واحدة عند إنشائه، ولا يُحفظ منه إلا بصمة SHA-256. يمكنك إعادة إنشائه أو إلغاؤه في أي وقت.

رمز PIN لا يُحفظ أبداً

رمز PIN لسيريتل كاش يُستخدم لعملية التحويل نفسها فقط: لا يُحفظ ولا يُسجَّل، ولا يُقبل في الرابط.

جلسات المزوّدين مشفّرة

بيانات الدخول وجلسات سيريتل وشام كاش محفوظة مشفّرة بتشفير موثَّق (XChaCha20-Poly1305).

قائمة عناوين IP المسموحة وحدود الطلبات

احصر مفتاحك بعناوين IP لخوادمك. لكل مفتاح حدّ للطلبات (حتى 60 طلباً في الدقيقة افتراضياً).

سجل كامل للطلبات

كل طلب يُسجَّل في سجل طلباتك (الطريقة ونقطة النهاية والنتيجة وعنوان IP)، دون جسم الطلب أو المفتاح أو رمز PIN.

تحويلات آمنة

يُسجَّل التحويل قبل إرساله ويُرسل مرة واحدة فقط؛ إعادة المحاولة بنفس Idempotency-Key تعيد الإجابة الأولى، والنتيجة غير المؤكَّدة لا يُعاد إرسالها تلقائياً.

الأسئلة الشائعة

أسئلة شائعة

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

من لوحة التحكم في المنصّة: افتح صفحة شام كاش وامسح رمز QR بتطبيق شام كاش، ثم أنشئ مفتاح API. بعدها يستطيع موقعك قراءة رصيد حسابك وحوالاته والتحقّق من أي دفعة برقم العملية.

من صفحة الإعدادات في لوحة التحكم: أدخل رقمك وكلمة سر حسابك في سيريتل كاش، ثم رمز التحقّق الذي يصلك برسالة SMS. بعد الربط يقرأ نظامك الرصيد والحوالات الواردة والصادرة ويبحث عن أي عملية برقمها عبر الـ API.

اطلب من العميل رقم العملية بعد التحويل، ثم استدعِ نقطة find_tx الخاصة بالمحفظة: تبحث المنصّة في الحوالات الواردة إلى حسابك نفسه وتعيد الحوالة بمبلغها وتاريخها، أو found: false إن لم تصل. هكذا تؤكّد الطلب من سجل حسابك الحقيقي، لا من صورة شاشة قد تكون مزوّرة.

نعم. تربط المحفظتين في الحساب نفسه وتستخدمهما بمفتاح API واحد ونفس أسلوب الطلبات: رقم سيريتل كاش واحد، وحسابات شام كاش لبقية العدد الذي تتيحه باقتك.

لا. يحصل كل حساب جديد على تجربة مجانية لمدة 10 أيام عند أول تسجيل دون أي دفعة. بعدها اختر باقة شهرية وادفعها من رصيدك.

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

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

أي لغة ترسل طلب HTTPS وتقرأ JSON: PHP وNode.js وPython وJava وC# وGo وغيرها. الأمثلة أعلاه والتوثيق تغطي الأكثر استخداماً.

يجري تجهيز طرق الدفع الإلكتروني. تواصل مع الإدارة لشحن رصيدك والاشتراك.

يتوقّف مفتاح الـ API عن العمل حتى تجدّد، ولا يمكنك ربط حسابات جديدة فوق الحدّ المجاني. تبقى حساباتك المرتبطة وأرشيفك وسجل عملياتك كما هي.

رمز PIN لسيريتل كاش يُستخدم فقط للتحويل الذي تطلبه ولا يُحفظ ولا يُسجَّل. بيانات دخول المزوّدين وجلساتهم محفوظة مشفّرة، ومفتاح الـ API لا يُحفظ إلا ببصمته.

لا. تبقى أموالك في حساباتك في شام كاش وسيريتل كاش. المنصّة تقرأ الرصيد والحوالات، ولا ترسل أي تحويل إلا حين تطلبه أنت من لوحة التحكم أو عبر الـ API.

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

غالباً لا. تستخدم الواجهة مُعاملَي resource وaction المألوفين وإجابات JSON بصيغة success / data / error، فيكون نقل التكامل الحالي في الغالب مجرد تغيير عنوان الـ API والمفتاح.

جاهز لربط محافظك؟

أنشئ حسابك الآن واستخدم كل المزايا مجاناً لمدة 10 أيام.