اربط حساباتك في شام كاش وسيريتل كاش بموقعك أو متجرك الإلكتروني أو تطبيقك أو نظامك الداخلي أو بوت تيليغرام وواتساب. اقرأ الرصيد والحوالات الواردة والصادرة، وتحقّق من دفعات عملائك برقم العملية تلقائياً، وأدِر جميع حسابات الدفع من لوحة تحكم عربية واحدة عبر واجهة REST بسيطة.
منصّة وسيطة بين حساباتك في شام كاش (ShamCash) وسيريتل كاش (Syriatel Cash، وتُكتب أحياناً «سيرياتيل كاش») وبين برامجك: تربط محافظك مرة واحدة، فيصبح موقعك أو متجرك أو تطبيقك أو بوتك قادراً على قراءة الرصيد والحوالات والتحقّق من الدفعات وإرسال التحويلات بطلب API بسيط، بدل فتح التطبيق ومراجعة كل حوالة يدوياً.
المشكلة: التحقّق اليدوي من الدفعات
حين يدفع لك العميل بشام كاش أو سيريتل كاش عليك أن تفتح التطبيق وتبحث عن الحوالة وتطابق المبلغ ثم تؤكّد الطلب بنفسك، وغالباً بالاعتماد على صورة شاشة يرسلها العميل وقد تكون مزوّرة. ومع ازدياد الطلبات يصبح ذلك بطيئاً ومكلفاً وعرضة للأخطاء.
الحل: ربط مباشر لمحافظك ببرامجك
تربط حسابك في شام كاش بمسح رمز QR، ورقمك في سيريتل كاش بكلمة سر حسابك ورمز SMS. تحفظ المنصّة جلسة الربط مشفّرة، وتقرأ سجل حسابك نفسه، وتحفظ كل حوالة في أرشيف قابل للبحث. يستدعي موقعك الـ API بمفتاحه الخاص ويحصل على إجابة JSON واضحة: هل وصلت الدفعة، وبأي مبلغ، ومن أرسلها، ومتى.
ما لا تفعله المنصّة
لا تحتفظ بأموالك: تبقى في حساباتك في شام كاش وسيريتل كاش، ولا يخرج منها تحويل إلا بطلب منك. لا تفتح حسابات جديدة باسمك ولا تحفظ رمز PIN. وهي منصّة مستقلّة لا تتبع شركة سيريتل ولا شام كاش.
أمثلة على الاستخدام
متجر إلكتروني يقبل الدفع بشام كاش وسيريتل كاش
يحوّل العميل ثمن طلبه ويُدخل رقم العملية، فيتحقّق المتجر منها عبر الـ API ويؤكّد الطلب فوراً دون مراجعة يدوية.
بوت تيليغرام أو واتساب لتأكيد الدفع
يرسل المستخدم رقم الحوالة إلى البوت، فيبحث عنها البوت في حسابك ويردّ عليه بالنتيجة تلقائياً.
إضافة الرصيد تلقائياً في تطبيقك أو منصّتك
بعد التحقّق من الحوالة يضيف نظامك المبلغ إلى حساب المستخدم دون تدخّل أي موظّف.
المحاسبة ومطابقة الحوالات
اسحب سجل الحوالات الواردة والصادرة إلى نظامك المحاسبي، وابحث في الأرشيف وصدّره متى احتجت.
عدة حسابات من لوحة واحدة
تابع أرصدة كل حساباتك المرتبطة في شام كاش وسيريتل كاش وحوالاتها من لوحة تحكم واحدة بالعربية أو بالإنجليزية.
إرسال التحويلات من برنامجك
أرسل تحويلات شام كاش وسيريتل كاش عبر الـ API، مع حماية من الإرسال المكرّر عند إعادة المحاولة.
شام كاش وسيريتل كاش (Syriatel Cash) علامتان تجاريتان مملوكتان لأصحابهما. هذه المنصّة خدمة مستقلّة غير تابعة لهما، وتعمل على حسابات يربطها أصحابها بأنفسهم.
شام كاش · ShamCash
API شام كاش: اربط حساب شام كاش بموقعك وتحقّق من الحوالات تلقائياً
شام كاش محفظة إلكترونية منتشرة في سوريا لإرسال الأموال واستقبالها والدفع. بعد ربط حسابك في شام كاش بالمنصّة يستطيع موقعك أو نظامك قراءة رصيدك بكل العملات وحوالاتك الواردة والصادرة، والتحقّق من أي دفعة برقم العملية، دون فتح التطبيق.
كيف تربط حساب شام كاش؟
أنشئ حسابك في المنصّة وسجّل الدخول.
افتح صفحة «شام كاش» في لوحة التحكم ليظهر لك رمز QR.
امسح الرمز بتطبيق شام كاش على هاتفك، فيظهر حسابك مرتبطاً مع رصيده وحوالاته.
التحقّق من دفعة شام كاش برقم العملية
يحوّل عميلك المبلغ إلى حسابك في شام كاش ويعطيك رقم العملية. يرسل نظامك هذا الرقم إلى نقطة find_tx، فتبحث المنصّة عنه في الحوالات الواردة إلى حسابك وتعيد الحوالة بمبلغها وعملتها ومرسِلها وتاريخها، أو found: false إن لم تصل. والتحويل الذي أرسله حسابك نفسه لا يُقبل أبداً على أنه دفعة واردة.
API سيريتل كاش: أتمتة استقبال الدفعات والتحويلات من رقمك
سيريتل كاش (Syriatel Cash) خدمة المحفظة الإلكترونية من سيريتل، تعمل برقم الموبايل لتحويل الأموال واستقبالها والدفع. بعد ربط رقمك بالمنصّة يقرأ نظامك رصيد سيريتل كاش والحوالات الواردة والصادرة، ويتحقّق من دفعات عملائك برقم العملية، ويرسل التحويلات إلى أرقام أخرى عبر الـ API.
كيف تربط رقم سيريتل كاش؟
أنشئ حسابك في المنصّة وسجّل الدخول.
من صفحة «الإعدادات» في لوحة التحكم اختر ربط الحساب، وأدخل رقمك وكلمة سر حسابك في سيريتل كاش.
أدخل رمز التحقّق الذي يصلك من سيريتل برسالة SMS، فيُربط رقمك ويظهر رصيده وسجله.
التحقّق من دفعة سيريتل كاش برقم العملية
يحوّل عميلك إلى رقمك ويعطيك رقم العملية. يرسل نظامك الرقم إلى نقطة find_tx مع رقمك (gsm) والفترة (7 أيام أو 30 يوماً أو الكل)، فتبحث المنصّة في الحوالات الواردة إلى رقمك وتعيد الحوالة كما سجّلتها سيريتل، أو found: false إن لم تصل.
حوالات سيريتل كاش الواردة (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 أيام.