话费充值接口智生活宝.docVIP

智慧生活宝话费接口（HTTP版）V1.0 荆门三人行软件有限公司 初稿 周金龙 2012-01-22 添加错误代码1005描述 周金龙 2013-04-15 添加商户金额查询 周金龙 2014-09-03 添加话费余额查询 周金龙 2015-01-25 说 明 本文档中所包含的信息属于商业机密信息，如无荆门市三人行软件有限公司书面许可，任何人都无权复制或利用。 目 录 文档说明 3 1.1 编写目的 3 1.2 内容简介 3 1.3 定义 3 系统功能 4 基本约定 5 缴费提交接口 6 返回参数 Json 6 缴费状态查询 7 返回参数 7 余额查询 8 返回参数 8 错误列表 9 其它说明 11 文档说明 编写目的 本文档说明了智慧生活宝软件供货的接口协议等，供使用该接口的合作商和本项目的后续开发维护人员使用。 内容简介 产品包括查询话费下单，查单，余额查询 定义 缩略语 含义 合作方商户ID 合作商注册的智慧生活宝商户所对应的唯一标识 系统功能 根据需求规格和项目设计，智慧生活宝与合作商主要存在3个接口功能 基本约定 所有接口统一使用POST方式进行请求，请求数据和返回结果统一使用json，密明文规则在下述接口协议中都有说明，加密方式为MD5。 合作商系统流水号必须保证全局唯一。 合作商主动发起订单查询交易，以查询到的订单状态作为后续资金处理依据（注意：发起查询要在订单成功1分钟后开始。查询的频率不要过大） 缴费提交接口 地址：http://host/phone.aspx?type orderphone 请求参数列表 参数 名称 是否必填 说明 uid 用户编号 Y 编号为数字 phone 缴费号码 Y 手机号码为11位，固话小灵通号码前加0 price 缴费金额 Y 10-500内的金额（限额已取消：1-N，具体可冲资源咨询商务） orderid 用户订单号 Y 10-50位，可由数字、字母和下划线组成 不可重复 ordertype 订单类型 Y 1手机冲值 2固话充值 sign 密钥 Y MD5 Uid+phone+price+orderid+ordertype+key 返回参数 Json 参数 名称 说明 Code 提交代码 Info 提示信息 提交URL： http://localhost:12209/phone.aspx?type orderphoneuid 1座机电话号码17phone 1座机电话号码76price 10orderid 1座机电话号码11093ordertype 1sign 6c779046d5bce6dd20600af51bb1c832 返回： Code:’0000’,Info:’提交成功’ //详细的对应信息请查询附表一 缴费状态查询 地址：http://host/phone.aspx?type querystate 请求参数列表 参数 名称 是否必填 说明 uid 用户编号 Y 编号为数字 orderid 用户订单号 Y 10-50位，可由数字、字母和下划线组成 ordertype 订单类型 Y 1手机 2固话 sign 签名 Y 值为MD5 uid + orderid + ordertype + key 返回参数 返回值为3位数字编码，编码参见错误列表 例： http://localhost:12209/phone.aspx?type querystateuid 1座机电话号码17orderid 1座机电话号码11093ordertype 1sign 728820b06a0a94ff58baa0a767205ead 返回： Code:’1000’,Info:’订单成功’ //详细的对应信息请查询附表二 余额查询 地址：http://host/phone.aspx?type querybalance 请求参数列表 参数 名称 是否必填 说明 uid 用户编号 Y 编号为数字 sign 签名 Y 值为MD5 uid + Key 返回参数 错误编码|余额 错误编码参见错误列表 例： http://host/phone.aspx?uid 1111Sign b9919ff3ce720ed36cbb08e4719c1633 返回： 100 错误列表 附表一 错误编码 描述 0000 订单提交成功 0001 必要参数不能为空 0012 商户账户余额不足完成交易 0011 提交订单失败 Xml 0005 订单号码重复 Xml 0006 订单状态不明确，请查询状态 0007 暂无此面额缴费产品 （状态不明确，判断为存疑） 0008 该地区商品维护 （状态不明确，判断为存疑）