API 문서

API 키를 얻으려면 로그인하세요

내 API 키

로드 중...

테스트 API

작업을 선택하고, 매개변수를 입력한 후 요청을 보내세요. 로그인하면 API 키가 자동으로 로드됩니다.

API 키

언어(선택 사항)

액션

명령 요청

작업 또는 매개변수를 변경하면 자동으로 업데이트됩니다.

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

API 엔드포인트

https://hstockplus.net/api/v2

모든 API 요청은 이 엔드포인트로 HTTP POST를 통해 전송되어야 합니다.

중요 — 제품 이미지 URL (imageUrl)

Media CDN이 활성화되면 서비스 목록, 제품 목록 및 하위 카테고리 정보 응답의 imageUrl 필드가 CDN 도메인(https://cdn.hstockplus.org/...)을 사용합니다. 앱에서 이러한 절대 URL을 직접 사용하세요 — hstockplus.com 또는 hstockplus.net으로 대체하지 마십시오.

https://cdn.hstockplus.org/uploads/products/gmail.webp

선택적 언어(lang)

선택 사항. 대상 언어 코드입니다. 아래 나열된 지원 코드 중 하나를 사용하세요. 설정되어 있고 en이 아닌 경우, 번역 가능한 필드가 해당 언어로 반환됩니다. 아직 번역이 제공되지 않은 경우 API는 영어를 반환합니다.

지원되는 언어 코드

en(기본값 — lang을 생략하거나 en을 사용하세요)zhdejapt-BRurbn-BD

lang 매개변수에 대해 이 정확한 값을 사용하세요. 별칭: jp는 ja로 허용됩니다.

읽기 작업에서 지원됨: 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"

카테고리 가져오기

모든 카테고리와 각 카테고리의 하위 카테고리를 가져옵니다. 이 값을 사용하여 서비스 목록을 카테고리 또는 하위 카테고리별로 필터링하세요.

매개변수	설명	필수
key	내 API 키	예
action	categories	예
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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를 사용하세요.

매개변수	설명	필수
key	내 API 키	예
action	subcategory_info	예
subcategoryId	Products List의 하위 카테고리 ID	예
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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

상점 목록

기본 정보, 상품 수, 리뷰 평점과 함께 활성 상점을 나열합니다. 상점 이름은 개인정보 보호를 위해 마스킹 처리됩니다.

매개변수	설명	필수
key	내 API 키	예
action	shops	예
page	Page number (default 1).	No
limit	Items per page (default 20).	No

예시 요청:

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로 표시됩니다.

매개변수	설명	필수
key	내 API 키	예
action	coupons	예
shop	이 상점의 쿠폰만 표시합니다(action=shops의 shopId).	No

예시 요청:

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
}

필드	의미
type / value	percentage: value는 할인율(%)입니다. fixed: value는 주문에서 차감되는 USD 금액입니다. quantityTiers가 있으면 value는 가장 낮은 구간의 값입니다.
appliesTo	shop: 이 상점의 모든 상품. services: services에 나열된 서비스 번호의 상품만. 상점 쿠폰은 성장(SMM) 서비스에는 적용되지 않습니다.
minPurchase	할인 전 주문 합계가 최소 이 USD 금액 이상이어야 합니다.
minQuantity	주문 수량은 이 값 이상이어야 합니다.
quantityTiers	수량이 많을수록 할인율이 커지며, 주문 수량이 도달한 가장 높은 구간이 적용됩니다.
maxDiscount	쿠폰이 주문 한 건에서 차감하는 최대 USD 금액입니다(상한이 있을 때만 해당).
maxUsesPerUser	계정 하나가 코드를 사용할 수 있는 횟수입니다(제한이 있을 때만 해당).
remainingUses	모든 구매자를 합산한 남은 사용 횟수입니다.
expiresAt	이 시각이 지나면 코드를 사용할 수 없습니다(만료되지 않으면 생략).
private	코드가 내 계정 전용으로 발급된 경우 true입니다.

쿠폰은 리셀러 할인을 적용하고 남은 금액에서 차감됩니다. 쿠폰에 해당 조건이 없으면 선택 필드는 생략됩니다.

제품 목록

마켓플레이스 상품만 나열합니다(SMM 서비스 제외). 서비스 목록의 상품 행과 동일한 필드로, id(상품 엔터티 ID), service(친숙한 서비스 번호), description 및 imageUrl을 포함합니다. 선택적 productIds는 해당 상품만 반환합니다(목록의 친숙한 서비스 번호 및/또는 상품 엔터티 ID, 쉼표로 구분하거나 JSON 배열, 최대 100개). 선택적 sort=sold는 유료 주문 단위 기준 내림차순으로 결과를 정렬합니다(베스트셀러 우선).

매개변수	설명	필수
key	내 API 키	예
action	products	예
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 카테고리의 상품만 반환합니다.	No
subcategory	하위 카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 하위 카테고리의 상품만 반환합니다.	No
shopId	상점 ID로 필터링합니다(상점 목록에서 확인). 해당 상점의 상품만 반환합니다.	No
productIds	Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100).	No
isRecommended	선택 사항. true로 설정하면 isRecommended === true인 제품만 반환합니다.	No
sort	선택 사항. sold = 유료 주문 단위 기준 내림차순 정렬(베스트셀러 우선). 생략 시 기본 캐시 순서를 유지합니다.	No
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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

제품 ID별 필터:

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"

서비스 목록

모든 사용 가능한 서비스를 선택적 페이지네이션과 함께 조회합니다. 각 행에는 id(엔티티 ID), service(친숙한 서비스 번호), stock, entityType(smm 또는 product)이 포함됩니다. 선택적 entityType은 product 행 또는 smm 행만 반환합니다. 선택적 category 및 subcategory 파라미터는 해당 카테고리 또는 하위 카테고리의 서비스만 반환합니다(값은 Get Categories API에서 가져옴). 선택적 shopId는 해당 상점의 제품 및 서비스만 반환합니다(Shops List의 shopId 사용). 선택적 productIds는 일치하는 행만 반환합니다(친숙한 서비스 번호 및/또는 엔티티 ID; product 또는 smm 행과 일치). action=products를 사용하여 제품만 필터링합니다.

매개변수	설명	필수
key	내 API 키	예
action	services	예
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 카테고리의 서비스만 반환합니다.	No
subcategory	하위 카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 하위 카테고리의 서비스만 반환합니다.	No
shopId	상점 ID로 필터링합니다(상점 목록에서 확인). 해당 상점의 상품과 SMM 서비스만 반환합니다.	No
entityType	선택적 필터: product 또는 smm. 마켓플레이스 제품만 또는 SMM 서비스만 반환합니다.	No
productIds	선택 사항인 ID 목록(서비스 번호 및/또는 엔터티 ID). 쉼표로 구분하거나 JSON 배열 또는 반복 필드로 전달합니다. 일치하는 상품 또는 SMM 행을 반환합니다. 상품만 조회하려면 action=products를 사용하세요.	No
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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(엔티티 ID), service(주문용 친숙한 서비스 번호), stock, entityType(smm 또는 product) 및 autoDelivery가 포함됩니다. Product 행에는 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가 들어 있습니다.

매개변수	설명	필수
key	내 API 키	예
action	inventory	예
service	서비스 ID(서비스 목록에서 확인)	예
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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 인벤토리 응답에는 하위 상품이 포함되지 않습니다.

각 하위 상품에는 고유한 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.

매개변수	설명	필수
key	내 API 키	예
action	add	예
service	서비스 ID	예
link	Link: SMM 주문(예: 팔로워, 좋아요, 댓글)에는 필수이며 콘텐츠의 URL 또는 링크입니다(예: Instagram 게시물 URL). 상품 주문(예: 계정)에는 선택이며 수령 이메일 또는 참조 정보입니다. 비워 두면 시스템이 계정 이메일을 사용합니다.	No
quantity	주문 수량	예
subproductId	상품 전용: 기본 옵션 대신 특정 옵션(Select Option 변형)을 선택합니다. 이 서비스에 대해 action=inventory가 반환한 subproductId 값을 사용하세요. 선택 사항이며 성장/SMM 서비스에는 사용되지 않습니다.	No
coupon	쿠폰 코드(action=coupons 또는 상점 페이지에서 확인). 선택 사항입니다. 리셀러 할인에 추가로 적용되며 웹사이트 결제와 같은 조건을 따릅니다. 코드를 사용할 수 없으면 주문이 생성되지 않고 오류에 이유가 표시됩니다.	No

예시 요청:

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.

주문 상태

주문 상태를 확인합니다.

매개변수	설명
key	내 API 키
action	status
order	주문 ID

예시 요청:

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: 주문이 자동으로 처리되는 경우 true(예: SMM, 자동/재고 제품); 공급업체가 수동으로 처리해야 하는 경우 false(시간이 걸릴 수 있음).

응답 예시 (계정이 배송된 제품 주문):

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

가능한 상태:

PendingIn progressCompletedPartialCanceled

환불된 주문은 Canceled로, 부분 환불된 주문은 Partial로 반환됩니다. 환불된 금액이 있으면 응답에 환불 금액(USD)이 담긴 "refunded"도 함께 포함됩니다.

응답 예시(파일로 전달된 상품 주문):

일부 상품(예: 세션 아카이브가 포함된 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이 반환됩니다.

매개변수	설명
key	내 API 키
action	order_file
order	주문 ID
file	action=status의 "files" 배열에 있는 파일 ID

예시 요청:

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은 manual, auto 또는 inventory입니다 (SMM 자동 서비스는 일반적으로 productType auto를 사용합니다).
조기 취소: 결제 상태가 완료 또는 부분 완료임.
조기 취소: 주문 상태가 대기 중, 처리 중 또는 오류임 (공급자 오류는 진행 중으로 표시됨).
조기 취소: external_id 없음 (주문이 외부 공급업체나 제공업체로 아직 전송되지 않음).
조기 취소: 결제 완료 후 최소 N분 경과 (auto_order_early_refund_minutes, 기본값 30).
조기 취소: 고객이 이 주문에 대해 이미 조기 자체 환불을 사용하지 않음.
조기 취소: 주문이 완전히 전달되지 않음 (부분 전달 시 미전달 부분에 대해 비례 환불 제공).
조기 취소: 환불 가능 금액이 남아 있음 (refundedAmount가 주문 총액보다 적음).
조기 취소: 주문에 활성 분쟁 없음.
조기 취소: 요청 또는 완료 상태의 공급자 출금 없음.

부분 전달 시 비례 부분 환불 제공; 전달된 계정은 유지됨.

매개변수	설명
key	내 API 키
action	cancel
orders	주문 ID (쉼표로 구분, 최대 100개 ID)

예시 요청:

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

취소 허용

하나 이상의 주문을 지금 취소할 수 있는지 확인합니다 (취소와 동일한 자격 규칙 적용, 환불은 처리되지 않음). 취소를 호출하기 전에 사용하여 실패한 요청을 방지하세요. 여러 주문 ID를 지원합니다 (쉼표로 구분, 최대 100개).

다음 모든 조건이 충족되어야 합니다. 환불 처리 없이 자격 확인을 위해 allowcancel을 사용하세요.

조기 취소: 플랫폼 기능 활성화 (관리자 설정).
조기 취소: productType은 manual, auto 또는 inventory입니다 (SMM 자동 서비스는 일반적으로 productType auto를 사용합니다).
조기 취소: 결제 상태가 완료 또는 부분 완료임.
조기 취소: 주문 상태가 대기 중, 처리 중 또는 오류임 (공급자 오류는 진행 중으로 표시됨).
조기 취소: external_id 없음 (주문이 외부 공급업체나 제공업체로 아직 전송되지 않음).
조기 취소: 결제 완료 후 최소 N분 경과 (auto_order_early_refund_minutes, 기본값 30).
조기 취소: 고객이 이 주문에 대해 이미 조기 자체 환불을 사용하지 않음.
조기 취소: 주문이 완전히 전달되지 않음 (부분 전달 시 미전달 부분에 대해 비례 환불 제공).
조기 취소: 환불 가능 금액이 남아 있음 (refundedAmount가 주문 총액보다 적음).
조기 취소: 주문에 활성 분쟁 없음.
조기 취소: 요청 또는 완료 상태의 공급자 출금 없음.

allowcancel이 1일 때, 응답에 refundAmount 포함 (취소 시 환불될 금액).

매개변수	설명
key	내 API 키
action	allowcancel
orders	주문 ID (쉼표로 구분, 최대 100개 ID)

예시 요청:

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

잔액

현재 잔액을 확인하세요.

매개변수	설명
key	내 API 키
action	balance

예시 요청:

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

예시 응답:

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

SMS 인증 API

SMS 인증 서비스를 위한 전용 엔드포인트.

SMS 주문에는 별도의 주문 ID가 있습니다. 이 ID에는 sms_code, sms_status, sms_cancel을 사용하세요. status, cancel, allowcancel은 상품 및 SMM 주문 전용입니다.

1. SMS 프로젝트 받기

Action: sms_projects

매개변수	설명
key	내 API 키
action	sms_projects
country	선택 사항. 국가 ID로 필터링(예: 'us', 'gb')
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.

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

2. SMS 국가 가져오기

Action: sms_countries

매개변수	설명
key	내 API 키
action	sms_countries
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.

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

3. SMS 주문 생성

Action: add_sms

매개변수	설명	필수
key	내 API 키
action	add_sms
project_id	sms_projects에서 받은 프로젝트 ID	예
quantity	Number of numbers (1-10)	No (Default 1)
country	Country: ISO code (e.g. 'us') or dial code from sms_countries (e.g. '+1')	No
phone	재사용할 전화번호	No

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

4. SMS 코드 받기

Action: sms_code

매개변수	설명
key	내 API 키
action	sms_code
order	주문 ID

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

5. SMS 주문 상태 확인

Action: sms_status

매개변수	설명
key	내 API 키
action	sms_status
order	주문 ID

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

6. SMS 주문 취소

Action: sms_cancel

번호를 해제합니다. 코드를 받지 못했다면 번호가 만료된 후에도 전액이 잔액으로 환불됩니다. 이미 코드를 받은 주문은 취소할 수 없습니다.

매개변수	설명
key	내 API 키
action	sms_cancel
order	add_sms에서 받은 주문 ID

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

오류 응답

자주 접할 수 있는 일반적인 오류 응답입니다.

{"error": "Invalid API key"}

{"error": "Invalid action"}

{"error": "Service ID is required"}

{"error": "Insufficient balance"}

{"error": "Order not found"}

{"error": "Service not found"}

도움이 필요하신가요? 저희에게 연락해 주세요. support@hstockplus.com

시작하기

HstockPlus/

API 문서

API 키를 얻으려면 로그인하세요

내 API 키

로드 중...

테스트 API

작업을 선택하고, 매개변수를 입력한 후 요청을 보내세요. 로그인하면 API 키가 자동으로 로드됩니다.

API 키

언어(선택 사항)

액션

명령 요청

작업 또는 매개변수를 변경하면 자동으로 업데이트됩니다.

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

API 엔드포인트

https://hstockplus.net/api/v2

모든 API 요청은 이 엔드포인트로 HTTP POST를 통해 전송되어야 합니다.

중요 — 제품 이미지 URL (imageUrl)

https://cdn.hstockplus.org/uploads/products/gmail.webp

선택적 언어(lang)

지원되는 언어 코드

en(기본값 — lang을 생략하거나 en을 사용하세요)zhdejapt-BRurbn-BD

lang 매개변수에 대해 이 정확한 값을 사용하세요. 별칭: jp는 ja로 허용됩니다.

서비스/제품의 category 및 subcategory 필터 매개변수는 lang이 설정된 경우에도 항상 표준 영어 이름을 사용합니다.

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

카테고리 가져오기

모든 카테고리와 각 카테고리의 하위 카테고리를 가져옵니다. 이 값을 사용하여 서비스 목록을 카테고리 또는 하위 카테고리별로 필터링하세요.

매개변수	설명	필수
key	내 API 키	예
action	categories	예
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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를 사용하세요.

매개변수	설명	필수
key	내 API 키	예
action	subcategory_info	예
subcategoryId	Products List의 하위 카테고리 ID	예
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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

상점 목록

기본 정보, 상품 수, 리뷰 평점과 함께 활성 상점을 나열합니다. 상점 이름은 개인정보 보호를 위해 마스킹 처리됩니다.

매개변수	설명	필수
key	내 API 키	예
action	shops	예
page	Page number (default 1).	No
limit	Items per page (default 20).	No

예시 요청:

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"

쿠폰 목록

매개변수	설명	필수
key	내 API 키	예
action	coupons	예
shop	이 상점의 쿠폰만 표시합니다(action=shops의 shopId).	No

예시 요청:

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
}

필드	의미
type / value	percentage: value는 할인율(%)입니다. fixed: value는 주문에서 차감되는 USD 금액입니다. quantityTiers가 있으면 value는 가장 낮은 구간의 값입니다.
appliesTo	shop: 이 상점의 모든 상품. services: services에 나열된 서비스 번호의 상품만. 상점 쿠폰은 성장(SMM) 서비스에는 적용되지 않습니다.
minPurchase	할인 전 주문 합계가 최소 이 USD 금액 이상이어야 합니다.
minQuantity	주문 수량은 이 값 이상이어야 합니다.
quantityTiers	수량이 많을수록 할인율이 커지며, 주문 수량이 도달한 가장 높은 구간이 적용됩니다.
maxDiscount	쿠폰이 주문 한 건에서 차감하는 최대 USD 금액입니다(상한이 있을 때만 해당).
maxUsesPerUser	계정 하나가 코드를 사용할 수 있는 횟수입니다(제한이 있을 때만 해당).
remainingUses	모든 구매자를 합산한 남은 사용 횟수입니다.
expiresAt	이 시각이 지나면 코드를 사용할 수 없습니다(만료되지 않으면 생략).
private	코드가 내 계정 전용으로 발급된 경우 true입니다.

쿠폰은 리셀러 할인을 적용하고 남은 금액에서 차감됩니다. 쿠폰에 해당 조건이 없으면 선택 필드는 생략됩니다.

제품 목록

매개변수	설명	필수
key	내 API 키	예
action	products	예
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 카테고리의 상품만 반환합니다.	No
subcategory	하위 카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 하위 카테고리의 상품만 반환합니다.	No
shopId	상점 ID로 필터링합니다(상점 목록에서 확인). 해당 상점의 상품만 반환합니다.	No
productIds	Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100).	No
isRecommended	선택 사항. true로 설정하면 isRecommended === true인 제품만 반환합니다.	No
sort	선택 사항. sold = 유료 주문 단위 기준 내림차순 정렬(베스트셀러 우선). 생략 시 기본 캐시 순서를 유지합니다.	No
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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

제품 ID별 필터:

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"

서비스 목록

매개변수	설명	필수
key	내 API 키	예
action	services	예
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 카테고리의 서비스만 반환합니다.	No
subcategory	하위 카테고리 이름으로 필터링합니다(카테고리 조회에서 확인). 해당 하위 카테고리의 서비스만 반환합니다.	No
shopId	상점 ID로 필터링합니다(상점 목록에서 확인). 해당 상점의 상품과 SMM 서비스만 반환합니다.	No
entityType	선택적 필터: product 또는 smm. 마켓플레이스 제품만 또는 SMM 서비스만 반환합니다.	No
productIds	선택 사항인 ID 목록(서비스 번호 및/또는 엔터티 ID). 쉼표로 구분하거나 JSON 배열 또는 반복 필드로 전달합니다. 일치하는 상품 또는 SMM 행을 반환합니다. 상품만 조회하려면 action=products를 사용하세요.	No
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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
}

재고 확인

매개변수	설명	필수
key	내 API 키	예
action	inventory	예
service	서비스 ID(서비스 목록에서 확인)	예
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.	No

예시 요청:

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
}

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.

주문 추가

매개변수	설명	필수
key	내 API 키	예
action	add	예
service	서비스 ID	예
link	Link: SMM 주문(예: 팔로워, 좋아요, 댓글)에는 필수이며 콘텐츠의 URL 또는 링크입니다(예: Instagram 게시물 URL). 상품 주문(예: 계정)에는 선택이며 수령 이메일 또는 참조 정보입니다. 비워 두면 시스템이 계정 이메일을 사용합니다.	No
quantity	주문 수량	예
subproductId	상품 전용: 기본 옵션 대신 특정 옵션(Select Option 변형)을 선택합니다. 이 서비스에 대해 action=inventory가 반환한 subproductId 값을 사용하세요. 선택 사항이며 성장/SMM 서비스에는 사용되지 않습니다.	No
coupon	쿠폰 코드(action=coupons 또는 상점 페이지에서 확인). 선택 사항입니다. 리셀러 할인에 추가로 적용되며 웹사이트 결제와 같은 조건을 따릅니다. 코드를 사용할 수 없으면 주문이 생성되지 않고 오류에 이유가 표시됩니다.	No

예시 요청:

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
}

주문 상태

주문 상태를 확인합니다.

매개변수	설명
key	내 API 키
action	status
order	주문 ID

예시 요청:

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

가능한 상태:

PendingIn progressCompletedPartialCanceled

환불된 주문은 Canceled로, 부분 환불된 주문은 Partial로 반환됩니다. 환불된 금액이 있으면 응답에 환불 금액(USD)이 담긴 "refunded"도 함께 포함됩니다.

응답 예시(파일로 전달된 상품 주문):

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

주문 파일 다운로드

매개변수	설명
key	내 API 키
action	order_file
order	주문 ID
file	action=status의 "files" 배열에 있는 파일 ID

예시 요청:

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은 manual, auto 또는 inventory입니다 (SMM 자동 서비스는 일반적으로 productType auto를 사용합니다).
조기 취소: 결제 상태가 완료 또는 부분 완료임.
조기 취소: 주문 상태가 대기 중, 처리 중 또는 오류임 (공급자 오류는 진행 중으로 표시됨).
조기 취소: external_id 없음 (주문이 외부 공급업체나 제공업체로 아직 전송되지 않음).
조기 취소: 결제 완료 후 최소 N분 경과 (auto_order_early_refund_minutes, 기본값 30).
조기 취소: 고객이 이 주문에 대해 이미 조기 자체 환불을 사용하지 않음.
조기 취소: 주문이 완전히 전달되지 않음 (부분 전달 시 미전달 부분에 대해 비례 환불 제공).
조기 취소: 환불 가능 금액이 남아 있음 (refundedAmount가 주문 총액보다 적음).
조기 취소: 주문에 활성 분쟁 없음.
조기 취소: 요청 또는 완료 상태의 공급자 출금 없음.

부분 전달 시 비례 부분 환불 제공; 전달된 계정은 유지됨.

매개변수	설명
key	내 API 키
action	cancel
orders	주문 ID (쉼표로 구분, 최대 100개 ID)

예시 요청:

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은 manual, auto 또는 inventory입니다 (SMM 자동 서비스는 일반적으로 productType auto를 사용합니다).
조기 취소: 결제 상태가 완료 또는 부분 완료임.
조기 취소: 주문 상태가 대기 중, 처리 중 또는 오류임 (공급자 오류는 진행 중으로 표시됨).
조기 취소: external_id 없음 (주문이 외부 공급업체나 제공업체로 아직 전송되지 않음).
조기 취소: 결제 완료 후 최소 N분 경과 (auto_order_early_refund_minutes, 기본값 30).
조기 취소: 고객이 이 주문에 대해 이미 조기 자체 환불을 사용하지 않음.
조기 취소: 주문이 완전히 전달되지 않음 (부분 전달 시 미전달 부분에 대해 비례 환불 제공).
조기 취소: 환불 가능 금액이 남아 있음 (refundedAmount가 주문 총액보다 적음).
조기 취소: 주문에 활성 분쟁 없음.
조기 취소: 요청 또는 완료 상태의 공급자 출금 없음.

allowcancel이 1일 때, 응답에 refundAmount 포함 (취소 시 환불될 금액).

매개변수	설명
key	내 API 키
action	allowcancel
orders	주문 ID (쉼표로 구분, 최대 100개 ID)

예시 요청:

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

잔액

현재 잔액을 확인하세요.

매개변수	설명
key	내 API 키
action	balance

예시 요청:

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

예시 응답:

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

SMS 인증 API

SMS 인증 서비스를 위한 전용 엔드포인트.

SMS 주문에는 별도의 주문 ID가 있습니다. 이 ID에는 sms_code, sms_status, sms_cancel을 사용하세요. status, cancel, allowcancel은 상품 및 SMM 주문 전용입니다.

1. SMS 프로젝트 받기

Action: sms_projects

매개변수	설명
key	내 API 키
action	sms_projects
country	선택 사항. 국가 ID로 필터링(예: 'us', 'gb')
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.

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

2. SMS 국가 가져오기

Action: sms_countries

매개변수	설명
key	내 API 키
action	sms_countries
lang	선택적 언어 코드. 위의 선택적 언어(lang)에서 지원 코드를 참조하세요.

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

3. SMS 주문 생성

Action: add_sms

매개변수	설명	필수
key	내 API 키
action	add_sms
project_id	sms_projects에서 받은 프로젝트 ID	예
quantity	Number of numbers (1-10)	No (Default 1)
country	Country: ISO code (e.g. 'us') or dial code from sms_countries (e.g. '+1')	No
phone	재사용할 전화번호	No

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

4. SMS 코드 받기

Action: sms_code

매개변수	설명
key	내 API 키
action	sms_code
order	주문 ID

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

5. SMS 주문 상태 확인

Action: sms_status

매개변수	설명
key	내 API 키
action	sms_status
order	주문 ID

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

6. SMS 주문 취소

Action: sms_cancel

번호를 해제합니다. 코드를 받지 못했다면 번호가 만료된 후에도 전액이 잔액으로 환불됩니다. 이미 코드를 받은 주문은 취소할 수 없습니다.

매개변수	설명
key	내 API 키
action	sms_cancel
order	add_sms에서 받은 주문 ID

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

오류 응답

자주 접할 수 있는 일반적인 오류 응답입니다.

{"error": "Invalid API key"}

{"error": "Invalid action"}

{"error": "Service ID is required"}

{"error": "Insufficient balance"}

{"error": "Order not found"}

{"error": "Service not found"}

도움이 필요하신가요? 저희에게 연락해 주세요. support@hstockplus.com