# 查询充值API
1 协议说明
| 协议 | HTTP POST |
|---|---|
| 编码格式 | UTF8 |
| URL | 举例：http://msg.yundashi.com/cdp/intf/queryCharge?sdkappid=xxxxx&random=xxxx |
| 接口说明 | 用户流量充值查询。注：sdkappid请填写您在云大师短信官网上申请到的客户编号，random请填成随机数。 |
2 请求包体
包体为json字符串，参数如下：
{
"sig": "40834f0be1684ce9b5ff85c923a7bf74dc3b3f1b2d085f00ae336a9c56118fe3", //app凭证，具体计算方式见下注
"time": 1457336869, //unix时间戳，请求发起时间，如果和系统时间相差超过10分钟则会返回失败
"orderid": "appid_xxxx", //必填项，充值成功提交后，返回的订单ID
}
| 参数 | 必选 | 类型 | 描述 |
|---|---|---|---|
| orderid | 是 | string | 必填项，充值成功提交后，返回的订单ID |
| sig | 是 | string | App 凭证，具体计算方式见下注 |
| time | 是 | number | 请求发起时间，unix 时间戳（单位：秒），如果和系统时间相差超过 10 分钟则会返回失败 |
注：
"sig"字段根据公式sha256(appkey=$appkey&random=$random&time=$time&orderid=$orderid)生成 伪代码如下：
string strOrderid = "appid_xxxx"; //订单ID
string strAppKey = "dffdfd6029698a5fdf4"; //sdkappid对应的appkey，需要业务方高度保密
string strRand = "7226249334"; //url中的random字段的值
string strTime = "1457336869"; //unix时间戳
string sig = sha256(appkey=$strAppKey&random=$strRand&time=$strTime&strOrderid=$strOrderid);
3 应答包体
{
"Model": //充值明细记录
{
"flow": "10", //充值档位
"id": "dc29c636-0018-11e8-ba3c-00163e0e3bc9", //充值的订单ID
"operator": "中国移动", //运营商
"phone": "139XXXXX639", //充值手机号
"reason": "充值成功", //充值描述
"status": "3", //3：充值成功，1：充值中， 4：充值失败
"time": "2018-01-23 16:39:01", //充值时间
},
"RequestId":"85795663-8021", //状态码描述
"Code": "OK", //状态码-返回OK代表请求成功,其他错误码见状态码描述
"Message": "xxxxxxx", ///状态码描述
}