एपीआई दस्तावेज़ीकरण

Your API Key

API का परीक्षण करें

कोई कार्य चुनें, पैरामीटर भरें और अनुरोध भेजें। लॉग इन होने पर, आपकी API कुंजी स्वचालित रूप से लोड हो जाती है।

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

API एंडपॉइंट

सभी API अनुरोध इस एंडपॉइंट पर HTTP POST के माध्यम से भेजे जाने चाहिए।

हिन्दी

वैकल्पिक। लक्ष्य भाषा कोड। नीचे सूचीबद्ध समर्थित कोडों में से एक का उपयोग करें। जब सेट किया जाए और en न हो, तो अनुवाद योग्य फ़ील्ड उस भाषा में लौटाए जाते हैं। यदि अभी तक अनुवाद उपलब्ध नहीं है, तो API अंग्रेज़ी लौटाता है।

पढ़ने की कार्रवाइयों पर समर्थित: categories, subcategory_info, services, products, inventory ((उप-उत्पादों के नाम)), sms_projects, और sms_countries. हिंदी (hi) के लिए lang को हटाएँ या अंग्रेज़ी के लिए en का उपयोग करें।

सेवाओं/उत्पादों पर श्रेणी और उपश्रेणी फ़िल्टर पैरामीटर हमेशा विहित अंग्रेजी नामों का उपयोग करते हैं, भले ही भाषा सेट की गई हो।

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=categories" \
  -d "lang=zh"

उदाहरण प्रतिक्रिया:

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

उपश्रेणी जानकारी

subcategoryId द्वारा उपश्रेणी विवरण प्राप्त करें, जिसमें मूल श्रेणी शामिल हो। उत्पाद सूची पंक्तियों से 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"

Coupons List

List every shop's coupon codes that can be used right now, with the conditions each one needs. Pass a code as coupon to action=add. Codes made only for your account (for example a bulk-price quote from a ticket) are included and marked 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
}

A coupon is taken off what is left after your reseller discount. Optional fields are omitted when the coupon has no such condition.

उत्पादों की सूची

केवल मार्केटप्लेस उत्पादों की सूची बनाएं (कोई 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"

उत्पाद आईडी द्वारा फ़िल्टर करें:

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"

इकाई प्रकार के अनुसार फ़िल्टर करें

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 कुल के बराबर होता है।

Product rows also carry the figures shown on the product page: service is the product number (#48071 on the page), sellerRating and sellerReviewCount are the seller's star rating and its number of reviews, returningBuyerRate is the seller's share of returning buyers (0.52 = 52%), sold is units sold, and warrantyHours is the after-sales window in hours counted from delivery (0 = no after-sales). sellerRating, sellerReviewCount and returningBuyerRate are omitted when the seller has no rating or too few buyers.

इन्वेंटरी जांचें

Get current stock and availability for a service by its ID (same ID as in the services list). For marketplace products, the JSON includes subproducts: an array of active variants, each with subproductId, name, stock (display stock for that variant), and its own price and order limits: available, rate, min, max, and packs for options sold in fixed 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
}

प्रतिक्रिया में दर (प्रति इकाई, सेवाओं की सूची के समान स्ट्रिंग प्रारूप), entityType (smm या product), और autoDelivery (true = स्वचालित डिलीवरी, false = आपूर्तिकर्ता मैन्युअल रूप से पूरा करता है) शामिल है। उत्पाद सेवाओं के लिए, min और max सेवाओं की सूची में प्राथमिक उप-उत्पाद पंक्ति से मेल खाते हैं; यदि वह उप-उत्पाद आपके ऐड ऑर्डर को पूरा नहीं कर सकता है, तो प्लेटफ़ॉर्म कोई अन्य उप-उत्पाद चुन सकता है और उसकी इकाई मूल्य वसूल सकता है। subproducts ऐरे प्रदर्शन स्टॉक के साथ प्रत्येक सक्रिय वेरिएंट को सूचीबद्ध करता है; SMM इन्वेंट्री प्रतिक्रियाएँ उप-उत्पादों को छोड़ देती हैं।

Each subproduct carries its own rate, min and max: this is the unit price and quantity range that add charges when you pass that subproductId, before any reseller discount on your account. For options sold in fixed packs, packs lists each pack in stock (quantity, total price, discountPercent) and you must order one of those quantities; rate, min and max then describe the smallest pack.

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: यदि ऑर्डर स्वचालित रूप से पूरा होता है (जैसे SMM, ऑटो/इन्वेंट्री उत्पाद) तो true; यदि आपूर्तिकर्ता को मैन्युअल रूप से पूरा करना हो (इसमें कुछ समय लग सकता है) तो false।

उदाहरण प्रतिक्रिया (खाते वितरित किए गए उत्पाद आदेश के साथ):

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

संभावित स्थितियाँ:

A refunded order returns Canceled, and a partly refunded order returns Partial. When any money was refunded, the response also carries "refunded" with the refunded amount in USD.

Example Response (product order delivered as files):

Some products (for example Telegram accounts with session archives) are delivered as ZIP files instead of, or in addition to, text credentials. The response then includes a "files" array. Each file is one delivered item. Download a file with 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"
    }
  ]
}

Download Order File

Download one delivery file (ZIP) of your order. On success the response body is the file itself (Content-Type: application/zip); on failure it is JSON with an "error" field.

उदाहरण अनुरोध:

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

Example Error Response:

{
  "error": "File not found"
}

Check the Content-Type header before saving: application/zip means the file, application/json means an error.

रद्द करें

एक या अधिक ऑर्डर रद्द करें (PerfectPanel-संगत बैच प्रारूप)। प्रत्येक पात्र ऑर्डर की राशि आपके बैलेंस में वापस कर दी जाएगी।

निम्नलिखित सभी बातें सत्य होनी चाहिए। रिफंड प्रोसेस किए बिना पात्रता जांचने के लिए allowcancel का उपयोग करें।

• जल्दी रद्द करें: प्लेटफ़ॉर्म सुविधा सक्षम (एडमिन सेटिंग)।
• जल्दी रद्द करें: productType मैनुअल, ऑटो, या इन्वेंट्री है (SMM ऑटो सेवाएं आमतौर पर productType ऑटो का उपयोग करती हैं)।
• जल्दी रद्द करें: भुगतान की स्थिति पूर्ण या आंशिक है।
• जल्दी रद्द करें: ऑर्डर की स्थिति लंबित, प्रक्रियाधीन या त्रुटि है (प्रदाता त्रुटियाँ प्रगति पर दिखाई देती हैं)।
• जल्दी रद्द करें: कोई बाहरी आईडी नहीं (ऑर्डर अभी तक किसी बाहरी आपूर्तिकर्ता या प्रदाता को नहीं भेजा गया है)।
• जल्दी रद्द करें: भुगतान पूरा होने के बाद कम से कम 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"
    }
  }
]

अनुमति रद्द करें

जाँचें कि एक या अधिक ऑर्डर अभी रद्द किए जा सकते हैं या नहीं (रद्द करने के समान पात्रता नियम, लेकिन कोई रिफंड प्रोसेस नहीं होता)। cancel कॉल करने से पहले इसका उपयोग करें ताकि असफल अनुरोधों से बचा जा सके। बैच ऑर्डर आईडी (कॉमा से अलग, अधिकतम 100) को सपोर्ट करता है।

निम्नलिखित सभी बातें सत्य होनी चाहिए। रिफंड प्रोसेस किए बिना पात्रता जांचने के लिए allowcancel का उपयोग करें।

• जल्दी रद्द करें: प्लेटफ़ॉर्म सुविधा सक्षम (एडमिन सेटिंग)।
• जल्दी रद्द करें: productType मैनुअल, ऑटो, या इन्वेंट्री है (SMM ऑटो सेवाएं आमतौर पर productType ऑटो का उपयोग करती हैं)।
• जल्दी रद्द करें: भुगतान की स्थिति पूर्ण या आंशिक है।
• जल्दी रद्द करें: ऑर्डर की स्थिति लंबित, प्रक्रियाधीन या त्रुटि है (प्रदाता त्रुटियाँ प्रगति पर दिखाई देती हैं)।
• जल्दी रद्द करें: कोई बाहरी आईडी नहीं (ऑर्डर अभी तक किसी बाहरी आपूर्तिकर्ता या प्रदाता को नहीं भेजा गया है)।
• जल्दी रद्द करें: भुगतान पूरा होने के बाद कम से कम 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 Verification API

एसएमएस सत्यापन सेवाओं के लिए समर्पित एंडपॉइंट्स।

SMS orders have their own order IDs. Use sms_code, sms_status and sms_cancel with them; status, cancel and allowcancel are for product and SMM orders only.

[
  {
    "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"
}

त्रुटि प्रतिक्रियाएँ

आपके सामने आने वाली सामान्य त्रुटि प्रतिक्रियाएँ।