乐享充 · 开放平台对接文档

第三方系统 / 九一卡券（阿奇索）可凭本文档将本平台货源接入您的系统实现自动下单（串货）。您的专属凭证（用户ID app_key、密钥 secret、接口地址）请登录代理后台 →「资料信息 / API配置」查看，本页不提供密钥。

接入流程

一、接口地址

二、鉴权方式

方式一（推荐）：通过 HTTP Header 传递鉴权信息：

方式二（兼容）：不方便设置 Header 时，可将鉴权参数放入请求 Body / Query：

三、签名规则（HMAC-SHA256 / MD5 二选一）

方式A：HMAC-SHA256（推荐，通用第三方平台）

1. 取请求 Body 全部业务参数，加上 app_key 和 timestamp
2. 按参数名 ASCII 升序排序（ksort）
3. 拼接为 key1=value1&key2=value2&...，数组值用 JSON 编码
4. 末尾追加 &secret=您的密钥
5. 对结果做 HMAC-SHA256（密钥为您的 secret），得到的值即 X-Sign

方式B：MD5（九一卡券/阿奇索模式）

1. 参数按 key ASCII 升序排序（ksort）
2. 拼接为 key1value1key2value2...（无 = 和 & 分隔符）
3. 前后各加您的密钥：md5(密钥 + 拼接串 + 密钥)，结果转大写
4. 平台自动识别两种签名，任选其一即可

PHP 完整示例（下单）

<?php
// ============ 乐享充开放平台 下单示例（PHP）============
// 1. 业务参数
$params = [
    'product_id'   => '1',            // 产品ID（产品信息列表中的数字ID）
    'account'      => '13800138000',  // 充值账号
    'out_trade_no' => 'YOUR_ORDER_123', // 外部订单号（选填，用于幂等）
    // 电费订单额外传：'area' => '广东',
];
$appKey    = '{your_app_key}';      // 您的用户ID（agk_开头）
$appSecret = '{your_secret_key}';   // 您的密钥
$timestamp = (string)time();

// 2. 加入公共参数后按 ASCII 升序排序
$params['app_key']   = $appKey;
$params['timestamp'] = $timestamp;
ksort($params);

// 3. 拼接 key=value（数组值用 JSON 编码），末尾加 &secret=密钥
$parts = [];
foreach ($params as $k => $v) {
    if (is_array($v)) $v = json_encode($v, JSON_UNESCAPED_UNICODE);
    $parts[] = $k . '=' . $v;
}
$raw  = implode('&', $parts) . '&secret=' . $appSecret;

// 4. HMAC-SHA256 签名
$sign = hash_hmac('sha256', $raw, $appSecret);

// 5. 发起请求
$ch = curl_init('https://api.lxchong.com/api/open/order/create');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($params),
    CURLOPT_HTTPHEADER => [
        'X-App-Key: ' . $appKey,
        'X-Timestamp: ' . $timestamp,
        'X-Sign: ' . $sign,
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$resp = curl_exec($ch);
echo $resp;

Python 完整示例（下单）

# ============ 乐享充开放平台 下单示例（Python）============
import time, hmac, hashlib, requests

app_key    = "{your_app_key}"
app_secret = "{your_secret_key}"
timestamp  = str(int(time.time()))

params = {
    "product_id": "1",
    "account": "13800138000",
    "out_trade_no": "YOUR_ORDER_123",
    "app_key": app_key,
    "timestamp": timestamp,
}
# 按 key 升序拼接 k=v&k=v，末尾加 &secret=密钥
raw = "&".join(f"{k}={params[k]}" for k in sorted(params)) + "&secret=" + app_secret
sign = hmac.new(app_secret.encode(), raw.encode(), hashlib.sha256).hexdigest()

resp = requests.post("https://api.lxchong.com/api/open/order/create", data=params, headers={
    "X-App-Key": app_key,
    "X-Timestamp": timestamp,
    "X-Sign": sign,
})
print(resp.json())

四、接口详情

1. 创建订单（下单）

POST https://api.lxchong.com/api/open/order/create

请求参数：

返回示例：

{
  "code": 0,
  "message": "ok",
  "data": {
    "order_no": "20260703xxxxxx",
    "out_trade_no": "YOUR_ORDER_123",
    "product_id": "1",
    "account": "13800138000",
    "face_value": 100.00,
    "amount": 95.00,
    "status": 1,
    "status_text": "pending",
    "created_at": "2026-07-03 12:00:00",
    "complete_at": null
  }
}

返回字段说明：

2. 查询订单

GET / POST https://api.lxchong.com/api/open/order/query

请求参数（order_no 与 out_trade_no 二选一）：

返回结构与下单一致（含 status / status_text / amount 等），订单不存在返回 code:40400。

3. 查询余额

GET https://api.lxchong.com/api/open/balance

{ "code": 0, "message": "ok", "data": { "balance": 100.00, "balance_fen": 10000 } }

balance 单位元，balance_fen 单位分。用代理 app_key（agk_ 前缀）对接时查的是代理账户余额（同系统串货场景），非租户余额。

4. 产品同步

GET https://api.lxchong.com/api/open/products

拉取上游平台全部上架产品，供同步/一键导入到自己产品库。无业务参数（仍需签名头）。

{
  "code": 0, "message": "ok",
  "data": [
    { "product_id": "own1_c11_304", "name": "移动 联通 电信50元充值",
      "type": 1, "type_text": "话费快充", "carrier": "CM,CU,CT",
      "face_value": 50.00, "sell_price": 46.75 }
  ]
}

拿到 product_id 后即可用于下单接口的 product_id 参数。carrier 为该商品支持的运营商（多网逗号分隔）：CM=移动、CU=联通、CT=电信、GD=广电；话费下单时手机号运营商必须在此范围内。

五、异步回调通知

订单到达终态（成功/失败/退款）时，平台会向您配置的 notify_url 推送通知（POST JSON）。验签方式与请求签名相同。

// 平台 → 您的 notify_url（POST，Content-Type: application/json）
{
  "app_key": "{your_app_key}",
  "order_no": "20260703xxxxxx",
  "out_trade_no": "YOUR_ORDER_123",
  "product_id": "1",
  "account": "13800138000",
  "face_value": 100.00,
  "amount": 95.00,
  "status": 3,
  "status_text": "success",
  "complete_at": "2026-07-03 12:00:00",
  "timestamp": "1782xxxxxx",
  "sign": "..."   // 验签方式同请求签名
}
// 收到后请返回包含 success 的文本，否则平台按 30s/120s/300s 递增重试（默认最多3次）

回调验签示例（PHP）

<?php
// ============ 回调验签示例（PHP）============
$body = json_decode(file_get_contents('php://input'), true);
$sign = $body['sign'] ?? '';
unset($body['sign']);
ksort($body);
$parts = [];
foreach ($body as $k => $v) {
    if (is_array($v)) $v = json_encode($v, JSON_UNESCAPED_UNICODE);
    $parts[] = $k . '=' . $v;
}
$raw = implode('&', $parts) . '&secret=' . '{your_secret_key}';
$expect = hash_hmac('sha256', $raw, '{your_secret_key}');

if (hash_equals($expect, $sign)) {
    // 验签通过：按 status 更新您的订单
    echo 'success';   // 必须返回含 success 的文本
} else {
    echo 'sign error';
}

六、订单状态码

七、错误码