API ডকুমেন্টেশন

আপনার 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 এর মাধ্যমে পাঠানো উচিত।

ঐচ্ছিক ভাষা (lang)

ঐচ্ছিক। লক্ষ্য ভাষা কোড। নীচে তালিকাভুক্ত সমর্থিত কোডগুলির একটি ব্যবহার করুন। যখন সেট করা হয় এবং en না হয়, তখন অনুবাদযোগ্য ক্ষেত্রগুলি সেই ভাষায় ফেরত দেওয়া হয়। যদি এখনও অনুবাদ উপলব্ধ না হয়, তাহলে API ইংরেজি ফেরত দেয়।

পড়ার ক্রিয়াকলাপে সমর্থিত: categories, subcategory_info, services, products, inventory ((উপ-পণ্যের নামসমূহ)), sms_projects, এবং sms_countries. ইংরেজির জন্য lang বাদ দিন বা en ব্যবহার করুন।

সেবা/পণ্যের ক্ষেত্রে ক্যাটাগরি এবং সাবক্যাটাগরি ফিল্টার প্যারামিটার সর্বদা ইংরেজি ক্যানোনিকাল নাম ব্যবহার করে, এমনকি যখন lang সেট করা থাকে।

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 দ্বারা উপবিভাগের বিবরণ পান, মূল বিভাগ সহ। 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 অ্যারে, সর্বোচ্চ ১০০)। ঐচ্ছিক 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 শুধুমাত্র পণ্য বা শুধুমাত্র smm সারি ফেরত দেয়। ঐচ্ছিক ক্যাটাগরি এবং সাবক্যাটাগরি প্যারামিটার শুধুমাত্র সেই ক্যাটাগরি বা সাবক্যাটাগরির পরিষেবা ফেরত দেয় (Get Categories API থেকে মান)। ঐচ্ছিক shopId শুধুমাত্র সেই দোকানের পণ্য এবং পরিষেবা ফেরত দেয় (Shops List থেকে shopId ব্যবহার করুন)। ঐচ্ছিক productIds শুধুমাত্র মিলিত সারি ফেরত দেয় (বন্ধুত্বপূর্ণ পরিষেবা নম্বর এবং/অথবা এন্টিটি আইডি; পণ্য বা 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 মোটের সমান হয়।

পণ্যের সারিতে পণ্যের পেজে দেখানো সংখ্যাগুলোও থাকে: 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 = সরবরাহকারী ম্যানুয়ালি পূরণ করে) অন্তর্ভুক্ত থাকে। পণ্য পরিষেবার জন্য, min এবং max পরিষেবা তালিকার প্রাথমিক সাবপ্রোডাক্ট সারির সাথে মেলে; যদি সেই সাবপ্রোডাক্ট আপনার অর্ডার যোগ করতে না পারে, তাহলে প্ল্যাটফর্ম অন্য একটি সাবপ্রোডাক্ট নির্বাচন করতে পারে এবং তার ইউনিট মূল্য চার্জ করতে পারে। subproducts অ্যারে প্রতিটি সক্রিয় ভেরিয়েন্ট প্রদর্শন স্টক সহ তালিকাভুক্ত করে; SMM ইনভেন্টরি প্রতিক্রিয়া subproducts বাদ দেয়।

প্রতিটি subproduct-এর নিজস্ব 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
}

প্রোডাক্ট অর্ডারের জন্য (যেমন অ্যাকাউন্ট), যখন অর্ডার সম্পূর্ণ বা আংশিকভাবে ডেলিভারি করা হয়, তখন প্রতিক্রিয়ায় ডেলিভারি করা অ্যাকাউন্টের ক্রেডেনশিয়াল (প্রতি অ্যাকাউন্টে একটি স্ট্রিং) সহ একটি "accounts" অ্যারে অন্তর্ভুক্ত থাকে। আংশিক ডেলিভারির জন্য, শুধুমাত্র এখন পর্যন্ত ডেলিভারি করা অ্যাকাউন্টগুলি ফেরত দেওয়া হয়।

autoDelivery: সত্য যদি অর্ডার স্বয়ংক্রিয়ভাবে পূর্ণ হয় (যেমন SMM, স্বয়ংক্রিয়/ইনভেন্টরি পণ্য); মিথ্যা যদি সরবরাহকারীকে ম্যানুয়ালি পূর্ণ করতে হয় (কিছু সময় লাগতে পারে)।

উদাহরণ প্রতিক্রিয়া (ডেলিভারি করা অ্যাকাউন্ট সহ প্রোডাক্ট অর্ডার):

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

সম্ভাব্য স্ট্যাটাস:

ফেরত দেওয়া অর্ডার Canceled আর আংশিক ফেরত দেওয়া অর্ডার Partial ফেরত দেয়। কোনো অর্থ ফেরত হলে রেসপন্সে USD-তে ফেরত দেওয়া অঙ্কসহ "refunded"-ও থাকে।

রেসপন্সের উদাহরণ (ফাইল হিসেবে ডেলিভারি হওয়া পণ্যের অর্ডার):

কিছু পণ্য (যেমন session আর্কাইভসহ 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 মানে ত্রুটি।

বাতিল তৈরি করুন

এক বা একাধিক অর্ডার বাতিল করুন (PerfectPanel-সামঞ্জস্যপূর্ণ ব্যাচ ফরম্যাট)। প্রতিটি যোগ্য অর্ডারের টাকা আপনার ব্যালেন্সে ফেরত দেওয়া হবে।

নিচের সবগুলোই সত্য হতে হবে। রিফান্ড প্রক্রিয়া না করেই যোগ্যতা যাচাই করতে allowcancel ব্যবহার করুন।

• প্রাথমিক বাতিল: প্ল্যাটফর্ম ফিচার সক্রিয় (অ্যাডমিন সেটিং)।
• প্রাথমিক বাতিল: productType ম্যানুয়াল, অটো বা ইনভেন্টরি (SMM অটো সার্ভিস সাধারণত productType অটো ব্যবহার করে)।
• প্রাথমিক বাতিল: পেমেন্টের অবস্থা সম্পূর্ণ বা আংশিক।
• প্রাথমিক বাতিল: অর্ডারের অবস্থা পেন্ডিং, প্রক্রিয়াধীন বা ত্রুটিপূর্ণ (প্রোভাইডার ত্রুটিগুলি প্রক্রিয়াধীন হিসেবে দেখায়)।
• প্রাথমিক বাতিল: কোনো external_id নেই (অর্ডারটি এখনও কোনো বাহ্যিক সরবরাহকারী বা প্রদানকারীর কাছে পাঠানো হয়নি)।
• প্রাথমিক বাতিল: পেমেন্ট সম্পন্ন হওয়ার পর অন্তত N মিনিট (auto_order_early_refund_minutes, ডিফল্ট 30)।
• প্রাথমিক বাতিল: গ্রাহক এই অর্ডারে আগে থেকেই প্রাথমিক স্ব-ফেরত ব্যবহার করেননি।
• প্রাথমিক বাতিল: অর্ডার সম্পূর্ণ ডেলিভারি হয়নি (আংশিক ডেলিভারির ক্ষেত্রে অবিতরণকৃত অংশের জন্য আনুপাতিক ফেরত দেওয়া হয়)।
• প্রাথমিক বাতিল: ফেরতযোগ্য পরিমাণ থাকবে (ফেরতযোগ্য পরিমাণ অর্ডার মোটের চেয়ে কম)।
• প্রাথমিক বাতিল: অর্ডারে কোনো সক্রিয় বিরোধ নেই।
• প্রাথমিক বাতিল: অনুরোধকৃত বা সম্পন্ন অবস্থায় কোনো সরবরাহকারী প্রত্যাহার নেই।

আংশিক ডেলিভারির ক্ষেত্রে আনুপাতিক হারে আংশিক ফেরত দেওয়া হয়; ডেলিভারি হওয়া অ্যাকাউন্টগুলো রাখা হয়।

উদাহরণ অনুরোধ:

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"
    }
  }
]

বাতিলের অনুমতি দিন

এক বা একাধিক অর্ডার এখনই বাতিল করা যায় কিনা তা পরীক্ষা করুন (বাতিলের মতো একই যোগ্যতার নিয়ম, কিন্তু কোনো ফেরত প্রক্রিয়া করা হয় না)। ব্যর্থ অনুরোধ এড়াতে বাতিল কল করার আগে ব্যবহার করুন। ব্যাচ অর্ডার আইডি সমর্থন করে (কমা-বিচ্ছিন্ন, সর্বোচ্চ ১০০)।

নিচের সবগুলোই সত্য হতে হবে। রিফান্ড প্রক্রিয়া না করেই যোগ্যতা যাচাই করতে allowcancel ব্যবহার করুন।

• প্রাথমিক বাতিল: প্ল্যাটফর্ম ফিচার সক্রিয় (অ্যাডমিন সেটিং)।
• প্রাথমিক বাতিল: productType ম্যানুয়াল, অটো বা ইনভেন্টরি (SMM অটো সার্ভিস সাধারণত productType অটো ব্যবহার করে)।
• প্রাথমিক বাতিল: পেমেন্টের অবস্থা সম্পূর্ণ বা আংশিক।
• প্রাথমিক বাতিল: অর্ডারের অবস্থা পেন্ডিং, প্রক্রিয়াধীন বা ত্রুটিপূর্ণ (প্রোভাইডার ত্রুটিগুলি প্রক্রিয়াধীন হিসেবে দেখায়)।
• প্রাথমিক বাতিল: কোনো external_id নেই (অর্ডারটি এখনও কোনো বাহ্যিক সরবরাহকারী বা প্রদানকারীর কাছে পাঠানো হয়নি)।
• প্রাথমিক বাতিল: পেমেন্ট সম্পন্ন হওয়ার পর অন্তত N মিনিট (auto_order_early_refund_minutes, ডিফল্ট 30)।
• প্রাথমিক বাতিল: গ্রাহক এই অর্ডারে আগে থেকেই প্রাথমিক স্ব-ফেরত ব্যবহার করেননি।
• প্রাথমিক বাতিল: অর্ডার সম্পূর্ণ ডেলিভারি হয়নি (আংশিক ডেলিভারির ক্ষেত্রে অবিতরণকৃত অংশের জন্য আনুপাতিক ফেরত দেওয়া হয়)।
• প্রাথমিক বাতিল: ফেরতযোগ্য পরিমাণ থাকবে (ফেরতযোগ্য পরিমাণ অর্ডার মোটের চেয়ে কম)।
• প্রাথমিক বাতিল: অর্ডারে কোনো সক্রিয় বিরোধ নেই।
• প্রাথমিক বাতিল: অনুরোধকৃত বা সম্পন্ন অবস্থায় কোনো সরবরাহকারী প্রত্যাহার নেই।

যখন 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 অর্ডারের নিজস্ব অর্ডার ID আছে। এগুলোর সাথে 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"
}

ত্রুটি প্রতিক্রিয়া

আপনার সম্মুখীন হতে পারে এমন সাধারণ ত্রুটি প্রতিক্রিয়া।