انتقل إلى المحتوى
واجهة API للتكامل من Xegora v1

أصدر بطاقات الهدايا وشرائح eSIM في استدعاء واحد

كتالوج واحد لكل فئات المنتجات. يُسعَّر الطلب لحظة تقديمه ولا يتجاوز أبدًا السقف الذي تحدده، وهو آمن للتكرار على محفظتك المدفوعة مسبقًا، وWebhooks موقَّعة — لذا فإعادة المحاولة آمنة، ويوم الإطلاق يمر بهدوء.

كن تاجرًااقرأ المستندات

تُصدَر مفاتيح API وتُدار من لوحة تحكم التاجر بعد الموافقة على مساحة العمل الخاصة بك.

دورة الحياة

كيف يسير الطلب

دورة قصيرة واحدة — ثلاثة استدعاءات وWebhook موقَّع — وهي الدورة نفسها لكل فئات المنتجات.

  1. ابحث عن منتج

    GET /products

    تصفّح كتالوجًا واحدًا يضم بطاقات الهدايا وباقات eSIM وشحن الرصيد حسب الفئة أو الدولة أو النص — أو حدّث المنتجات التي تبيعها بالتحديد عبر معرّفاتها.

  2. تقديم الطلب

    POST /orders

    أرسل العنصر: يُسعَّر ويُطلب في استدعاء واحد، دون أن يتجاوز أبدًا السقف الذي تحدده. وإعادة الإرسال بالمفتاح نفسه تُرجع الطلب نفسه.

  3. استقبل Webhook

    order.fulfilled

    يُعلمك حدث موقَّع لحظة اكتمال التنفيذ. لا حاجة إلى الاستعلام الدوري.

  4. إظهار الرمز

    POST /orders/{id}/fulfillment

    اجلب الرموز وأرقام PIN عبر نقطة نهاية مخصصة وخاضعة للتدقيق — لا تُخزَّن مؤقتًا أبدًا، وكل عملية إظهار تُحتسب.

البدء السريع

بلغتك البرمجية، عبر HTTPS البسيط

واجهة REST API واضحة وسلوكها متوقَّع — JSON للمدخلات وJSON للمخرجات، وترويسة X-Api-Key، دون الحاجة إلى أي SDK. ابحث، اطلب، أظهِر الرمز: طلبك الأول في ثلاثة استدعاءات فقط.

create-order.ts
const BASE = "https://integration.xegora.com/api/v1";
const response = await fetch(`${BASE}/orders`, {
  method: "POST",
  headers: {
    "X-Api-Key": process.env.XEGORA_API_KEY!,
    "Content-Type": "application/json",
    "Idempotency-Key": "order-10231",
  },
  body: JSON.stringify({
    clientReference: "po-10231",
    item: { productId, variantId, quantity: 1, currency: "USD" },
    maximumTotal: 60.0, // the price your buyer saw
  }),
});
const order = await response.json();
// 409 price_above_maximum carries quotedTotal — show the new price instead
console.log(order.status); // "reserved" — wait for "fulfilled", then reveal
  • طلبات آمنة للتكرار
  • Webhooks موقَّعة
  • مفاتيح API محددة الصلاحيات
  • محفظة مموَّلة مسبقًا
مرجع API

الواجهة الأساسية، من البداية إلى النهاية

أشكال حقيقية للطلبات والاستجابات — انقر على أي صف. وتكتمل الواجهة بعمليات السحب وسجل الإيداعات وصور المنتجات؛ أما المرجع الكامل فتجده على docs.xegora.com.

POST /api/v1/orders

اطلب من محفظتك المدفوعة مسبقًا: أرسل العنصر لتسعيره وطلبه في استدعاء واحد (مع maximumTotal اختياري)، أو أرسل quoteId. ترويسة Idempotency-Key مطلوبة — وإعادة المحاولة تُرجع الطلب نفسه. الصلاحية: orders.create.

مثال على الاستجابة202 Accepted
{
  "id": "0198e000-1111-7abc-9def-222233334444",
  "clientReference": "po-10231",
  "status": "reserved",
  "total": 58.50,
  "currency": "USD",
  "lines": [
    { "productId": "0198d72d-99d6-75a6-9f12-971050ba7a5f", "variantId": "0198d72d-a15b-7cbf-…",
      "productName": "Everyday Digital Gift Card", "variantLabel": "50", "quantity": 1,
      "unitPrice": 58.50, "currency": "USD", "faceValue": 50, "faceCurrency": "EUR" }
  ],
  "createdAtUtc": "2026-09-05T12:01:02Z",
  "updatedAtUtc": "2026-09-05T12:01:02Z"
}

كل ما تبقى تجده على docs.xegora.com

توثيق المطورين الكامل — كل نقطة نهاية مع مخططات الطلب والاستجابة، والتحقق من توقيع Webhook بثلاث لغات برمجة، ومواصفات OpenAPI 3.1 الكاملة.

  • البدء
  • المصادقة
  • الطلبات وعروض الأسعار
  • Webhooks
  • الإطلاق
مصمَّم لبيئة الإنتاج

البنية التحتية المملة التي تريدها فعلًا

كل ما يجعل تكامل الإصدار يصمد أمام الحركة الفعلية — الطلبات الآمنة للتكرار، والتواقيع، وبيانات الاعتماد محددة الصلاحيات، ومحفظة لا يمكنها الإنفاق بما يتجاوز رصيدها.

كتالوج موحّد

تشترك بطاقات الهدايا وباقات eSIM وشحن رصيد الجوال في مخطط واحد ومصدر أسعار واحد ومسار طلب واحد. تكامَل مرة واحدة، وسيصبح كل منتج تضيفه Xegora متاحًا لك تلقائيًا.

طلبات آمنة للتكرار

يقبل كلٌّ من إنشاء الطلب وإظهار محتوى التنفيذ ترويسة Idempotency-Key. انقطاع لحظي في الشبكة، أو انتهاء مهلة، أو حلقة إعادة محاولات مكثفة — أعد إرسال الطلب كما تشاء، وسيبقى هناك طلب واحد فقط.

Webhooks موقَّعة

تُرسَل الأحداث order.processing، order.fulfilled، order.failed، order.refunded، wallet.credited عبر HTTPS بتوقيع HMAC-SHA256 (X-Xegora-Signature)، مع إعادة المحاولة لضمان التسليم مرة واحدة على الأقل، وإزالة التكرار عبر معرّف ثابت X-Xegora-Event-Id.

مفاتيح بأقل الصلاحيات

يحمل كل مفتاح مجموعة صلاحيات صريحة — قراءة الكتالوج وعروض الأسعار والطلبات وقراءة المحفظة وصلاحيات تحريك الأموال، وكلها منفصلة — إضافة إلى قائمة سماح CIDR اختيارية وتاريخ انتهاء. والإلغاء فوري.

محفظة مموَّلة مسبقًا

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

كتالوج مصمَّم لتسهيل الاختيار

تصفّح حسب الفئة أو الدولة أو النص، وضيّق النتائج إلى المبالغ الثابتة أو المخصصة، وحدّث المنتجات التي تبيعها بمعرّفاتها في استدعاء واحد — مع خطوات الاستخدام ودول العلامة التجارية الأخرى في كل منتج، مسعّرة بعملة البيع الخاصة بك.

الأسعار

أسعار الجملة، بلا مفاجآت

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

  • تسعير المنتجات بسعر الجملة بعملة البيع الخاصة بك — وإجمالي عرض السعر هو بالضبط ما يُخصم من محفظتك
  • لا رسوم خفية لكل استدعاء؛ وحدّ ثابت لمعدل الطلبات قدره 120 طلبًا في الدقيقة لكل مساحة عمل
  • يُتفق على خطة مساحة عملك (الإعداد والشروط) عند انضمامك كتاجر
  • تُعرض تفاصيل سحب الأموال غير المستخدمة بشفافية — الرسوم والصافي وتاريخ الدفعة مسبقًا
تقدّم بطلب مساحة عملتحدّث إلينا

هل أنت مستعد لإصدار طلبك الأول؟

قدّم طلبًا للحصول على مساحة عمل تاجر من حسابك، واحصل على الموافقة، ثم أصدر مفاتيح API محددة الصلاحيات من لوحة التحكم — وبعدها لا يفصلك عن طلبك الأول سوى ثلاثة استدعاءات. المرجع الكامل بانتظارك على docs.xegora.com.

كن تاجرًاإدارة مفاتيح API