开放平台 API

兼容行业标杆协议，首期开放手机话费充值

公共签名

请求携带 app_key、timestamp 和 sign。参数名升序拼接参数名与参数值，排除 sign 与 datas，末尾追加 AppSecret 后计算小写 MD5。时间戳允许误差30秒。

如运营后台配置了 IP 白名单，所有接口请求必须从白名单中的公网 IP 发起。AppSecret 只在开户或重置当次显示；重置后旧密钥立即失效。

采购商接口

POST /api/merchant/upload_order

提交话费充值订单。相同采购商订单号保持幂等；同一手机号存在非终态订单时拒绝收单。

{
  "app_key":"你的AppKey",
  "timestamp":1791136000,
  "sign":"签名",
  "miniunit_id":"HF-CMCC-100",
  "third_id":"你的唯一订单号",
  "call_back_url":"https://你的域名/callback",
  "datas":{"target":"13800138000","amount":"100"}
}

POST /api/merchant/order_info

按平台订单号或采购商订单号查询。

POST /api/merchant/account

查询可用余额和冻结余额。

供应商接口

POST /api/supplier/updateStatus

供应商上报最终结果。status=9 成功，status=8 失败。

单单发专用适配器

支持固定字段MD5签名、表单下单、101/102/103状态映射和回调验签。正式启用需要配置接口地址、合作商号、密钥和商品映射。

订单结果回调

订单进入最终状态后，平台向下单时的 call_back_url 发送 JSON。字段包括 app_key、timestamp、order_id、third_id、state、rsp_info 和 sign。签名为除 sign 外全部字段按字段名升序拼接后追加 AppSecret，再计算小写 MD5。接收方需返回纯文本 ok 或 success；失败时平台按 1、5、15、30、60 分钟重试。

采购订单状态

1 待推单　2 充值中　3 充值成功　4 成功后人工退款　6 充值失败（已退款）　41 人工处理中

供应商正常返回最终结果时，状态 3 或 6 会触发订单结果回调。状态 4 为运营人员审核后的特殊退款状态，目前不自动发送第二次结果回调；采购商可通过查单接口获得最新状态。

鉴权错误码

10001 参数错误　10002 签名错误　10003 时间戳超期　10004 接口身份不存在或已停用　10005 来源 IP 不在白名单