API Documentationتوثيق واجهة API

api-token: YOUR_API_TOKEN

Retrieves the user's balance and profile information.يعرض رصيد المستخدم ومعلومات ملفه الشخصي.

Response Exampleمثال على الاستجابة

{
    "balance": "8788.683",
    "email": "user@example.com"
}

Retrieves all available products.يعرض جميع المنتجات المتاحة.

Response Exampleمثال على الاستجابة

[
    {
        "id": 365,
        "name": "UC 60",
        "price": 0.104,
        "params": ["ادخل الايدي الاعب"],
        "category_name": "UC 60",
        "available": true,
        "qty_values": {
            "min": 1,
            "max": "15000"
        },
        "product_type": "amount",
        "parent_id": 0,
        "base_price": 0.10,
        "category_img": ""
    },
    {
        "id": 18,
        "name": "UC 60",
        "price": 1.094,
        "params": ["ادخل الايدي الاعب"],
        "category_name": "PUBG Global ID UC",
        "available": true,
        "qty_values": null,
        "product_type": "package",
        "parent_id": 7,
        "base_price": 0.877,
        "category_img": "images/category/1710948113.webp"
    }
]

Filter Products by IDsتصفية المنتجات حسب المعرّفات (IDs)

Retrieves specific products by their IDs.يعرض منتجات محددة عبر معرّفاتها.

Get Minimal Product Dataجلب بيانات مختصرة للمنتجات

Retrieves only product IDs and names.يعرض معرّف المنتج واسمه فقط.

Retrieves products and categories for the home page (parent ID = 0).يعرض المنتجات والأقسام للصفحة الرئيسية (معرّف القسم الأب = 0).

Get Content for Specific Categoryجلب محتوى قسم معيّن

Replace [category.id] with the desired category ID to retrieve its products and subcategories.استبدل [category.id] بمعرّف القسم المطلوب لعرض منتجاته وأقسامه الفرعية.

Creates a new order for a product. Must include a unique order_uuid to prevent duplicate orders.ينشئ طلباً جديداً لمنتج. يجب إرفاق order_uuid فريد لمنع تكرار الطلبات.

Response Exampleمثال على الاستجابة

{
    "status": "OK",
    "data": {
        "order_id": "ID_9fffb0d849a45215",
        "status": "accept",
        "price": 1.26048,
        "data": {
            "playerId": "test"
        },
        "replay_api": [
            {
                "replay": ["erg3eg"]
            }
        ]
    }
}

Checks the status of one or multiple orders.يفحص حالة طلب واحد أو عدة طلبات.

Check by Order UUIDالفحص عبر UUID الخاص بالطلب

Replace [ID_a37aaa06] with your order ID or UUID (when using uuid=1 parameter).استبدل [ID_a37aaa06] بمعرّف طلبك أو الـ UUID الخاص به (عند استخدام المعامل uuid=1).

Response Exampleمثال على الاستجابة

{
    "status": "OK",
    "data": [
        {
            "order_id": "ID_9fffb0d849a45215",
            "quantity": 1,
            "data": {
                "playerId": "test"
            },
            "created_at": "2025-04-10 13:55:48",
            "product_name": "A-60UC-stock",
            "price": "1.2604800000000000",
            "status": "accept",
            "replay_api": ["erg3eg"]
        }
    ]
}

Top up your balance programmatically with Syriatel Cash or Sham Cash. Payment methods: syriatel_cash and cham_cash.اشحن رصيدك برمجياً عبر سيريتل كاش أو شام كاش. طرق الدفع: syriatel_cash و cham_cash.

How it worksطريقة العمل

1. Enable "Allow my account to deposit via API" in your API page (shown only if the admin allowed it for you).فعّل «السماح لحسابي بالإيداع عبر API» من صفحة API (يظهر فقط إذا سمح لك الأدمن).
2. Call open-new-Trans to get the wallet and a Trans_id.استدعِ open-new-Trans لتحصل على المحفظة و Trans_id.
3. Transfer the money to the wallet before expired_in minutes pass.حوّل المبلغ إلى المحفظة قبل مرور expired_in دقيقة.
4. Wait 15 seconds (or until you get the deposit.detected webhook), then call Prove_Trans with the transfer operation number and your Trans_id.انتظر 15 ثانية (أو حتى يصلك Webhook deposit.detected) ثم استدعِ Prove_Trans برقم عملية التحويل و Trans_id.

1) Open a transaction1) فتح عملية

Example: /client/api/open-new-Trans/syriatel_cashمثال: /client/api/open-new-Trans/syriatel_cash

Successنجاح

{
    "status": "OK",
    "data": {
        "bankname": "Syriatel Cash",
        "wallet": "0933xxxxxx",
        "expired_in": "10",
        "msg": "أكمل التحويل وتأكيد الدفع عبر /Prove_Trans خلال الوقت المحدد",
        "Trans_id": "ID_100"
    }
}

Failureفشل

{
    "status": "ERROR",
    "error_code": 200,
    "msg": "هناك عملية أخرى في الإنتظار"
}

Other failures: 201 unknown / unavailable payment method, 122 deposit is not enabled for your account.أخطاء أخرى: 201 طريقة دفع غير معروفة أو غير متاحة، 122 الإيداع غير مفعّل لحسابك.

2) Prove the transaction2) إثبات العملية

id = the transfer operation number you got from the payment app. Example: /client/api/Prove_Trans/123456789/ID_100. Wait 15 seconds after the transfer so it appears in the account log.id = رقم عملية التحويل الذي ظهر لك في تطبيق الدفع. مثال: /client/api/Prove_Trans/123456789/ID_100. انتظر 15 ثانية بعد التحويل ليظهر في سجل الحساب.

Successنجاح

{
    "status": "OK",
    "data": {
        "Trans_num": "123456789",
        "amount": 15000,
        "currency": "SYP",
        "final_amount": "100.00 Dollar",
        "Trans_id": "ID_100"
    }
}

Failure examplesأمثلة الفشل

{ "status": "ERROR", "error_code": 201, "msg": "لم يتم العثور عليها" }

{ "status": "ERROR", "error_code": 201, "msg": "تم استخدام هذه العملية مسبقاً (عبر الموقع أو عبر الـ API)." }

{ "status": "ERROR", "error_code": 201, "msg": "هذه الحوالة ليست ضمن وقت هذه العملية." }

{ "status": "ERROR", "error_code": 201, "msg": "المبلغ أقل من الحد الأدنى (70 SYP)." }

{ "status": "ERROR", "error_code": 111, "msg": "Try again after 1 minute" }

On a failure the transaction stays open, so you can retry before it expires (except when the transfer number was already used). Do not call faster than once every 5 seconds.عند الفشل تبقى العملية مفتوحة فيمكنك إعادة المحاولة قبل انتهاء وقتها (إلا إذا كان رقم التحويل مستخدماً مسبقاً). لا تستدعِ أسرع من مرة كل 5 ثوانٍ.

3) Cancel a transaction3) إلغاء عملية

Example: /client/api/cancel/Trans/syriatel_cash/ID_100مثال: /client/api/cancel/Trans/syriatel_cash/ID_100

Successنجاح

{
    "status": "OK",
    "data": { "Trans_id": "ID_100", "msg": "تم إلغاء العملية" }
}

Failureفشل

{
    "status": "ERROR",
    "error_code": 203,
    "msg": "تعذر إلغاء العملية"
}

It fails if the transaction does not exist, belongs to another payment method, or is no longer waiting (completed, expired or already cancelled).يفشل إذا لم توجد العملية، أو كانت لطريقة دفع أخرى، أو لم تعد بانتظار الدفع (مكتملة أو منتهية أو ملغاة سابقاً).

Set a Webhook URL in your API page and we will POST the order result to it when an order becomes accept or reject. The body is the same JSON as the Check Orders response.ضع رابط Webhook في صفحة API، وسنرسل إليه نتيجة الطلب عندما يصبح accept أو reject. الجسم هو نفس JSON الخاص بفحص الطلبات.

Request bodyجسم الطلب (Request body)

{
    "status": "OK",
    "data": [
        {
            "order_id": "ID_9fffb0d849a45215",
            "quantity": 1,
            "data": { "playerId": "test" },
            "created_at": "2025-04-10 13:55:48",
            "product_name": "A-60UC-stock",
            "price": "1.2604800000000000",
            "status": "accept",
            "replay_api": ["erg3eg"]
        }
    ]
}

Headersالترويسات (Headers)

Content-Type: application/json
X-Webhook-Event: order.status
X-Order-Id: ID_9fffb0d849a45215
X-Webhook-Signature: sha256=<HMAC-SHA256(request body, your API token)>

Reply with any 2xx to confirm; otherwise we retry a few times. Signature check is optional: HMAC-SHA256 of the raw body using your API token.أرجع أي رد 2xx للتأكيد، وإلا سنعيد المحاولة عدة مرات. التحقق من التوقيع اختياري: HMAC-SHA256 للجسم باستخدام API token.

Tick "also notify me when a product price or availability changes" in your API page and the same webhook URL will also receive the events below. Tell them apart with the X-Webhook-Event header or the event field. The product object is the same as in /client/api/products, and the price is your price.فعّل خيار «أرسل لي أيضاً عند تغيّر سعر منتج أو توفّره» في صفحة API، فيصل على نفس رابط الـ Webhook الأحداث التالية. ميّزها عبر الترويسة X-Webhook-Event أو الحقل event. كائن المنتج مطابق لما في /client/api/products، والسعر هو سعرك أنت.

product.price — price changedتغيّر السعر

{
    "event": "product.price",
    "time": "2025-04-10 14:02:11",
    "data": {
        "id": 365,
        "name": "UC 60",
        "price": 0.110,
        "old_price": 0.104,
        "available": true,
        "qty_values": { "min": 1, "max": "15000" },
        "product_type": "amount",
        "category_name": "UC 60"
    }
}

product.availability — availability changedتغيّر التوفر

{
    "event": "product.availability",
    "time": "2025-04-10 14:05:42",
    "data": {
        "id": 365,
        "name": "UC 60",
        "price": 0.110,
        "available": false,
        "qty_values": { "min": 1, "max": "15000" },
        "product_type": "amount",
        "category_name": "UC 60"
    }
}

available: false = out of stock, true = back in stock. Same reply rule: answer 2xx.available: false = غير متوفر، وtrue = عاد متوفراً. نفس قاعدة الرد: أرجع 2xx.

deposit.detected — transfer arrived (deposit not done yet)وصلت حوالة (الإيداع لم يتم بعد)

{
    "event": "deposit.detected",
    "time": "2025-04-10 14:20:05",
    "data": {
        "Trans_id": "ID_100",
        "status": "awaiting_prove",
        "amount": 25000,
        "currency": "SYP",
        "final_amount": "166.67 Dollar",
        "msg": "وصلت حوالة إلى المحفظة. أرسل طلب Prove_Trans برقم عملية التحويل لإتمام الإيداع"
    }
}

If you have a webhook URL and deposit via API is enabled, we send this when a transfer reaches our wallet inside the time of your open transaction. The deposit is NOT done yet and nothing was added to your balance: it is only a signal telling you to send the Prove_Trans request now. final_amount is what will be added (after fees/bonus). For security the transfer number is not included: you already have it from the payment app. The notice is sent once per transfer; times are in Syria time.إذا كان لديك رابط Webhook والإيداع عبر API مفعّل، نرسل هذا الإشعار عندما تصل حوالة إلى محفظتنا ضمن وقت عمليتك المفتوحة. الإيداع لم يتم بعد ولم يُضَف أي رصيد: هو مجرد إشارة لتعرف أنه حان وقت إرسال طلب Prove_Trans. final_amount هو ما سيُضاف (بعد العمولة/البونص). لأسباب أمنية لا نرسل رقم الحوالة: هو عندك أصلاً من تطبيق الدفع. يُرسل الإشعار مرة واحدة لكل حوالة، والأوقات بتوقيت سوريا.

Error Response Formatصيغة استجابة الخطأ

When a request fails, status is ERROR, followed by error_code and msg:عند فشل الطلب تكون قيمة status هي ERROR، متبوعة بـ error_code و msg:

{
    "status": "ERROR",
    "error_code": 110,
    "msg": "Product not available now"
}