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

API بطاقات شحن وشحن ألعاب لمتجرك وأنظمتك

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

API

ماذا تقدم واجهة API لبطاقات الشحن؟

الكتالوج

المنتجات وأسعار فئتك

قائمة المنتجات والفئات المتاحة بسعر الجملة الخاص بحسابك، محدثة دائماً.

الطلبات

إنشاء طلب بمعرف اللاعب

إنشاء الطلبات برمجياً مع تحقق من معرف اللاعب قبل خصم أي مبلغ.

الحالة

متابعة حالة الطلب

استعلم عن حالة أي طلب في أي وقت عبر الواجهة — قيد التنفيذ أو ناجح أو فاشل.

التسوية

عبر المحفظة

حجز المبلغ عند الإنشاء، تحصيل عند النجاح، واسترداد تلقائي لأي طلب يفشل.

لمن صممت الواجهة؟

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

كيف يبدو التكامل عملياً؟

01

استعرض الكتالوج والأسعار

يجلب نظامك قائمة المنتجات والفئات بأسعار فئتك مباشرة من الواجهة.

02

أنشئ الطلب

يرسل نظامك الطلب بمعرف اللاعب أو نوع البطاقة، وتتحقق المنصة قبل الخصم.

03

استلم النتيجة

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

أسئلة شائعة عن واجهة API

كيف أحصل على وصول إلى الواجهة؟

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

كيف يتم التوثيق؟ وهل أستطيع إلغاء المفتاح؟

التوثيق برمز وصول (Bearer token) تنشئه من لوحة الوكيل. يمكنك إنشاء أكثر من مفتاح وإلغاء أي منها في أي وقت، ويسجَّل كل استخدام في حسابك — فإذا انكشف مفتاح تُلغيه دون أن تتوقف بقية أنظمتك.

هل يوجد Webhook يخبر نظامي بحالة الطلب؟

نعم. تسجّل رابطاً واحداً (https فقط) من صفحة المطوّرين، فنُرسل إليه إشعاراً عند وصول الطلب إلى حالته النهائية — نجاح أو فشل — لا عند كل تغيير وسيط. كل إشعار موقَّع بترويسة X-Kaziyh-Signature (HMAC-SHA256 مع طابع زمني داخل التوقيع، فلا يمكن انتحاله ولا إعادة إرساله)، ويُعاد المحاولة عند الفشل، وتجد سجل المحاولات كاملاً في اللوحة. ملاحظة مهمة: أغلب الطلبات تُنفَّذ خلال ثوانٍ فيصلك الرد في نفس العملية، فالفائدة الحقيقية للـ Webhook هي الطلبات التي تمر بمراجعة يدوية.

ماذا يحدث لو أرسل نظامي الطلب نفسه مرتين؟

الطلبات تقبل مفتاح تفرّد (idempotency key) خاص بحسابك، فإعادة إرسال الطلب نفسه تُعيد الطلب الأصلي ولا تُنشئ طلباً ثانياً ولا تخصم مرتين. هذه أهم حماية عند انقطاع الشبكة في منتصف الطلب.

هل الأسعار في الواجهة هي نفس أسعار لوحة التحكم؟

نعم. الواجهة تعرض سعر الجملة الخاص بفئة حسابك، وهو نفس السعر الذي تراه في اللوحة. لا يوجد سعر مختلف للواجهة ولا رسوم لاستخدامها ولا اشتراك شهري.

ماذا لو لم يكن عندي فريق تقني؟

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

ملاحظة

الوصول مع حساب وكيل معتمد

الوصول إلى الواجهة يمنح لأصحاب حسابات الوكلاء المعتمدين. هذه الصفحة وصف للقدرات، والتوثيق الفني الكامل (الصلاحيات، تقييد العناوين، الـ Webhook والتحقق من التوقيع) متاح للجميع على صفحة التوثيق.

التوثيق الفني الكامل

اربط نظامك بمصدر شحن واحد

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

قدّم طلب وكالة