title: 一卡通v5网费对接前置接口文档 date: 2017-02-13 13:45:23 tags:

日期版本作者说明
2017-2-13V1.0夏凯祥初稿

背景

一卡通系统与网费系统的对接需要经过网费前置服务。此文档为一卡通系统与网费前置的对接规范，用户可根据实际情况实现前置与网费系统的业务对接。

约定

  1. 传输编码统一为utf-8
  2. 请求数据都用HAMC签名加密，收到请求参数后可验证数据正确性，秘钥共同约定。SIGN_ALGORITHMS ="HmacSHA1";
  3. retcode 等于"0"（字符串）表示成功，其他表示失败，失败具体信息查看 retmsg

接口定义

1. 查询网费账号余额

  • URL: /net/srun4k/query

  • 请求方式 POST

查询剩余网费金额

  • 请求参数
  • payacc - 网费账号
  • netpwd - 密码（可选），现支持无密码查询
  • timestamp - 请求时间，yyyyMMddHHmmss
  • sign - 签名，按上面参数顺序拼接进行HAMC加密（payacc+ timestamp）。
  • 返回
  • retcode - "0" 标识操作成功，其余为异常情况
  • retmsg - "msg" 返回信息
  • balance - 剩余金额，字符串
{
    "retcode":"0",
    "retmsg":"成功", // 异常原因
    "balance": "6.5"
}

2. 网费充值

  • URL: /net/srun4k/query

  • 请求方式 POST

查询剩余网费金额

  • 请求参数
  • refno - 系统交易参考号
  • payacc - 网费账号
  • amount - 充值金额，单位分
  • timestamp - 请求时间，yyyyMMddHHmmss
  • sign - 签名，按上面参数顺序拼接进行HAMC加密（refno+payacc+amount+timestamp）。
  • 返回
  • retcode - "0" 标识操作成功，其余为异常情况
  • retmsg - "msg" 返回信息
  • balance - 剩余金额，字符串
  • billno - 网费系统的流水号
{
    "retcode":"0",
    "retmsg":"成功", // 异常原因
    "balance":"30.5",
    "billno":"022017021412321100123"
}