概述

嗨付卡台 GPT协议充值系统提供完整的 RESTful API，支持第三方系统对接。通过 API 您可以：

• 自动发起 ChatGPT Plus / Pro 5x / Pro 20x 充值任务
• 实时监控任务执行进度和日志
• 管理嗨付Pay虚拟卡（查询、开卡、充值、提现）
• 查询系统队列状态，实现智能调度

Base URL：

https://sdk.hifupay.com

支持的套餐和地区：

支持的地区代码：

认证方式

API 采用 密钥认证（永久有效），分两步获取：

第一步：获取嗨付Pay API Key（sk_ 密钥）

1. 注册并登录嗨付Pay平台：www.haifupay.top（推荐）或 www.hifupay.com
2. 进入后台 → 找到「API 接入」或「开发者」页面
3. 复制您的 API Key（格式如：sk_748cb58d99ea...）

第二步：登录本系统获取 API 密钥（cdk_ 密钥）

方式一（网页）：在本站首页用 sk_ 密钥登录，登录成功后点击「🔑 密钥」查看

方式二（API）：调用 POST /api/hfp/login 接口，传入 sk_ 密钥，返回的 apiKey 字段即为系统密钥

第三步：调用 API

所有 API 请求在 Header 中携带 cdk_ 密钥，支持以下三种方式（任选其一）：

// 方式一：X-Api-Key（推荐）
{ "X-Api-Key": "cdk_您的系统密钥", "Content-Type": "application/json" }

// 方式二：Authorization Bearer
{ "Authorization": "Bearer cdk_您的系统密钥", "Content-Type": "application/json" }

// 方式三：X-Session-Token（兼容旧版）
{ "X-Session-Token": "cdk_您的系统密钥", "Content-Type": "application/json" }

错误处理

所有 API 请求失败时返回统一的错误格式：

{
  "error": "错误描述信息（中文）"
}

HTTP 状态码说明：

登录获取密钥

请求参数 (Body JSON)

成功响应

{
  "success": true,
  "balance": {
    "walletBalance": 208.45,
    "cardBalance": 101.77,
    "totalBalance": 310.22,
    "currency": "USD"
  },
  "sessionToken": "cdk_88cd28ac8be54712...",
  "apiKey": "cdk_88cd28ac8be54712..."
}

失败响应

{
  "success": false,
  "error": "API 密钥无效或已过期"
}

代码示例

// Node.js 示例
const resp = await fetch('https://sdk.hifupay.com/api/hfp/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'sk_your_api_key_here',
    platform: 'hifupay'
  })
});
const data = await resp.json();
const apiKey = data.apiKey; // 永久有效的 API 密钥，保存后用于所有接口调用

创建充值任务

请求头

请求参数 (Body JSON)

成功响应

{
  "taskId": "TMSR07F4I"
}

失败响应

// 参数错误
{ "error": "请输入 Session Token" }

// 卡片错误
{ "error": "嗨付Pay卡片错误: 获取卡片信息超时" }

// 频率限制
{ "error": "请求过于频繁，请稍后再试" }

代码示例

// 使用 hfpCardId 方式
const resp = await fetch('https://sdk.hifupay.com/api/start', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': '您的API密钥'
  },
  body: JSON.stringify({
    token: 'ChatGPT的Session Token内容',
    plan: 'plus',
    region: 'PH',
    hfpCardId: 'card_123456'
  })
});
const { taskId } = await resp.json();
console.log('任务已创建:', taskId);

查询任务状态

路径参数

成功响应

{
  "taskId": "TMSR07F4I",
  "status": "completed",
  "paymentConfirmed": true,
  "autoCancelDone": true,
  "logs": [
    {"ts": "12:14:08", "text": "🚀 任务开始执行...", "level": "info"},
    {"ts": "12:14:09", "text": "GPT 账号: user@email.com", "level": "info"},
    {"ts": "12:14:53", "text": "✅ 协议充值全流程完成！", "level": "success"}
  ],
  "error": null,
  "account": "user@email.com"
}

status 字段说明：

支付与退订状态字段：

常见错误信息

获取任务日志

成功响应

{
  "logs": [
    {"ts": "12:14:08", "text": "🚀 任务开始执行...", "level": "info"},
    {"ts": "12:14:09", "text": "[1/9] 创建订单...", "level": "info"},
    ...
  ]
}

停止任务

成功响应

{ "ok": true }

失败响应

// 任务不存在
{ "error": "Task not found" }

// 非本人任务
{ "error": "无权操作此任务" }

任务列表

成功响应

[
  {
    "taskId": "TMSR07F4I",
    "status": "completed",
    "logCount": 45,
    "error": null,
    "account": "user@email.com",
    "plan": "pro_x20",
    "region": "PH",
    "paymentConfirmed": true,
    "autoCancelDone": true,
    "createdAt": "2026-08-13T04:14:33.039Z"
  },
  ...
]

队列状态

成功响应

{
  "running": 1,
  "max": 3,
  "queued": 2
}

查询余额

成功响应

{
  "success": true,
  "balance": {
    "walletBalance": 208.45,
    "cardBalance": 101.77,
    "totalBalance": 310.22,
    "currency": "USD"
  }
}

失败响应

{
  "success": false,
  "error": "嗨付API连接超时，请稍后重试"
}

卡片列表

成功响应

{
  "success": true,
  "cards": [
    {
      "id": 69,
      "cardNo": "5259620149346308",
      "lastFour": "6308",
      "binCode": "525962",
      "cvv": "586",
      "expiryDate": "12/28",
      "status": "active",
      "balance": 83.52,
      "currency": "USD",
      "createdAt": "2026-08-13 12:46:42",
      "note": ""
    },
    ...
  ]
}

卡片详情（敏感信息）

请求参数

成功响应

{
  "success": true,
  "data": {
    "id": 69,
    "cardNo": "5259620149346308",
    "fullCardNo": "5259620149346308",
    "expiryDate": "12/28",
    "cvv": "586"
  }
}

卡产品列表（BIN）

成功响应

{
  "success": true,
  "products": [
    { "id": 1, "bin": "525962", "name": "Visa 525962", "currency": "USD" },
    { "id": 2, "bin": "493724", "name": "Visa 493724", "currency": "USD" }
  ]
}

开卡

请求参数

成功响应

{
  "success": true,
  "data": {
    "cards": ["card_new1", "card_new2"],
    "message": "开卡成功"
  }
}

失败响应

{
  "success": false,
  "error": "余额不足，无法开卡"
}

卡片充值

请求参数

成功响应

{
  "success": true,
  "data": { "message": "充值成功" }
}

卡片提现

请求参数

成功响应

{
  "success": true,
  "data": { "message": "提现成功" }
}

SSE 实时日志流

连接参数

事件格式

data: {"ts":"12:14:08","text":"🚀 任务开始执行...","level":"info"}

data: {"ts":"12:14:09","text":"[1/9] 创建订单...","level":"info"}

data: {"ts":"12:14:53","text":"✅ 协议充值全流程完成！","level":"success"}

代码示例

// 浏览器端
const apiKey = '您的API密钥';
const evtSource = new EventSource(
  `https://sdk.hifupay.com/api/stream/${taskId}?s=${encodeURIComponent(apiKey)}`
);
evtSource.onmessage = (event) => {
  const log = JSON.parse(event.data);
  console.log(`[${log.ts}] [${log.level}] ${log.text}`);
};
evtSource.onerror = () => {
  evtSource.close();
  console.log('连接已关闭');
};

// Node.js 端（使用 eventsource 包）
const EventSource = require('eventsource');
const es = new EventSource(
  `https://sdk.hifupay.com/api/stream/${taskId}?s=${encodeURIComponent(apiKey)}`
);
es.onmessage = (event) => {
  const log = JSON.parse(event.data);
  if (log.level === 'success' && log.text.includes('全流程完成')) {
    console.log('充值成功！');
    es.close();
  }
};

完整接入示例

以下是一个完整的对接流程示例（Node.js）：

const fetch = require('node-fetch');

const BASE = 'https://sdk.hifupay.com';
const API_KEY = 'sk_your_api_key';
const PLATFORM = 'hifupay';

async function main() {
  // 1. 登录
  const loginResp = await fetch(`${BASE}/api/hfp/login`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ apiKey: API_KEY, platform: PLATFORM })
  });
  const loginData = await loginResp.json();
  if (!loginData.success) throw new Error(`登录失败: ${loginData.error}`);
  const token = loginData.apiKey; // 永久有效的 API 密钥
  const headers = { 'Content-Type': 'application/json', 'X-Api-Key': token };

  console.log('余额:', loginData.balance);

  // 2. 获取卡片列表
  const cardsResp = await fetch(`${BASE}/api/hfp/cards`, { method: 'POST', headers });
  const cardsData = await cardsResp.json();
  if (!cardsData.success || !cardsData.cards.length) throw new Error('无可用卡片');
  const cardId = cardsData.cards[0].id;
  console.log('使用卡片:', cardId);

  // 3. 查询队列（可选）
  const qResp = await fetch(`${BASE}/api/queue-status`, { headers: { 'User-Agent': 'MyApp/1.0' } });
  const queue = await qResp.json();
  console.log(`队列: 运行${queue.running}/${queue.max}, 等待${queue.queued}`);

  // 4. 创建充值任务
  const startResp = await fetch(`${BASE}/api/start`, {
    method: 'POST', headers,
    body: JSON.stringify({
      token: 'ChatGPT用户的Session Token',
      plan: 'plus',
      region: 'PH',
      hfpCardId: cardId
    })
  });
  const startData = await startResp.json();
  if (startData.error) throw new Error(`创建任务失败: ${startData.error}`);
  const taskId = startData.taskId;
  console.log('任务已创建:', taskId);

  // 5. 轮询任务状态
  while (true) {
    await new Promise(r => setTimeout(r, 5000));
    const statusResp = await fetch(`${BASE}/api/status/${taskId}`, { headers });
    const status = await statusResp.json();

    if (status.status === 'completed') {
      console.log('✅ 充值成功！账号:', status.account);
      break;
    }
    if (status.status === 'failed') {
      console.log('❌ 充值失败:', status.error);
      break;
    }
    console.log('⏳ 执行中... 日志数:', status.logs.length);
  }
}

main().catch(console.error);