API دستاویزات

آپ کی API کلید

API کی جانچ کریں

ایک کارروائی منتخب کریں، پیرامیٹرز بھریں، اور درخواست بھیجیں۔ لاگ ان ہونے پر، آپ کی API کلید خود بخود لوڈ ہو جاتی ہے۔

curl -X POST "https://hstockplus.net/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

API اینڈ پوائنٹ

تمام API درخواستیں اس اینڈ پوائنٹ پر HTTP POST کے ذریعے بھیجی جانی چاہئیں۔

اختیاری زبان (lang)

اختیاری۔ ہدف زبان کا کوڈ۔ نیچے دیے گئے معاون کوڈز میں سے ایک استعمال کریں۔ جب سیٹ ہو اور en نہ ہو، تو قابل ترجمہ فیلڈز اس زبان میں واپس کیے جاتے ہیں۔ اگر ترجمہ ابھی دستیاب نہیں ہے، تو API انگریزی واپس کرتا ہے۔

پڑھنے کی کارروائیوں پر معاون: categories, subcategory_info, services, products, inventory ((ذیلی مصنوعات کے نام)), sms_projects, اور sms_countries. انگریزی کے لیے lang کو چھوڑ دیں یا en استعمال کریں۔

خدمات/مصنوعات پر category اور subcategory فلٹر پیرامیٹرز ہمیشہ کینونیکل انگریزی نام استعمال کرتے ہیں، چاہے lang سیٹ ہو۔

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

زمرے حاصل کریں

تمام زمرے اور ہر زمرے کے ذیلی زمرے حاصل کریں۔ Services List کو زمرے یا ذیلی زمرے کے مطابق فلٹر کرنے کے لیے ان اقدار کا استعمال کریں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories" \
  -d "lang=zh"

مثال جواب:

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

ذیلی زمرے کی معلومات

subcategoryId کے ذریعے ذیلی زمرے کی تفصیلات حاصل کریں، بشمول والدین کا زمرہ۔ Products List کی قطاروں سے subcategoryId استعمال کریں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=subcategory_info" \
  -d "subcategoryId=674a1f77bcf86cd799439099" \
  -d "lang=zh"

مثال جواب:

{
  "subcategoryId": "674a1f77bcf86cd799439099",
  "name": "Gmail",
  "slug": "gmail",
  "imageUrl": "https://cdn.hstockplus.org/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

دکانوں کی فہرست

فعال دکانوں کی فہرست بنائیں جن میں بنیادی معلومات، مصنوعات کی تعداد اور جائزے کی درجہ بندی شامل ہو۔ پرائیویسی کے لیے دکانوں کے نام چھپائے گئے ہیں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

پیجینیشن کے ساتھ:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

کوپنز کی فہرست

ہر شاپ کے وہ تمام کوپن کوڈ دکھائیں جو اس وقت استعمال ہو سکتے ہیں، ہر ایک کی شرائط کے ساتھ۔ کوئی کوڈ coupon کے طور پر action=add کو دیں۔ صرف آپ کے اکاؤنٹ کے لیے بنائے گئے کوڈ (مثلاً ٹکٹ سے تھوک قیمت کا کوٹ) بھی شامل ہیں اور private کے طور پر نشان زد ہیں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=coupons"

مثال جواب:

{
  "coupons": [
    {
      "code": "SAVE10",
      "type": "percentage",
      "value": 10,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "shop",
      "minPurchase": 20,
      "remainingUses": 87,
      "expiresAt": "2026-11-30T23:59:59.000Z"
    },
    {
      "code": "BULK500",
      "type": "percentage",
      "value": 5,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "services",
      "services": [110469, 110470],
      "minQuantity": 100,
      "quantityTiers": [
        { "minQuantity": 100, "value": 5 },
        { "minQuantity": 500, "value": 12 }
      ],
      "maxUsesPerUser": 1,
      "remainingUses": 40
    }
  ],
  "total": 2
}

کوپن کی رقم آپ کی ری سیلر رعایت کے بعد بچنے والی رقم سے کاٹی جاتی ہے۔ اگر کوپن میں کوئی شرط نہ ہو تو اختیاری فیلڈز شامل نہیں کی جاتیں۔

مصنوعات کی فہرست

صرف مارکیٹ پلیس پروڈکٹس کی فہرست بنائیں (SMM خدمات نہیں)۔ سروسز لسٹ میں موجود پروڈکٹ قطاروں کی طرح فیلڈز، بشمول id (پروڈکٹ اینٹیٹی آئی ڈی)، service (دوستانہ سروس نمبر)، description اور imageUrl۔ اختیاری productIds صرف ان پروڈکٹس کو واپس کرتا ہے (فہرست سے دوستانہ سروس نمبرز اور/یا پروڈکٹ اینٹیٹی آئی ڈیز، کوما سے الگ یا JSON صف، زیادہ سے زیادہ 100)۔ اختیاری sort=sold آرڈرز کو ادا شدہ آرڈر یونٹس کے نزولی ترتیب سے ترتیب دیتا ہے (پہلے بہترین فروخت کنندگان)۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

product IDs کے مطابق فلٹر کریں:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

پیجینیشن کے ساتھ:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

زمرے یا ذیلی زمرے کے مطابق فلٹر کریں:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

ذیلی زمرے میں بہترین فروخت کنندگان:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Twitter/X" \
  -d "sort=sold" \
  -d "page=1" \
  -d "limit=10"

صرف تجویز کردہ مصنوعات:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "isRecommended=true"

خدمات کی فہرست

تمام دستیاب خدمات حاصل کریں (اختیاری صفحہ بندی کے ساتھ)۔ ہر قطار میں id (انٹیٹی آئی ڈی)، service (فروخت کے لیے دوستانہ سروس نمبر)، stock، اور entityType (smm یا product) شامل ہیں۔ اختیاری entityType صرف product یا صرف smm کی قطاریں لوٹاتا ہے۔ اختیاری category اور subcategory پیرامیٹرز صرف اس زمرے یا ذیلی زمرے کی خدمات لوٹاتے ہیں (اقدار Get Categories API سے لی گئی ہیں)۔ اختیاری shopId صرف اس دکان کی مصنوعات اور خدمات لوٹاتا ہے (Shops List سے shopId استعمال کریں)۔ اختیاری productIds صرف مماثل قطاریں لوٹاتا ہے (فروخت کے لیے دوستانہ سروس نمبر اور/یا انٹیٹی آئی ڈیز؛ product یا smm قطاروں سے مماثل)۔ صرف مصنوعات کو فلٹر کرنے کے لیے action=products استعمال کریں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

پیجینیشن کے ساتھ:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

زمرے یا ذیلی زمرے کے مطابق فلٹر کریں:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

entityType کے مطابق فلٹر کریں:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "entityType=product"

مثال جواب:

{
  "services": [
    {
      "id": "507f1f77bcf86cd799439011",
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true,
      "description": "Verified Gmail account with recovery email",
      "imageUrl": "https://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099",
      "sold": 5300,
      "sellerRating": 4.0,
      "sellerReviewCount": 30,
      "returningBuyerRate": 0.52,
      "warrantyHours": 12
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

ہر قطار میں id (ہستی کی شناخت) اور service (آرڈرز کے لیے دوستانہ سروس نمبر)، stock، entityType (smm یا product)، اور autoDelivery شامل ہیں۔ مصنوعات کی قطاروں میں description، imageUrl، isRecommended، اور subcategoryId بھی شامل ہیں۔ جب limit 0 ہو یا چھوڑ دی جائے، تمام خدمات لوٹائی جاتی ہیں اور page/limit کل کے برابر ہوتے ہیں۔

پروڈکٹ کی قطاروں میں وہ اعداد بھی ہوتے ہیں جو پروڈکٹ پیج پر دکھائے جاتے ہیں: service پروڈکٹ نمبر ہے (پیج پر #48071)، sellerRating اور sellerReviewCount سیلر کی اسٹار ریٹنگ اور اس کے ریویوز کی تعداد ہیں، returningBuyerRate سیلر کے دوبارہ خریدنے والے خریداروں کا تناسب ہے (0.52 = 52%)، sold فروخت شدہ یونٹس ہیں، اور warrantyHours ڈیلیوری سے شمار ہونے والی فروخت کے بعد کی سروس کی مدت گھنٹوں میں ہے (0 = فروخت کے بعد کوئی سروس نہیں)۔ اگر سیلر کی ریٹنگ نہ ہو یا خریدار بہت کم ہوں تو sellerRating، sellerReviewCount اور returningBuyerRate شامل نہیں کیے جاتے۔

انوینٹری چیک کریں

کسی سروس کی موجودہ اسٹاک اور دستیابی اس کی ID سے حاصل کریں (وہی ID جو سروسز کی فہرست میں ہے)۔ مارکیٹ پلیس پروڈکٹس کے لیے JSON میں subproducts شامل ہوتے ہیں: فعال ویریئنٹس کی ایک اری، جس میں ہر ایک کے subproductId، name، stock (اس ویریئنٹ کا ظاہر کردہ اسٹاک) اور اپنی قیمت اور آرڈر کی حدیں ہوتی ہیں: available، rate، min، max، اور مقررہ پیکس میں فروخت ہونے والے آپشنز کے لیے packs۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

مثال کے جواب (SMM):

{
  "service": 1,
  "stock": 10000,
  "available": true,
  "rate": "0.5000",
  "entityType": "smm",
  "autoDelivery": true
}

مثال کے طور پر جواب (مصنوعہ)

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "rate": "25.0000",
  "min": 1,
  "max": 42,
  "entityType": "product",
  "autoDelivery": true,
  "subproducts": [
    { "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42, "available": true, "rate": "25.0000", "min": 1, "max": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0, "available": false, "rate": "60.0000", "min": 1, "max": 0 },
    {
      "subproductId": "674a1f77bcf86cd799439013", "name": "Pack", "stock": 500, "available": true, "rate": "0.0190", "min": 100, "max": 100,
      "packs": [
        { "quantity": 100, "price": "1.9000", "discountPercent": 5 },
        { "quantity": 500, "price": "9.0000", "discountPercent": 10 }
      ]
    }
  ],
  "warrantyHours": 24
}

جواب میں rate (فی یونٹ، خدمات کی فہرست جیسی سٹرنگ فارمیٹ)، entityType (smm یا product)، اور autoDelivery (true = خودکار ڈیلیوری، false = سپلائر دستی طور پر پورا کرتا ہے) شامل ہے۔ product خدمات کے لیے، min اور max خدمات کی فہرست میں بنیادی subproduct قطار سے مماثل ہوتے ہیں؛ اگر وہ subproduct آپ کا آرڈر پورا نہیں کر سکتا، تو پلیٹ فارم دوسرا subproduct منتخب کر سکتا ہے اور اس کی یونٹ قیمت وصول کر سکتا ہے۔ subproducts صف ہر فعال ویریئنٹ کو ڈسپلے اسٹاک کے ساتھ درج کرتی ہے؛ SMM انوینٹری کے جوابات subproducts کو خارج کرتے ہیں۔

ہر سب پروڈکٹ کی اپنی rate، min اور max ہوتی ہے: یہ وہ فی یونٹ قیمت اور مقدار کی حد ہے جو اس subproductId کو دینے پر add وصول کرتا ہے، آپ کے اکاؤنٹ پر کسی بھی ری سیلر رعایت سے پہلے۔ جو آپشنز مقررہ پیکس میں فروخت ہوتے ہیں ان کے لیے packs اسٹاک میں موجود ہر پیک (quantity، کل قیمت، discountPercent) کی فہرست دیتا ہے اور آپ کو انہی مقداروں میں سے ایک آرڈر کرنی ہوگی؛ تب rate، min اور max سب سے چھوٹے پیک کو ظاہر کرتے ہیں۔

warrantyHours (products only) is the product's after-sales window in hours counted from delivery, the same figure as in the services list; 0 means no after-sales.

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery. For products with multiple options (Select Option on the website), pass subproductId (from action=inventory) to choose which option to order — otherwise the default option is used.

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

# Product with multiple options: pick the subproductId from action=inventory
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=1" \
  -d "subproductId=674a1f77bcf86cd799439012"

# With a coupon code from action=coupons
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=10" \
  -d "coupon=SAVE10"

مثال جواب:

{
  "order": 23501,
  "entityType": "product",
  "charge": "22.5000",
  "couponDiscount": "2.5000",
  "warrantyHours": 24
}

charge is what was taken from your balance. couponDiscount is present only when a coupon was applied. warrantyHours (products only) is the after-sales window in hours counted from delivery, 0 = no after-sales; action=status returns the exact end time as warranty_expires_at.

آرڈر کی حیثیت

آرڈر کی حیثیت حاصل کریں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

مثال جواب:

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

پروڈکٹ آرڈرز (مثلاً اکاؤنٹس) کے لیے، جب آرڈر مکمل یا جزوی طور پر ڈیلیور ہو جائے، تو جواب میں "اکاؤنٹس" کا ایک سرنی شامل ہوتا ہے جس میں ڈیلیور کیے گئے اکاؤنٹس کی معلومات (ایک اکاؤنٹ کے لیے ایک سٹرنگ) ہوتی ہیں۔ جزوی ڈیلیوری کی صورت میں، صرف اب تک ڈیلیور ہونے والے اکاؤنٹس واپس کیے جاتے ہیں۔

autoDelivery: true اگر آرڈر خود بخود پورا ہو جاتا ہے (مثلاً SMM، آٹو/انوینٹری مصنوعات)؛ false اگر سپلائر کو دستی طور پر پورا کرنا ہو (کچھ وقت لگ سکتا ہے)۔

مثال کا جواب (پروڈکٹ آرڈر جس میں اکاؤنٹس ڈیلیور ہوئے ہوں):

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

ممکنہ حیثیتیں:

ریفنڈ شدہ آرڈر Canceled واپس کرتا ہے اور جزوی ریفنڈ شدہ آرڈر Partial۔ جب کوئی رقم واپس کی گئی ہو تو جواب میں "refunded" بھی شامل ہوتا ہے جس میں واپس کی گئی رقم USD میں ہوتی ہے۔

جواب کی مثال (فائلوں کی صورت میں ڈیلیور ہونے والا پروڈکٹ آرڈر):

کچھ پروڈکٹس (مثلاً سیشن آرکائیوز والے Telegram اکاؤنٹس) متنی اسناد کی بجائے، یا ان کے ساتھ، ZIP فائلوں کی صورت میں ڈیلیور ہوتی ہیں۔ تب جواب میں "files" اری شامل ہوتی ہے۔ ہر فائل ایک ڈیلیور شدہ آئٹم ہے۔ فائل action=order_file سے ڈاؤن لوڈ کریں۔

{
  "status": "Completed",
  "charge": "12.00",
  "start_count": 0,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": false,
  "files": [
    {
      "id": "66e6b2f0c3a1d2e4f5a6b7c8",
      "name": "sessions-001.zip",
      "size": 482113,
      "uploaded_at": "2026-09-15T08:30:00.000Z"
    }
  ]
}

آرڈر فائل ڈاؤن لوڈ کریں

اپنے آرڈر کی ایک ڈیلیوری فائل (ZIP) ڈاؤن لوڈ کریں۔ کامیابی پر جواب کا مواد خود فائل ہوتی ہے (Content-Type: application/zip)؛ ناکامی پر یہ "error" فیلڈ والا JSON ہوتا ہے۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=order_file" \
  -d "order=23501" \
  -d "file=66e6b2f0c3a1d2e4f5a6b7c8" \
  -o sessions-001.zip

خرابی کے جواب کی مثال:

{
  "error": "File not found"
}

محفوظ کرنے سے پہلے Content-Type ہیڈر دیکھیں: application/zip کا مطلب فائل ہے، application/json کا مطلب خرابی۔

Create cancel

ایک یا ایک سے زیادہ آرڈرز منسوخ کریں (PerfectPanel-مطابق بیچ فارمیٹ)۔ ہر اہل آرڈر کی رقم آپ کے بیلنس میں واپس کر دی جائے گی۔

مندرجہ ذیل تمام شرائط درست ہونی چاہئیں۔ رقم واپسی پر کارروائی کیے بغیر اہلیت جانچنے کے لیے allowcancel استعمال کریں۔

• جلد منسوخی: پلیٹ فارم کی خصوصیت فعال ہے (ایڈمن سیٹنگ)۔
• ابتدائی منسوخی: productType manual، auto، یا inventory ہے (SMM آٹو سروسز عام طور پر productType auto استعمال کرتی ہیں)۔
• جلد منسوخی: ادائیگی کی حیثیت مکمل یا جزوی ہے۔
• جلد منسوخی: آرڈر کی حیثیت زیر التواء، پروسیسنگ، یا خرابی ہے (فراہم کنندہ کی خرابیاں جاری کے طور پر ظاہر ہوتی ہیں)۔
• جلد منسوخی: کوئی external_id نہیں (آرڈر ابھی کسی بیرونی سپلائر یا فراہم کنندہ کو نہیں بھیجا گیا)۔
• جلد منسوخی: ادائیگی مکمل ہونے کے بعد کم از کم N منٹ گزر چکے ہیں (auto_order_early_refund_minutes، ڈیفالٹ 30)۔
• جلد منسوخی: صارف نے پہلے ہی اس آرڈر پر جلد خود واپسی کا استعمال نہیں کیا ہے۔
• جلد منسوخی: آرڈر مکمل طور پر فراہم نہیں کیا گیا (جزوی فراہمی پر غیر فراہم کردہ حصے کے لیے متناسب رقم واپس کی جاتی ہے)۔
• جلد منسوخی: قابل واپسی رقم باقی ہے (refundedAmount آرڈر کی کل رقم سے کم ہے)۔
• جلد منسوخی: آرڈر پر کوئی فعال تنازعہ نہیں ہے۔
• جلد منسوخی: فراہم کنندہ کی طرف سے درخواست کردہ یا مکمل حیثیت میں کوئی نکاسی نہیں۔

جزوی فراہمی پر متناسب جزوی رقم واپس کی جاتی ہے؛ فراہم کردہ اکاؤنٹس برقرار رہتے ہیں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=23501,23502"

مثال جواب:

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Incorrect order ID"
    }
  }
]

اجازت دیں منسوخ

چیک کریں کہ آیا ایک یا زیادہ آرڈرز ابھی منسوخ کیے جا سکتے ہیں (منسوخی کے وہی اہلیت کے قواعد، لیکن کوئی رقم واپس نہیں کی جاتی)۔ منسوخ کرنے سے پہلے استعمال کریں تاکہ ناکام درخواستوں سے بچا جا سکے۔ بیچ آرڈر آئی ڈیز کو سپورٹ کرتا ہے (کوما سے الگ، زیادہ سے زیادہ 100)۔

مندرجہ ذیل تمام شرائط درست ہونی چاہئیں۔ رقم واپسی پر کارروائی کیے بغیر اہلیت جانچنے کے لیے allowcancel استعمال کریں۔

• جلد منسوخی: پلیٹ فارم کی خصوصیت فعال ہے (ایڈمن سیٹنگ)۔
• ابتدائی منسوخی: productType manual، auto، یا inventory ہے (SMM آٹو سروسز عام طور پر productType auto استعمال کرتی ہیں)۔
• جلد منسوخی: ادائیگی کی حیثیت مکمل یا جزوی ہے۔
• جلد منسوخی: آرڈر کی حیثیت زیر التواء، پروسیسنگ، یا خرابی ہے (فراہم کنندہ کی خرابیاں جاری کے طور پر ظاہر ہوتی ہیں)۔
• جلد منسوخی: کوئی external_id نہیں (آرڈر ابھی کسی بیرونی سپلائر یا فراہم کنندہ کو نہیں بھیجا گیا)۔
• جلد منسوخی: ادائیگی مکمل ہونے کے بعد کم از کم N منٹ گزر چکے ہیں (auto_order_early_refund_minutes، ڈیفالٹ 30)۔
• جلد منسوخی: صارف نے پہلے ہی اس آرڈر پر جلد خود واپسی کا استعمال نہیں کیا ہے۔
• جلد منسوخی: آرڈر مکمل طور پر فراہم نہیں کیا گیا (جزوی فراہمی پر غیر فراہم کردہ حصے کے لیے متناسب رقم واپس کی جاتی ہے)۔
• جلد منسوخی: قابل واپسی رقم باقی ہے (refundedAmount آرڈر کی کل رقم سے کم ہے)۔
• جلد منسوخی: آرڈر پر کوئی فعال تنازعہ نہیں ہے۔
• جلد منسوخی: فراہم کنندہ کی طرف سے درخواست کردہ یا مکمل حیثیت میں کوئی نکاسی نہیں۔

جب allowcancel 1 ہو، تو جواب میں refundAmount شامل ہوتا ہے (وہ رقم جو منسوخی واپس کرے گی)۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=allowcancel" \
  -d "orders=23501,23502"

مثال جواب:

[
  {
    "order": 23501,
    "allowcancel": 1,
    "refundAmount": 5.00
  },
  {
    "order": 23502,
    "allowcancel": 0,
    "error": "Early auto refund is not available for this order",
    "reason": "BEFORE_MIN_WAIT",
    "eligibleAfter": "2026-06-23T12:30:00.000Z"
  }
]

بقیہ

اپنا موجودہ بیلنس حاصل کریں۔

مثال درخواست:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

مثال جواب:

{
  "balance": "100.00",
  "currency": "USD"
}

SMS ویریفکیشن API

ایس ایم ایس تصدیقی خدمات کے لیے مخصوص اختتامی نقاط۔

SMS آرڈرز کی اپنی آرڈر IDs ہوتی ہیں۔ ان کے ساتھ sms_code، sms_status اور sms_cancel استعمال کریں؛ status، cancel اور allowcancel صرف پروڈکٹ اور SMM آرڈرز کے لیے ہیں۔

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

[
  {
    "country_code": "+1",
    "country_name": "United States"
  },
  {
    "country_code": "+44",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "4055123415",
      "dial_code": "+1",
      "phone_full": "+14055123415",
      "country": "US",
      "expires_at": "2026-01-01T12:15:00.000Z",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}
// OR, once expires_at has passed without a code (call sms_cancel for a refund)
{
  "status": "expired",
  "message": "No code arrived before the number expired. Call action=sms_cancel for a refund."
}

{
  "status": "code_received",
  "phone": "4055123415",
  "dial_code": "+1",
  "phone_full": "+14055123415",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "refunded": false,
  "expires_at": "2026-01-01T12:15:00.000Z"
}
// status: phone_acquired | code_received | expired | released

{
  "order": 12345,
  "status": "cancelled",
  "refunded": true,
  "refund_amount": "0.5000",
  "currency": "USD"
}
// OR
{
  "error": "Verification code already received, cannot release"
}

خرابی کے جوابات

آپ کو درپیش ہونے والی عام خرابی کے جوابات۔