发卡 API 对接文档

1. 鉴权与签名

1. 拿到商户 ID 和商户密钥：登录商城 → 个人资料 → 「商户 ID」「商户密钥」。密钥可随时「重置」，重置后旧密钥立即失效。密钥等于你的余额支付密码，别放到前端、别发给别人。
2. 每个请求都带 app_id（商户 ID）和 sign（签名），其余业务参数按接口填。
3. 签名算法（和异次元发卡「货源对接」一致）：去掉 sign → 去掉值为空字符串的参数 → 按参数名 ASCII 升序排序 → 拼成 k1=v1&k2=v2…（值用原文，不做 URL 编码；数组参数写成 sku[颜色]=红 这种形式）→ 末尾追加 &key=商户密钥 → 取 MD5，32 位小写。
4. 余额：下单只能用余额（接口强制 pay_id=1）。余额在 充值中心 用支付宝 / 微信扫码充，最低 ¥10，到账即时。
5. 资金二次验证 / IP 白名单：账号开了「资金操作二次验证」的，必须先在 对接白名单 登记调用服务器的 IP，否则下单接口拒绝（被拒的 IP 会列在那页，复制加入即可）。没开二次验证的可以不登记，但建议登记，密钥泄露也刷不走余额。

// PHP 签名参考实现（和服务端完全一致）
function yy_sign(array $data, string $appKey): string {
    unset($data['sign']);
    ksort($data);
    foreach ($data as $k => $v) { if ($v === '') unset($data[$k]); }
    return md5(urldecode(http_build_query($data) . '&key=' . $appKey));
}

2. 接口一览（基地址 https://kw.yaoyao.chat）

返回格式统一：成功 {"code":200,"msg":"success","data":…}；失败 {"code":0,"msg":"原因"}。下面"参数"不含每个接口都要带的 app_id、sign。

没有主动回调（开通完成不会推送到你的服务器），请用查单接口轮询；需要回调的可以在代搭建（¥500）时一起定制。

3. 商品 code 表（实时）

对接时认 code 不认 ID；code 永久不变。拿货价以 inventory 接口返回的 factory_price 为准，这里是当前值。

4. 推荐的下单流程

1. 启动时调 items 把商品同步到你的系统（存 code、name、price、delivery_way）；每天或每小时同步一次价格。
2. 客户下单前调 inventory（拿库存 + 拿货价）或 valuation（拿总价），自动发货商品 count 为 0 时先别收客户的钱。
3. 调 trade 下单，带唯一 request_no。自动发货商品直接把返回的 secret（一键开通链接）发给客户；客户点开链接按提示粘贴 ChatGPT session，约 2 分钟自己开好。
4. 填信息开通的商品：把订单查询页 https://kw.yaoyao.chat/user/index/query?tradeNo=订单号 发给客户，客户在页面上按提示填开通代码（ChatGPT session / Claude 组织 ID / Grok sso），平均 2 分钟开通好；你用 query（带 tradeNo）轮询，secret 有值即完成。
5. items 只列主商品（Plus 1 个月、Pro 100 美金档位、Claude Pro、Grok Premium、Gemini）；隐藏档位（Plus 3/6/12 个月、Pro 200/500 美金档位、Claude Max、Grok Plus/Super/Ultra）的 code 见第 3 节表，inventory / valuation / trade 照常可用。
6. 超时 / 网络错误：用同一个 request_no 重试 trade，不会重复扣款；仍不确定就按 contact 在商城「订单查询」核对。

5. 错误码与限速

每次调用都会记日志（时间、IP、路径、状态）；异常刷接口、猜密钥会被封 IP。

6. 代码示例

把 你的商户ID、你的商户密钥 换成个人资料页里的值。示例商品 code 用的是 ChatGPT Plus 1 个月（55E12C278B07774A）。

curl（先用 PHP/Python 算 sign）

curl -X POST https://kw.yaoyao.chat/shared/commodity/inventory \
  -A "my-shop/1.0" \
  -d "app_id=你的商户ID" -d "sharedCode=55E12C278B07774A" \
  -d "sign=算好的32位小写md5"

PHP

<?php
$base = 'https://kw.yaoyao.chat';
$appId = '你的商户ID';
$appKey = '你的商户密钥';

function yy_sign(array $data, string $appKey): string {
    unset($data['sign']); ksort($data);
    foreach ($data as $k => $v) { if ($v === '') unset($data[$k]); }
    return md5(urldecode(http_build_query($data) . '&key=' . $appKey));
}
function yy_call(string $path, array $data): array {
    global $base, $appId, $appKey;
    $data['app_id'] = $appId;
    $data['sign'] = yy_sign($data, $appKey);
    $ch = curl_init($base . $path);
    curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_POSTFIELDS => http_build_query($data),
        CURLOPT_RETURNTRANSFER => true, CURLOPT_USERAGENT => 'my-shop/1.0', CURLOPT_TIMEOUT => 30]);
    $r = json_decode((string)curl_exec($ch), true); curl_close($ch);
    return is_array($r) ? $r : ['code' => 0, 'msg' => '网络错误'];
}

// 1 连接测试
print_r(yy_call('/shared/authentication/connect', []));
// 2 库存 + 拿货价
print_r(yy_call('/shared/commodity/inventory', ['sharedCode' => '55E12C278B07774A']));
// 3 下单（余额支付）
$r = yy_call('/shared/commodity/trade', [
    'shared_code' => '55E12C278B07774A', 'num' => 1,
    'contact' => 'customer@example.com', 'request_no' => (string)time() . rand(100, 999),
]);
if (($r['code'] ?? 0) == 200) {
    echo "订单号 {$r['data']['tradeNo']}，卡密：{$r['data']['secret']}\n";
    // 4 查单（填信息开通的商品轮询用）
    print_r(yy_call('/shared/commodity/query', ['tradeNo' => $r['data']['tradeNo']]));
} else {
    echo "失败：{$r['msg']}\n";
}

Python 3

import hashlib, time, random, requests

BASE = 'https://kw.yaoyao.chat'
APP_ID = '你的商户ID'
APP_KEY = '你的商户密钥'

def sign(data: dict) -> str:
    items = sorted((k, str(v)) for k, v in data.items() if k != 'sign' and str(v) != '')
    raw = '&'.join(f'{k}={v}' for k, v in items) + '&key=' + APP_KEY
    return hashlib.md5(raw.encode('utf-8')).hexdigest()

def call(path: str, data: dict | None = None) -> dict:
    data = dict(data or {}, app_id=APP_ID)
    data['sign'] = sign(data)
    r = requests.post(BASE + path, data=data, headers={'User-Agent': 'my-shop/1.0'}, timeout=30)
    return r.json()

print(call('/shared/authentication/connect'))
print(call('/shared/commodity/inventory', {'sharedCode': '55E12C278B07774A'}))
r = call('/shared/commodity/trade', {'shared_code': '55E12C278B07774A', 'num': 1,
        'contact': 'customer@example.com', 'request_no': f'{int(time.time())}{random.randint(100, 999)}'})
print(r)
if r.get('code') == 200:
    print(call('/shared/commodity/query', {'tradeNo': r['data']['tradeNo']}))

签名提示：Python 示例把所有值当字符串拼接，和 PHP 的 http_build_query + urldecode 结果一致；如果你要传数组参数（sku），按 sku[键]=值 的形式拼进去再排序。

7. 用异次元发卡（ACG-FAKA）的站长：一键对接

1. 你的站后台 → 「店铺对接」/「货源对接」→ 添加：类型选异次元，域名 https://kw.yaoyao.chat，商户 ID、密钥填你在本站个人资料页的值。
2. 点「连接」通过后，在「商品」里从货源拉取商品，设置你的加价（零售价）即可上架；下单自动走本站 trade，卡密自动回传给你的客户。
3. 填信息开通的商品：你的客户在你站下单后，把本站订单查询页链接发给客户填开通代码（见第 4 节）。

需要帮忙？

不会接、没有技术：付 ¥500（支付宝）瑶瑶代搭建——帮你把 API 接到你的系统，或直接给你开一个白标分站（你的域名、共享库存、零售价你定）。详情见 代理合作说明，扫码加瑶瑶企业微信备注「API」。

本站由瑶瑶运营，是独立的 AI 会员代充服务，不是 OpenAI、Anthropic、Google、xAI 官方，也没有获得它们的授权。