接口地址:http://weifk.cn/inquire.asp
功能:查询订单最新处理进度,对手机充值订单和Q币充值订单同时适用
郑重声明:本接口只能查询您最近30天以内发起的订单。对于同一个订单,两次相邻查询至少间隔1分钟,否则系统会拒绝服务。
参数传入方式:GET 或 POST 均可
字符编码:本接口输入输出均采用UTF-8编码
传入参数列表:
usr —— 您在绿拓商城的用户名
ord —— 被查询交易的订单号
tim —— 查询请求时间。固定格式为“YYYYMMDDHHMMSS”,拼写规则同话费充值接口
sgn —— 查询签名。请将您的用户名、被查询订单号、查询请求时间和交易密码顺序拼接后进行MD5(32位)加密,并将该加密结果转换为大写后作为订单查询签名
返回状态:
请注意:相同返回代码在充值接口中的定义及正确处理方式,与在本查单接口中的完全不同,务必谨慎区分!
0 —— 尚未受理(订单状态有待进一步查询)
1 —— 正在受理(订单状态有待进一步查询)
2 —— 已经提交(订单状态有待进一步查询)
3 —— 不确定(订单状态有待进一步查询)
4 —— 充值成功(这是最终状态之一)
5 —— 充值失败(这是最终状态之一)
A —— 返销成功(这是最终状态之一。此状态仅从技术层面保留,目前我公司所有业务均不支持返销)
D —— 部分失败,失败部分已经退款(这是最终状态之一)
N —— 查询请求超时(订单状态有待进一步查询。如果绿拓商城接收到请求的时间,与您提交查询的时间相差超过5分钟,将产生此错误)
P —— 禁止频繁查询(订单状态有待进一步查询。对于同一个订单,两次相邻查询至少间隔1分钟,否则将产生此错误)
Q —— 商户编号错误(订单状态有待人工核实)
R —— 订单号格式错误(订单状态有待人工核实)
S —— 接口IP冲突,发起交易的IP地址与您在商户设置中绑定的接口IP地址不符(订单状态有待人工核实)
T —— 该商户未启用接口充值功能(订单状态有待人工核实)
U —— 传入参数不完整(订单状态有待人工核实)
V —— 该商户不存在(订单状态有待人工核实)
W —— 该订单不存在(考虑到网络延时等因素,订单提交后超过15分钟,仍然查无数据的,方可做失败处理。如查询时间跨越订单提交时间不足15分钟,则不可冒然做充值失败处理,订单状态有待进一步查询)
X —— 您无权查询该订单(订单状态有待人工核实)
Y —— 查询签名错误(订单状态有待人工核实)
Z —— 系统内部错误(订单状态有待人工核实)
状态返回形式:<sunny>订单号|状态|被充值号码|充值金额|已充值成功金额|扣款金额|提交时间|您的充值账户当前余额|查询时间|返回状态签名</sunny><owner>机主名称|充前余额|充后余额</owner><supplier>渠道名称</supplier><type>充值类型</type>,其中返回状态签名为:把订单号、返回状态、被充值号码、充值类型、充值金额、已成功金额、扣款金额、提交时间、账户余额、查询时间及交易密码顺序拼接后进行MD5加密并转换为大写。当返回状态为N、P、R、U、V、W时,不输出签名字段,以空占位。
调用示例:http://weifk.cn/inquire.asp?usr=myusername&ord=J000001000000003&tim=20120304133000&sgn=KKUFDC7TIUIYDES7UKDXCXJ8MKVGTU76
返回状态示例:<sunny>J000001000000003|4|13778748956|50|48.5|2012-3-4 13:30:00|496.33|2012-3-5 01:30:00|IUIYDESTXCXJ8MK7UKDKKUFDC76GY89K</sunny><owner>汪天凤|23.56|73.56</owner><supplier>sunny</supplier><type>0</type>
|