开发者 API 文档

$client->call('/shared/authentication/connect', array (
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "shopName": "Token Store",
        "balance": "500.00",
        "currency": "CNY"
    }
}

$client->call('/shared/commodity/items', array (
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": [
        {
            "name": "AI 订阅",
            "children": [
                {
                    "id": 4,
                    "code": "TS-P4",
                    "name": "示例 AI 订阅商品",
                    "description": "请核对商品及账号要求",
                    "price": "151.80",
                    "user_price": "151.80",
                    "stock": "10",
                    "delivery_way": 0,
                    "draft_status": 0,
                    "draft_premium": "0.00",
                    "contact_type": 2,
                    "password_status": 0,
                    "minimum": 1,
                    "maximum": 1000,
                    "config": {},
                    "widget": [],
                    "currency": "CNY"
                }
            ]
        }
    ]
}

$client->call('/shared/commodity/item', array (
  'code' => 'TS-P4',
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "id": 4,
        "code": "TS-P4",
        "name": "示例 AI 订阅商品",
        "description": "请核对商品及账号要求",
        "price": "151.80",
        "user_price": "151.80",
        "stock": "10",
        "delivery_way": 0,
        "draft_status": 0,
        "draft_premium": "0.00",
        "contact_type": 2,
        "password_status": 0,
        "minimum": 1,
        "maximum": 1000,
        "config": {},
        "widget": [],
        "currency": "CNY"
    }
}

$client->call('/shared/commodity/stock', array (
  'code' => 'TS-P4',
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "stock": "10"
    }
}

$client->call('/shared/commodity/inventoryState', array (
  'shared_code' => 'TS-P4',
  'num' => '1',
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "available": true,
        "num": 1
    }
}

$client->call('/shared/commodity/inventory', array (
  'sharedCode' => 'TS-P4',
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "count": 10,
        "delivery_way": 0,
        "draft_status": 0,
        "price": "151.80",
        "user_price": "151.80",
        "factory_price": "151.80",
        "config": "{}",
        "config_format": "json",
        "is_category": false
    }
}

$client->call('/shared/commodity/valuation', array (
  'code' => 'TS-P4',
  'num' => '1',
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "price": "151.80",
        "currency": "CNY",
        "price_scope": "total"
    }
}

$client->call('/shared/commodity/trade', array (
  'shared_code' => 'TS-P4',
  'num' => '1',
  'request_no' => 'YOUR_ORDER_20261021_0001',
  'contact' => 'customer@example.com',
  'max_amount' => '151.80',
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "tradeNo": "20261021000000EXAMPLE",
        "request_no": "YOUR_ORDER_20261021_0001",
        "amount": "151.80",
        "order_amount": "151.80",
        "status": 1,
        "state": "delivered",
        "settlement": "charged",
        "refunded": false,
        "secret": "YOUR_DELIVERED_CARD",
        "balance": "348.20",
        "cards": {
            "available": true
        }
    }
}

$client->call('/shared/commodity/query', array (
  'request_no' => 'YOUR_ORDER_20261021_0001',
));

{
    "code": 200,
    "error": "",
    "msg": "success",
    "data": {
        "tradeNo": "20261021000000EXAMPLE",
        "request_no": "YOUR_ORDER_20261021_0001",
        "amount": "151.80",
        "order_amount": "151.80",
        "status": 1,
        "state": "delivered",
        "settlement": "charged",
        "refunded": false,
        "secret": "YOUR_DELIVERED_CARD",
        "balance": "348.20",
        "cards": {
            "available": true
        }
    }
}

app_id=YOUR_APP_ID
sign_type=HMAC-SHA256
timestamp=YOUR_UNIX_TIMESTAMP
nonce=YOUR_FRESH_RANDOM_NONCE
shared_code=TS-P4
num=1
request_no=YOUR_ORDER_20261021_0001
max_amount=200.00
contact=customer@example.com
sign=YOUR_CALCULATED_SIGNATURE

{
  "code": 200,
  "error": "",
  "msg": "success",
  "data": {
    "tradeNo": "20261021000000EXAMPLE",
    "request_no": "YOUR_ORDER_20261021_0001",
    "amount": "151.80",
    "order_amount": "151.80",
    "status": 1,
    "state": "delivered",
    "settlement": "charged",
    "refunded": false,
    "secret": "YOUR_DELIVERED_CARD",
    "balance": "348.20",
    "cards": {"available": true}
  }
}

$client->call('/api/check', array (
  'cdkey' => 'YOUR_DELIVERED_CARD',
));

{
    "success": true,
    "code": "activation.ready",
    "msg": "可提交兑换",
    "data": {
        "app": "gpt",
        "gift_name": "示例订阅",
        "service_product": "EXAMPLE_PRODUCT",
        "use_status": 0,
        "status_code": "activation.ready",
        "status_hint": "请核对目标账号",
        "in_cooldown": false,
        "cooldown_remaining": 0
    }
}

$client->call('/api/service_status', array (
  'cdkey' => 'YOUR_DELIVERED_CARD',
));

{
    "success": true,
    "data": {
        "level": "normal"
    }
}

$client->call('/api/activate', array (
  'cdkey' => 'YOUR_DELIVERED_CARD',
  'confirm' => '1',
  'session_info' => '{"YOUR_SESSION_FIELD":"YOUR_SESSION_VALUE"}',
));

{
    "success": true,
    "code": "activation.processing",
    "msg": "正在处理，请查询原卡密",
    "data": {
        "status_code": "activation.processing"
    }
}

$client->call('/api/claude_refresh', array (
  'cdkey' => 'YOUR_DELIVERED_CARD',
  'session_info' => 'sk-ant-sid-YOUR_ORIGINAL_SESSION_KEY',
));

{
    "success": true,
    "msg": "刷新请求已处理",
    "data": {
        "retry_after": 60
    }
}

$client->call('/api/refresh-subscription', array (
  'cdkey' => 'YOUR_DELIVERED_CARD',
  'session_info' => '{"YOUR_SESSION_FIELD":"YOUR_SESSION_VALUE"}',
));

{
    "success": true,
    "msg": "查询完成",
    "data": {
        "verify_result": [
            true,
            [
                "示例套餐",
                "EXAMPLE_EXPIRY",
                "EXAMPLE_ACCOUNT"
            ]
        ],
        "retry_after": 60
    }
}

require 'MerchantClient.php';
$client = new TokenStoreMerchantClient(
    'https://YOUR_STORE_DOMAIN',
    getenv('STORE_APP_ID'),
    getenv('STORE_APP_KEY')
);
$items = $client->call('/shared/commodity/items');
$quote = $client->call('/shared/commodity/valuation', [
    'code' => 'TS-P4', 'num' => '1'
]);
// Save your business order and fixed request_no BEFORE requesting purchase.
$result = $client->call('/shared/commodity/trade', [
    'shared_code' => 'TS-P4', 'num' => '1',
    'request_no' => 'YOUR_ORDER_20261021_0001',
    'max_amount' => '200.00', 'contact' => 'customer@example.com'
]);
// Timeout / unknown: query using the SAME business request number.
$status = $client->call('/shared/commodity/query', [
    'request_no' => 'YOUR_ORDER_20261021_0001'
]);
// After presenting account risks and receiving the buyer's confirmation:
$check = $client->call('/api/check', ['cdkey' => 'YOUR_DELIVERED_CARD']);
// Session object must be encoded as a string for the form protocol.
$activation = $client->call('/api/activate', [
    'cdkey' => 'YOUR_DELIVERED_CARD', 'confirm' => '1',
    'session_info' => json_encode($targetSession, JSON_UNESCAPED_UNICODE)
]);