📚 API Documentation

v3.1 Pro
← Back to Checker

🔐 Authentication

Tất cả endpoints (trừ refresh token) yêu cầu header:

Authorization: Bearer <API_KEY>
X-Session-Token: <SESSION_TOKEN>

🚀 Core Endpoints

POST /api/start_session

Bắt đầu phiên check card mới.

{ "payload": "base64({ cards, settings })" }

settings.gate: stripe | stripeauthv4 | shopify

POST /api/check_next

Lấy card tiếp theo để check. Mỗi worker gọi liên tục.

{ "session_id": "sess_abc123" }

Response bao gồm: result, stats, logs, thread_index, proxy, gate

POST /api/end_session

Dừng phiên check đang chạy.

{ "session_id": "sess_abc123" }
GET /api/check_status

Kiểm tra trạng thái phiên hiện tại.

POST /api/stop_check

Dừng check (legacy alias của end_session).

🛠 Utility Endpoints

GET /api/bin_lookup?bin=462845

Tra cứu thông tin BIN.

POST /api/analyze_proxies

Phân tích và phân loại proxy list.

{ "proxies": ["http://user:pass@ip:port"] }
POST /api/export

Export kết quả. Filter: all | live | ccn | die

{ "filter": "live" }
GET /api/stats

Thống kê tổng quan.

📊 Status Reference

StatusÝ nghĩa
liveCard approved (live)
ccnOTP/3DS required
dieDeclined hoặc error

💻 Python Example

import base64, json, requests

API_KEY = "your_api_key"
BASE_URL = "https://your-domain.com"

# 1. Start session
payload = base64.b64encode(json.dumps({
  "cards": "462845...|06|2027|833",
  "settings": {"gate": "stripeauthv4", "thread_count": 3}
}).encode()).decode()

res = requests.post(
  f"{BASE_URL}/api/start_session",
  json={"payload": payload},
  headers={"Authorization": f"Bearer {API_KEY}"}
)
session_id = res.json()["session_id"]
Underground Card Checker v3.1 Pro — API Documentation