🌿 OTP Shop Reseller API

API สำหรับตัวแทนจำหน่าย — ซื้อเบอร์ OTP, ตรวจสอบ SMS, จัดการออเดอร์ ทั้งหมดผ่าน REST API

Base URL: https://tangshop.site/cc/api/reseller/
รองรับทั้ง JSON body และ query parameters / ทุก response เป็น JSON
📄 ไฟล์สำหรับส่งต่อ: README.md (คู่มือเชื่อมระบบ) และ openapi.json (OpenAPI 3.0)

🔑 การยืนยันตัวตน (Authentication)

ทุก request ต้องส่ง API Key — แนะนำให้ส่งผ่าน Header:

วิธีตัวอย่าง
Header (แนะนำ)Authorization: Bearer YOUR_API_KEY
HeaderX-API-Key: YOUR_API_KEY
Query Param (ระบบเดิม)?api_key=YOUR_API_KEY
JSON Body (ระบบเดิม){ "api_key": "YOUR_API_KEY" }
ตัวอย่าง curlcurl -H "Authorization: Bearer YOUR_API_KEY" https://tangshop.site/cc/api/reseller/get_balance.php
วิธีสร้าง API Key: เข้าเมนู "API" ในเว็บร้านค้า แล้วตั้ง PIN + กดปุ่ม "สร้าง API Key"
ความปลอดภัย: ห้ามฝัง API Key ใน JavaScript ฝั่ง browser หรือเปิดเผยให้ผู้อื่น

⚠️ Error Codes

ทุก response จะมีรูปแบบเดียวกัน:

{
  "success": true | false,
  "message": "ข้อความ",
  "data": { ... } | null
}
HTTP Codeความหมาย
200สำเร็จ
400ข้อมูลไม่ครบ / ไม่ถูกต้อง
401API Key ไม่ถูกต้อง
402ยอดเงินไม่เพียงพอ
404ไม่พบข้อมูล
500ระบบขัดข้อง
503บริการไม่พร้อมชั่วคราว (เบอร์หมด)

🌐 SMSBower-Compatible API

Endpoint นี้รับ request ในรูปแบบเดียวกับ https://smsbower.page/stubs/handler_api.php ทุกประการ — เปลี่ยน base URL อย่างเดียว client library ของ SMSBower เดิมก็ใช้ได้ทันที

Base URL: https://tangshop.site/cc/api/reseller/handler_api.php
Method: GET หรือ POST
Server: ใช้ได้กับ server1 เท่านั้น (country = 52 = Thailand)
Activation ID: ใช้ order_id ของระบบเรา (ที่ผูกกับบัญชีคุณ) — ปลอดภัยกว่าและตรวจสอบสิทธิ์ได้

getBalance — ดูยอดเงิน

GET/api/reseller/handler_api.php?action=getBalance
ตัวอย่างhttps://tangshop.site/cc/api/reseller/handler_api.php?api_key=YOUR_API_KEY&action=getBalance

Response (text/plain)

ACCESS_BALANCE:1500.00

Errors

Responseความหมาย
BAD_KEYAPI key ไม่ถูกต้อง

getNumber / getNumberV2 — ขอเบอร์

GET/api/reseller/handler_api.php?action=getNumber

Query Parameters

พารามิเตอร์ประเภทคำอธิบาย
servicestringrequired รหัสบริการ เช่น go, wa, tg
countrystringoptional default 52 (ไทย) — ระบบรองรับเฉพาะ 52
maxPrice / providerIds / etc.—ignored ระบบเรามี logic เลือก provider/maxPrice เอง (กันขาดทุน)
ตัวอย่างhttps://tangshop.site/cc/api/reseller/handler_api.php?api_key=YOUR_API_KEY&action=getNumber&service=go&country=52

Response (text/plain) สำเร็จ

ACCESS_NUMBER:123456:66812345678
    │       │
    │       └── เบอร์โทร
    └────────── activationId (ใช้เก็บไว้สำหรับ getStatus / setStatus)

Response (JSON) สำหรับ getNumberV2

{
  "activationId": "123456",
  "phoneNumber": "66812345678",
  "activationCost": 9.00,
  "countryCode": "52",
  "canGetAnotherSms": true,
  "activationTime": "2026-05-04 12:00:00",
  "activationOperator": "auto"
}

Errors

Responseความหมาย
BAD_KEYAPI key ไม่ถูกต้อง
BAD_SERVICEรหัสบริการไม่ถูกต้องหรือถูกปิด
BAD_COUNTRYระบุ country ที่ไม่ใช่ 52
NO_NUMBERSไม่มีเบอร์ว่าง / ต้นทุนสูงกว่าราคาขาย
NO_BALANCEยอดเงินไม่พอ

getStatus — เช็ค SMS

GET/api/reseller/handler_api.php?action=getStatus

Query Parameters

พารามิเตอร์ประเภทคำอธิบาย
idintegerrequired activationId ที่ได้จาก getNumber
ตัวอย่างhttps://tangshop.site/cc/api/reseller/handler_api.php?api_key=YOUR_API_KEY&action=getStatus&id=123456

Possible Responses

Responseความหมาย
STATUS_WAIT_CODEกำลังรอ SMS
STATUS_OK:codeได้รับรหัสแล้ว เช่น STATUS_OK:123456
STATUS_WAIT_RETRY:lastCodeรอ SMS รอบถัดไป (มีรหัสเก่าให้ดู)
STATUS_CANCELออเดอร์ถูกยกเลิก
NO_ACTIVATIONไม่พบรายการ

setStatus — เปลี่ยนสถานะ

GET/api/reseller/handler_api.php?action=setStatus

Query Parameters

พารามิเตอร์ประเภทคำอธิบาย
idintegerrequired activationId
statusintegerrequired 1=ready, 3=resend, 6=complete, 8=cancel
ตัวอย่าง: ยกเลิกhttps://tangshop.site/cc/api/reseller/handler_api.php?api_key=YOUR_API_KEY&action=setStatus&id=123456&status=8

Possible Responses

Responseความหมาย
ACCESS_READYstatus=1: แจ้งพร้อมแล้ว
ACCESS_RETRY_GETstatus=3: รอ SMS ใหม่ (มีค่าใช้จ่ายตาม setting)
ACCESS_ACTIVATIONstatus=6: ยืนยันใช้งานสำเร็จ
ACCESS_CANCELstatus=8: ยกเลิกและคืนเงินแล้ว
EARLY_CANCEL_DENIEDยกเลิกเร็วเกินไป (ต้องรอ ≥2 นาที)
BAD_STATUSstatus ไม่ถูกต้อง / ออเดอร์ได้ rหัสแล้ว
NO_ACTIVATIONไม่พบรายการ

getPrices / getPricesV2 / getPricesV3 — ดูราคา

GET/api/reseller/handler_api.php?action=getPrices

Query Parameters

พารามิเตอร์ประเภทคำอธิบาย
servicestringoptional รหัสบริการ — ไม่ระบุ = ทุกบริการ
countrystringoptional default 52

Response (getPrices) — JSON

{
  "52": {
    "go": { "cost": 9.00, "count": 999 },
    "wa": { "cost": 12.00, "count": 999 }
  }
}

Response (getPricesV3) — JSON

{
  "52": {
    "go": {
      "auto": {
        "count": 999,
        "price": 9.00,
        "provider_id": "auto"
      }
    }
  }
}
หมายเหตุ: ราคาที่แสดงเป็น ราคาหลังหักส่วนลดของ user แล้ว — ใช้คำนวณยอดได้ตรงเลย

getServicesList — รายการบริการ

GET/api/reseller/handler_api.php?action=getServicesList

Response — JSON

{
  "status": "success",
  "services": [
    { "code": "go", "name": "Google" },
    { "code": "wa", "name": "WhatsApp" }
  ]
}

getCountries — รายการประเทศ

GET/api/reseller/handler_api.php?action=getCountries

Response — JSON

{
  "52": {
    "id": 52,
    "rus": "Таиланд",
    "eng": "Thailand",
    "chn": "泰国"
  }
}
หมายเหตุ: ระบบนี้รองรับเฉพาะประเทศไทย (server1)

💰 ดูยอดเงินคงเหลือ

GET/api/reseller/get_balance.php

ลองเลย

เปิดผ่าน Browserhttps://tangshop.site/cc/api/reseller/get_balance.php?api_key=YOUR_API_KEY

Response

{
  "success": true,
  "message": "ดึงยอดเงินสำเร็จ",
  "data": {
    "user_id": 42,
    "balance": 1500.00,
    "currency": "THB"
  }
}

🌍 ดูรหัสประเทศ

GET/api/reseller/get_countries.php

ใช้รหัส id ที่ได้จาก endpoint นี้ไปส่งเป็น country ใน get_services.php และ buy_otp.php

Query Parameters

พารามิเตอร์ประเภทคำอธิบาย
serverstringoptional server1 (default) หรือ server2
ตัวอย่างhttps://tangshop.site/cc/api/reseller/get_countries.php?server=server1&api_key=YOUR_API_KEY

Response

{
  "success": true,
  "data": {
    "server": "server1",
    "source": "provider",
    "count": 2,
    "countries": [
      { "id": "52", "name": "Thailand", "name_th": "ไทย" },
      { "id": "4", "name": "Philippines", "name_th": "ฟิลิปปินส์" }
    ]
  }
}
Fallback: ถ้าผู้ให้บริการล่ม ระบบจะส่งประเทศยอดนิยมพร้อม source: "fallback" และ warning

📦 ดูรายการบริการ

GET/api/reseller/get_services.php

Query Parameters

พารามิเตอร์ประเภทคำอธิบาย
serverstringoptional server1 (default) หรือ server2
countrystringoptional รหัสประเทศจาก get_countries.php เช่น 52 — ถ้าส่ง จะกรองเฉพาะแอพที่รองรับประเทศนั้น
in_stockstringoptional 1 = เฉพาะบริการที่มีสต็อกมากกว่า 0

ลองเลย

บริการทั้งหมดที่เปิดขายhttps://tangshop.site/cc/api/reseller/get_services.php?api_key=YOUR_API_KEY&server=server1
ประเทศไทย + เฉพาะที่มีของhttps://tangshop.site/cc/api/reseller/get_services.php?api_key=YOUR_API_KEY&server=server1&country=52&in_stock=1

Response

{
  "success": true,
  "data": {
    "server": "server1",
    "country": "52",
    "in_stock": true,
    "count": 1,
    "services": [
      {
        "id": 1,
        "code": "tg",
        "name": "Telegram",
        "original_price": 10.00,
        "price": 9.00,
        "discount": 1.00,
        "image_url": "https://...",
        "category": null,
        "server": "server1",
        "stock_count": 24,
        "available": true
      }
    ]
  }
}
เปิดขายเท่านั้น: ระบบกรอง is_active = 1 ให้อัตโนมัติ และ price คือราคาหลังหักส่วนลดรายบุคคลแล้ว

🛒 สั่งซื้อเบอร์ OTP

POST/api/reseller/buy_otp.php

Request Body (JSON)

พารามิเตอร์ประเภทคำอธิบาย
service_idintegerrequired ID บริการจาก get_services
serverstringoptional server1 (default) หรือ server2
quantityintegeroptional จำนวนเบอร์ 1-15 (default: 1)
countrystringoptional รหัสประเทศจาก get_countries.php เช่น 52 — แนะนำให้ส่งทุกครั้ง

Request ตัวอย่าง

{
  "service_id": 1,
  "server": "server1",
  "quantity": 2,
  "country": "52"
}
ส่ง API Key ผ่าน header Authorization: Bearer YOUR_API_KEY (แนะนำ) หรือ X-API-Key

Response (สำเร็จ)

{
  "success": true,
  "message": "สั่งซื้อสำเร็จ 2 เบอร์",
  "data": {
    "quantity": 2,
    "unit_price": 9.00,
    "total_price": 18.00,
    "original_unit_price": 10.00,
    "discount_per_unit": 1.00,
    "remaining_balance": 1482.00,
    "server": "server1",
    "country": "52",
    "order_ids": [501, 502],
    "orders": [
      {
        "order_id": 501,
        "activation_id": "123456789",
        "phone_number": "+66812345678",
        "price": 9.00
      }
    ]
  }
}
สำคัญ: ถ้าซื้อหลายเบอร์แต่ของผู้ให้บริการมีไม่ครบ quantity จะเป็นจำนวนที่สำเร็จจริง และคิดเงินตามจำนวนนั้น — ควรใช้ order_ids จาก response

📩 ตรวจสอบ SMS / OTP Code

POST/api/reseller/check_sms.php

Request Body (JSON)

พารามิเตอร์ประเภทคำอธิบาย
order_idintegerrequired ID ออเดอร์ที่ได้จาก buy_otp

Request ตัวอย่าง

{
  "api_key": "YOUR_API_KEY",
  "order_id": 501
}

Response

{
  "success": true,
  "data": {
    "order_id": 501,
    "phone_number": "+66812345678",
    "sms_code": "123456",      // null = ยังไม่ได้รับ
    "status": "COMPLETED",
    "service_name": "Telegram"
  }
}
สำคัญ: หาก sms_code เป็น null ยังไม่ได้รับ SMS — ให้ poll ซ้ำทุก 5 วินาที (ไม่เกิน 2 นาที)

⚡ ดำเนินการเบอร์ (ยกเลิก / อื่น ๆ)

POST/api/reseller/activation_action.php

Request Body (JSON)

พารามิเตอร์ประเภทคำอธิบาย
order_idintegerrequired ID ออเดอร์
actionintegerrequired รหัสการดำเนินการ

Action Codes

Codeความหมายคำอธิบาย
1Readyแจ้งว่าพร้อมรับ SMS
3Resendขอส่ง SMS ซ้ำ
6Completeเสร็จสิ้นการใช้งานเบอร์
8Cancelยกเลิกเบอร์ (คืนเงิน)

Request ตัวอย่าง

{
  "api_key": "YOUR_API_KEY",
  "order_id": 501,
  "action": 8         // ยกเลิก
}

📋 ดูประวัติสั่งซื้อ

GET/api/reseller/get_orders.php

Query Parameters

พารามิเตอร์ประเภทคำอธิบาย
pageintegeroptional หน้าที่ (default: 1)
limitintegeroptional จำนวนต่อหน้า 1-100 (default: 20)
statusstringoptional กรองสถานะ: WAITING, COMPLETED, CANCELLED

ลองเลย

ดูทั้งหมดhttps://tangshop.site/cc/api/reseller/get_orders.php?api_key=YOUR_API_KEY
เฉพาะรอ SMShttps://tangshop.site/cc/api/reseller/get_orders.php?api_key=YOUR_API_KEY&status=WAITING

Response

{
  "success": true,
  "data": {
    "page": 1,
    "limit": 20,
    "total": 156,
    "total_pages": 8,
    "orders": [
      {
        "id": 501,
        "phone_number": "+66812345678",
        "sms_code": "123456",
        "price": 9.00,
        "status": "COMPLETED",
        "server": "server1",
        "service_name": "Telegram",
        "created_at": "2026-04-06 12:30:00"
      }
    ]
  }
}

🏷️ ส่วนลดรายบุคคล

ระบบรองรับส่วนลดรายบุคคลที่แอดมินตั้งค่าให้:

ประเภทคำอธิบายตัวอย่าง
เปอร์เซ็นต์ (%)ลดราคาเป็น % จากราคาเต็มส่วนลด 10% → ราคา 10฿ เหลือ 9฿
จำนวนเงิน (฿)ลดราคาเป็นจำนวนเงินคงที่ส่วนลด 2฿ → ราคา 10฿ เหลือ 8฿

ส่วนลดเฉพาะบริการจะมีลำดับสำคัญกว่าส่วนลดทุกบริการ

ราคาหลังส่วนลดแสดงอัตโนมัติใน get_services และถูกใช้จริงใน buy_otp

🚀 ตัวอย่าง Flow การใช้งาน

ทุก request ส่ง API Key ผ่าน header Authorization: Bearer YOUR_KEY
1

ตรวจสอบยอดเงิน

GET https://tangshop.site/cc/api/reseller/get_balance.php
2

เลือกประเทศ แล้วดึงเฉพาะแอพที่เปิดขาย

GET https://tangshop.site/cc/api/reseller/get_countries.php?server=server1
GET https://tangshop.site/cc/api/reseller/get_services.php?server=server1&country=52&in_stock=1
3

สั่งซื้อเบอร์

ส่ง POST พร้อม JSON body:

{
  "service_id": 1,
  "server": "server1",
  "quantity": 1,
  "country": "52"
}

จดจำ order_id จาก response ไว้ใช้ขั้นตอนถัดไป

4

รอรับ SMS (poll ทุก 5 วินาที)

ส่ง POST ซ้ำจนกว่า sms_code จะมีค่า:

{
  "order_id": 501
}
5

เสร็จสิ้น หรือ ยกเลิก

{
  "order_id": 501,
  "action": 6    // 6=เสร็จ, 8=ยกเลิก
}

💻 ตัวอย่างโค้ด

Python

import requests, time

API_KEY = "YOUR_API_KEY"
BASE = "https://tangshop.site/cc/api/reseller"

# 1. ดูยอดเงิน
r = requests.get(f"{BASE}/get_balance.php?api_key={API_KEY}")
print(r.json())

# 2. ดูบริการ
r = requests.get(f"{BASE}/get_services.php?api_key={API_KEY}")
services = r.json()["data"]["services"]

# 3. สั่งซื้อ
r = requests.post(f"{BASE}/buy_otp.php", json={
    "api_key": API_KEY, "service_id": 1, "quantity": 1, "country": "52"
})
order_id = r.json()["data"]["orders"][0]["order_id"]

# 4. รอ SMS
for _ in range(24):
    r = requests.post(f"{BASE}/check_sms.php", json={
        "api_key": API_KEY, "order_id": order_id
    })
    code = r.json()["data"].get("sms_code")
    if code:
        print(f"OTP: {code}")
        break
    time.sleep(5)

JavaScript

const API_KEY = "YOUR_API_KEY";
const BASE = "https://tangshop.site/cc/api/reseller";

// ดูยอดเงิน
const res = await fetch(`${BASE}/get_balance.php?api_key=${API_KEY}`);
console.log(await res.json());

// สั่งซื้อ
const buy = await fetch(`${BASE}/buy_otp.php`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    api_key: API_KEY, service_id: 1, quantity: 1, country: "52"
  })
});
console.log(await buy.json());

PHP

$apiKey = "YOUR_API_KEY";
$base = "https://tangshop.site/cc/api/reseller";

// ดูยอดเงิน
$res = file_get_contents("{$base}/get_balance.php?api_key={$apiKey}");
$data = json_decode($res, true);

// สั่งซื้อ
$ch = curl_init("{$base}/buy_otp.php");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
    CURLOPT_POSTFIELDS => json_encode([
        "api_key" => $apiKey,
        "service_id" => 1,
        "quantity" => 1,
        "country" => "52"
    ])
]);
$result = json_decode(curl_exec($ch), true);
ต้องการความช่วยเหลือ? ติดต่อแอดมินเพื่อขอ API Key และข้อมูลเพิ่มเติม