الانتقال إلى المحتوى
Rate Extra

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

إجابات من كل صفحة في مكان واحد: الأهلية والعملات والمراجع والترخيص وأكثر الأسئلة شيوعًا لكل منتج.

عام

من يمكنه التقديم؟

وكالات السفر المرخّصة فقط. نطلب رقم الرخصة والرخصة التجارية أثناء التقديم.

بأي عملات تتعاقدون وتسوّون؟

AED وUSD وEUR وGBP وTRY.

هل يوجد مرجع API عام؟

نعم. مرجع TravelDistro API متاح للعموم على api.traveldistro.com/docs. أما API تأشيرات الإمارات فهي في مرحلة الوصول المبكر وليست في المرجع العام بعد.

هل Hotel API منتج من Rate Extra؟

لا. توفّر Hotel API وتتعاقد عليها Safaryar Holidays (Sindibad Turizm Ticaret A.Ş.) في إسطنبول. وهي متاحة لشركاء Rate Extra.

أين أنتم مرخّصون؟

في دبي، من دائرة الاقتصاد والسياحة (DET). رخصة رقم 1253634، سجل رقم 2115485.

المنتجات

TravelDistro

هل أحتاج إلى عقد منفصل لكل منتج؟

لا. عقد واحد مع Rate Extra يحدد القطاعات التي يمكنك استدعاؤها؛ والمفتاح والرصيد نفسهما يخدمانها جميعًا.

هل يمكنني استخدام Bearer token؟

لا. كل طلب يُوقَّع بـ TD-HMAC-SHA256. راجع صفحة المصادقة لمثال عملي.

ماذا يحدث عند استدعاء منتج خارج عقدي؟

تُرجع API الاستجابة 403 MODULE_NOT_ENABLED على كل نقطة نهاية تخص ذلك المنتج. لا يُحجز ولا يُخصم شيء.

هل توجد بيئة اختبار (sandbox)؟

لا تعرض TravelDistro مضيف sandbox منفصلًا في المرجع العام. تملك Hotel API من Safaryar Holidays علامة sandbox؛ أما المنتجات الأخرى فتُختبر بمفتاحك الحي عبر حجوزات صغيرة قابلة للإلغاء يُتفق عليها مع فريق التسجيل.

أين مرجع API؟

متاح للعموم على api.traveldistro.com/docs، مع ملف OpenAPI على /docs/openapi.yaml.

API تأشيرات الإمارات

هل API تأشيرات الإمارات في مرجع API العام؟

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

ما أنواع التأشيرات التي يمكنني التقديم عليها؟

تأشيرات الإمارات بدخول واحد ودخول متعدد. قواعد الصلاحية والإقامة الرسمية تحددها سلطات الإمارات؛ ولا نعيد ذكرها هنا.

كم تستغرق المعالجة؟

في المتوسط 48 ساعة عمل من اكتمال الطلب.

من يمكنه استخدامها؟

وكالات السفر المرخّصة التي وقّعت عقدًا مع Rate Extra.

API النقل

ما المدن المغطاة؟

إسطنبول وأنطاليا، بما في ذلك مسارات المطارات (IST وSAW وAYT).

ما مدة صلاحية السعر المعروض؟

يحمل كل عرض طابع quote_expires_at؛ والسعر مثبّت حتى ذلك الوقت.

هل يجب أن أستعلم عن التأكيد؟

لا. يُؤكَّد الحجز في الاستجابة؛ والتغييرات اللاحقة مثل تعيين السائق تصل عبر webhook موقّع.

هل يمكن تغيير بيانات المسافر بعد الحجز؟

نعم، عبر PATCH على الحجز. ويتبع الإلغاء السياسة المُرجعة مع العرض.

API الجولات والأنشطة

أين الجولات؟

إسطنبول وأنطاليا.

هل الأسعار مخزّنة مؤقتًا؟

لا. كل بحث أو عرض يُحدَّد مباشرة ويُرجع quote_token يثبّت السعر للحجز.

كيف تُسلَّم القسائم؟

عبر API، لكل حجز؛ وقد تكون قسائم التذاكر مجدولة بجلسات.

بأي لغات يتوفر محتوى الجولات؟

تُنشر الجولة بلغة ما فقط بعد مراجعة العمليات وترجمة معتمدة لتلك اللغة.

API شرائح eSIM

ما الدول المغطاة؟

الكتالوج عالمي؛ وتأتي قائمة الباقات الدقيقة لكل دولة من API.

ما سرعة التسليم؟

فوري بعد تأكيد الطلب؛ وتُرجع تعليمات التثبيت مع الطلب.

هل يمكنني التحقق من الاستخدام؟

نعم، لكل ICCID، ويمكنك إعادة شحن شريحة eSIM قائمة.

هل الأسعار مباشرة؟

نعم. يُحدَّد البحث وعرض السعر مباشرة؛ ولن تبيع أبدًا بسعر قديم.

API الطيران

هل إصدار التذكرة خطوة منفصلة؟

لا. يُرجع الحجز حجزًا مؤكدًا مع التذكرة في طلب واحد.

كيف تتم الاستردادات؟

يعيد الإلغاء المبلغ إلى محفظتك وفق شريحة الاسترداد المطبّقة على الأجرة.

هل الأسعار بعملتي؟

تُسعَّر المسارات مع هامشك وسعر الصرف عند البحث.

ما شركات الطيران المتاحة؟

تُؤكَّد التغطية مع فريق التسجيل أثناء التعاقد.

API الفنادق

هل Hotel API منتج من Rate Extra؟

لا. توفّرها وتتعاقد عليها Safaryar Holidays (Sindibad Turizm Ticaret A.Ş.)، وهي شركة تابعة في إسطنبول. ويمكن لشركاء Rate Extra الوصول إليها.

هل توجد بيئة اختبار؟

نعم. الطلبات التي تحمل "sandbox": true تستخدم بيانات وأسعار فنادق حقيقية دون خصم من الرصيد.

كم غرفة لكل حجز؟

حتى 9 غرف في العقود المباشرة (OWN)، مع إلغاء غرفة واحدة.

كيف يتم ربط الفنادق؟

برموز GIATA، في دفعات حتى 500.

ما webhooks المتاحة؟

booking.created وbooking.cancelled وbooking.prebook_confirmed وbooking.prebook_rejected، موقّعة بـ X-Webhook-Signature.

API تأجير السيارات

كيف تُبنى العروض؟

عرض مسعّر واحد لكل فئة مركبة، ولكل منها عرض سعر يثبّت السعر للحجز.

كيف يُدفع الحجز؟

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

ما المواقع المتاحة؟

يُرجع كتالوج المواقع عبر API؛ وتُؤكَّد التغطية مع فريق التسجيل.

هل هي في المرجع العام؟

نعم، في مرجع TravelDistro API.

API بطاقات المدينة

ماذا تتضمن البطاقة؟

مجموعة مزايا محددة لكل منتج: دخول المتاحف وجولة بحرية ونقل وشريحة eSIM ودليل صوتي.

كيف تُستخدم المزايا؟

عبر طلبات المزايا والقسائم الصادرة لكل بطاقة.

ما المدن؟

يحدد كتالوج البطاقات المُرجع عبر API المدينة لكل منتج.

هل يمكن دمجها مع منتجات أخرى؟

نعم؛ المفتاح والرصيد نفسهما يخدمان كل قطاع في عقدك.

API الأدلة الصوتية

هل يحتاج الزائر إلى حساب؟

لا. يمسح الزائر تصريح QR؛ ويستدعي الجهاز /guide/v1 برمز التصريح.

هل يمكنني استخدام تطبيقي الخاص؟

نعم. واجهة API للزوار بعلامة بيضاء؛ ابنِ عليها تطبيق زوار بعلامتك.

هل يوجد تطبيق جاهز؟

نعم، Rivayet، متاح على App Store وGoogle Play.

هل يمكنني رؤية الاستخدام؟

نعم، عبر نقطة نهاية إحصاءات الاستخدام.

API تخزين الأمتعة

كيف يُحسب الوقت؟

بكتل من 24 ساعة تبدأ عند الإيداع.

كيف تُسعَّر القطع الكبيرة؟

تُحسب القطعة الكبيرة كحقيبتين.

من يدير نقاط التخزين؟

ندير النقاط بأنفسنا؛ وتُعرض المواقع عبر API.

هل يمكن إلغاء الحجز؟

نعم، عبر نقطة نهاية الإلغاء.

API قاعات MICE

هل يمكنني الحجز فورًا؟

لا. تعمل القاعات بطلب العرض: ترسل طلبًا، ويتفاوض فريق العمليات لدينا، وتقبل العرض أو ترفضه.

ما الدولة المغطاة؟

تركيا.

بأي لغة الكتالوج؟

بالإنجليزية في هذه المرحلة.

كيف أحافظ على مزامنة الكتالوج؟

تدريجيًا، عبر المعامل updated_since.

TripXtra

هل تحل TripXtra محل تغطية السفر؟

لا. TripXtra بطاقة مساعدة ودعم. ليست وثيقة ولا تحل محل تغطية السفر.

من يصدر البطاقة؟

وكالتك، عبر API، بعد اتفاق تجاري مع Rate Extra.

ماذا يحصل المسافر؟

خط دعم على مدار الساعة، ووصول إلى محامٍ عبر مكتب محاماة شريك مع معاودة اتصال طارئة خلال 60 دقيقة، ودعم في حال فقدان جواز السفر، ومساعدة في النزاعات، وإضافات سفر.

هل يمكنني وضع علامتي عليها؟

نعم، بصيغة "powered by TripXtra".

بوابة B2B

هل أحتاج إلى مطورين؟

لا. البوابة تطبيق ويب؛ ويغطي العقد نفسه الوصول إلى API إذا قمت بالتكامل لاحقًا.

هل أسعار البوابة هي أسعار API نفسها؟

نعم. المنتجات نفسها والأسعار نفسها والمحفظة نفسها.

أين أسجّل الدخول؟

يستلم الشركاء عنوان البوابة مع حسابهم بعد التسجيل.

هل يمكنني الانتقال إلى API لاحقًا؟

نعم، ضمن العقد نفسه.

العلامة البيضاء

ما الذي يمكن وضع العلامة البيضاء عليه اليوم؟

تجربة زوار الدليل الصوتي عبر واجهة API للزوار، وبطاقة TripXtra بصيغة "powered by TripXtra".

هل أحتاج إلى تطبيقي الخاص؟

للدليل الصوتي، يمكنك بناء تطبيق على واجهة API للزوار أو استخدام Rivayet.

هل توجد تكلفة إضافية؟

يُتفق على النطاق والشروط أثناء التعاقد.

هل هي للوكالات المرخّصة فقط؟

نعم، مثل كل منتجات Rate Extra.

التسوية والفوترة

ما العملات؟

AED وUSD وEUR وGBP وTRY.

هل هي مدفوعة مسبقًا؟

نعم. تخصم الحجوزات من محفظة مدفوعة مسبقًا؛ والاستجابة 429 أو الحجز الفاشل لا يخصمان شيئًا.

هل يمكنني قراءة كشفي عبر API؟

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

من يصدر الفاتورة؟

‏Rate Extra Tourism L.L.C في دبي، باستثناء Hotel API التي يُتعاقد عليها مع Safaryar Holidays.

وكالة سفر مرخّصة؟ قدّم طلب الوصول إلى API.

احصل على وصول API