نقاط الطلبات

تُنشأ الطلبات بـ UUID تولّده أنت. ذلك الـ UUID هو مفتاح idempotency: إعادة إرساله تعيد الطلب الأصلي بدل الخصم مرتين. ثم تُقرأ الحالة لكل طلب على حدة، أو في دفعات تصل إلى خمسين، أو كقائمة مرقَّمة الصفحات.

POST

/orders/create

Create Order

Place a new order. You must provide a unique UUID as the order_id for idempotency. The wallet will be charged immediately.

حدّ المعدل120 req / 60s per user

ملاحظة: The order_id is your idempotency key. If you retry with the same UUID, the existing order is returned instead of creating a duplicate.

جسم الطلب

الاسمالنوعمطلوبالوصفمثال
order_idstring (UUID)نعمA unique UUID for this order (any format: v1, v4, v7, etc.). Used as an idempotency key.01912345-6789-7abc-8def-0123456789ab
sub_category_idnumberنعمThe product subcategory ID.999
quantitynumberنعمNumber of units to order (positive integer).1
requirementsobjectنعمPlayer delivery info. Include all fields returned by the Get Category Requirements endpoint.{"player_id": "123456789", "server": "Asia"}
expected_unit_pricestringلاPrice protection. If current price exceeds this value, the order is rejected.0.950000
الطلب
curl -s -X POST "https://shop2topup.com/api/endpoints/v1/orders/create" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "order_id": "01912345-6789-7abc-8def-0123456789ab",
  "sub_category_id": 999,
  "quantity": 1,
  "requirements": {
    "player_id": "123456789",
    "server": "Asia"
  },
  "expected_unit_price": 0.95
}'
مثال استجابة
{
  "success": true,
  "order": {
    "order_id": "01912345-6789-7abc-8def-0123456789ab",
    "status": "pending",
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "subcategory_name": "FF 100 Diamonds",
    "quantity": 1,
    "charged_amount": "0.950000",
    "currency": "USD",
    "created_at": "2024-06-15T12:00:00Z"
  }
}
GET

/orders/:orderId

Get Order Status

Retrieve the current status and details of a specific order.

حدّ المعدل3 req / 60s per user + orderId

معاملات المسار

الاسمالنوعمطلوبالوصفمثال
orderIdstring (UUID)نعمThe order ID to look up.01912345-6789-7abc-8def-0123456789ab
الطلب
curl -s "https://shop2topup.com/api/endpoints/v1/orders/01912345-6789-7abc-8def-0123456789ab" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
مثال استجابة
{
  "success": true,
  "order": {
    "order_id": "01912345-6789-7abc-8def-0123456789ab",
    "status": "completed",
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "subcategory_name": "FF 100 Diamonds",
    "quantity": 1,
    "charged_amount": "0.950000",
    "currency": "USD",
    "created_at": "2024-06-15T12:00:00Z",
    "completed_at": "2024-06-15T12:00:05Z",
    "vouchers": [],
    "sub_transactions": [
      {
        "id": 1,
        "status": "completed",
        "player_id": "123456789",
        "player_name": "ProGamer99",
        "amount": "0.950000",
        "created_at": "2024-06-15T12:00:00Z",
        "completed_at": "2024-06-15T12:00:05Z"
      }
    ]
  }
}
POST

/orders/batch

Batch Get Orders

Retrieve multiple orders at once by their IDs. Maximum 50 order IDs per request.

حدّ المعدل2 req / 60s per user

جسم الطلب

الاسمالنوعمطلوبالوصفمثال
order_idsstring[]نعمArray of order UUIDs (max 50).["uuid-1", "uuid-2"]
الطلب
curl -s -X POST "https://shop2topup.com/api/endpoints/v1/orders/batch" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "order_ids": [
    "uuid-1",
    "uuid-2"
  ]
}'
مثال استجابة
{
  "success": true,
  "orders": [
    {
      "order_id": "01912345-6789-7abc-8def-0123456789ab",
      "status": "completed",
      "charged_amount": "0.950000"
    }
  ],
  "not_found": [
    "uuid-that-does-not-exist"
  ]
}
GET

/orders

List Orders

List your orders with pagination and optional filters by status and date range.

حدّ المعدل2 req / 60s per user

معاملات الاستعلام

الاسمالنوعمطلوبالوصفمثال
pagenumberلاPage number (default: 1).1
limitnumberلاResults per page, 1-100 (default: 50).50
statusstringلاFilter by status: pending, completed, refunded, partial.completed
created_afterstring (ISO 8601)لاFilter orders created after this date.2024-01-01T00:00:00Z
created_beforestring (ISO 8601)لاFilter orders created before this date.2024-12-31T23:59:59Z
الطلب
curl -s "https://shop2topup.com/api/endpoints/v1/orders?page=1&limit=50&status=completed&created_after=2024-01-01T00:00:00Z&created_before=2024-12-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
مثال استجابة
{
  "success": true,
  "orders": [
    {
      "order_id": "01912345-6789-7abc-8def-0123456789ab",
      "status": "completed",
      "subcategory_name": "FF 100 Diamonds",
      "quantity": 1,
      "charged_amount": "0.950000",
      "created_at": "2024-06-15T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1
  }
}

أرسل طلبًا حقيقيًا من هذه الصفحة

الصق مفتاح API لمناداة هذه النقاط مباشرةً. يبقى المفتاح في تبويب المتصفّح هذا ولا يُرسل إلا إلى الواجهة البرمجية نفسها.

Enter your API key to use the interactive playground. Get your API key

اختر نقطة نهاية

1
2
Order Details

Enter your API key above to try this endpoint.

جديد على المنصة؟ ابدأ من نظرة عامة على واجهة شحن الألعاب للموزّعين، أو اقرأ نظرة عامة على برنامج موزّعي SHOP2TOPUP لمعرفة كيفية عمل حساب الشريك.

مرجع API الطلبات — إنشاء وقراءة ودفعات وقوائم