أصدر التأشيرات بواجهتنا
واجهة من خادم إلى خادم لوكلاء السفر المعتمدين. كتالوج وتسعير وإنشاء ودفع طلبات التأشيرة والتأمين بأسعار الجملة عبر محفظتك.
ماذا تفعل واجهة الشركاء؟
واجهة واحدة للتأشيرة الإلكترونية وتأمين السفر، من الكتالوج الحي حتى التسوية بالمحفظة.
-
الكتالوج والتسعير
اسحب المنتجات والأسعار الحية حسب الجنسية أو الوجهة. تُحسب الرسوم دائماً من جهتنا.
-
إنشاء الطلب
أرسل بيانات المسافر والملفات مع Idempotency-Key وتحصل على معرّف طلب ثابت.
-
الدفع من المحفظة
سدّد بسعر الجملة عبر pay-wallet. اشحن المحفظة بالبطاقة عند انخفاض الرصيد.
كيف تبدأ
ثلاث خطوات قبل أول طلب حي
-
قدّم طلب وكيل سفر أرسل بيانات وكالتك من ملفك في كاونتر
-
أنشئ مفتاح API أنشئ مفتاح ka_live_… بالصلاحيات المطلوبة من لوحة التحكم
-
كتالوج ← تسعير ← إنشاء ← دفع اتبع التوثيق لتسلسل الطلبات الكامل والإشعارات
الأسئلة الشائعة
ما هي واجهة شركاء كاونتر (Partner API)؟
واجهة من خادم إلى خادم للتأشيرة الإلكترونية وتأمين السفر لوكلاء السفر المعتمدين. يمكنك عرض الكتالوج والحصول على تسعير وإنشاء الطلبات والدفع من محفظة الوكالة بأسعار الجملة.
من يمكنه استخدام واجهة الشركاء؟
وكلاء السفر المعتمدون فقط. بعد موافقة كاونتر على وكالتك أنشئ مفاتيح API من لوحة التحكم تحت تكامل API. لا يوجد نموذج عام لإصدار المفاتيح.
كيف أحصل على مفتاح Kawenter API؟
من لوحة التحكم ← تكامل API بعد اعتماد وكالتك، أنشئ مفتاح ka_live_… بالصلاحيات المطلوبة. احتفظ بالمفاتيح على خادمك فقط ولا تضعها في المتصفح أو تطبيقات الجوال.
ما الفرق بين Partner API والصفحة البيضاء؟
Partner API لخادمك: تنشئ وتدفع الطلبات بالجملة من المحفظة. الصفحة البيضاء صفحة أو iframe للمسافر يدفع فيها بسعر التجزئة لكاونتر، وتحصل وكالتك على أرباحها عند اكتمال الطلب.
كيف يعمل الدفع بالمحفظة؟
تُسوّى الطلبات عبر pay-wallet بسعر الجملة. اشحن المحفظة بالبطاقة عند انخفاض الرصيد، أو فعّل الشحن التلقائي إن كان متاحاً. يعيد كاونتر حساب الرسوم والخصومات من جهة الخادم وفق الكتالوج.
ما المنتجات التي تدعمها واجهة الشركاء؟
طلبات التأشيرة الإلكترونية وتأمين السفر المستقل، بما في ذلك الكتالوج والتسعير وإنشاء الطلب والدفع بالمحفظة. إضافة التأمين ضمن طلب التأشيرة منفصلة عن طلبات التأمين المستقلة.
أين أجد توثيق Partner API؟
الأدلة الكاملة على https://kawenter.com/docs/partner وملف OpenAPI على https://kawenter.com/.well-known/partner-openapi.json. Markdown وسجل التغييرات وJSON للوكلاء متاحة من صفحة التوثيق.