缴费 100API 服务接口

Version2.5
文档修订历史

版本号 修订章节 备注 修订日期
Ver2.5 新增接口 新增短信发送接口 2019-4-11
Ver2.4 新增返回流水号 OutOrderNo(流水号),VacherType(类型) 2018-12-25
Ver2.3 优化文档 优化流量提交示例 2017-04-26
Ver2.2 新增接口 新增全国水电气缴费,查询接口 2016-05-10
Ver2.1 新增接口 新增交通罚款充值,查询接口 2016-03-10
Ver2.0 新增接口 新增加油卡充值接口 2016-01-25
Ver1.9 新增接口 新增固话,游戏充值接口,游戏充值接口支持流量充值 2015-08-17
Ver1.4 新增接口 新增订单状态异步回调接口 2015-06-28
Ver1.3 新增接口 新增余额查询接口 2015-06-25
Ver1.2 增加状态 10024 2015-03-25
Ver1.1 优化文档 优化文档部分描述 2014-11-25
Ver1.0 创建文档 2014-10-20

一、文档说明


1.编写目的

      100API 平台的充值服务接口协议,供使用该接口的合作商和本项目的后续开发维护人员使用。


二、系统功能

     根据需求规范,缴费 100API 提供全话费充值、水电气、火车票、飞机票、汽车票、公交 IC(重庆、四川)、交罚,游戏、Q 币直冲等 API,根据不同接口,提供不同 API 接口规范。


1.业务交易逻辑

     业务逻辑:同步提交订单返回提交是否成功,异步返回交易是否成功。异常或超时请查询订单确认订单详情。


2.基本约定

1)接口使用 POST 或者 GET 方式进行提交,编码格式为 UTF-8。

2)如果某个变量没有值,那么该变量的 value 对将不出现在加密明文中,加密明文规则在下述接口协议中都有说明,加密方式为 MD5(加密后签名总长 32 位),MD5 大写。

3)合作商系统流水号必须保证全局唯一。

4)合作商在接收到缴费 100API 订单结果后,如果订单状态为异常、处理中时合作商需要主动发起订单查询交易,以查询到的订单状态作为后续资金处理依据,如果通知的订单状态为成功、失败无需再发起查询。具体参照交易结果码说明

5)接口超时时间统一定为 3 分钟,直充接口三分钟内没有返回结果则需查询。

三、缴费100API平台接口


1. 话费充值接口


此接口依据用户提供的请求为指定手机号码进行缴费充值(含流量充值)

请求参数说明:

话费请求地址: http://open.jiaofei100.com/Api/PayMobile.aspx
流量充值请求地址: http://open.jiaofei100.com/Api/PayMobileFlow.aspx
请求参数列表

参数 说明 可空 说明
APIID 合作方用户系统编号 False 由缴费100平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
UnitPrice 该商品面值 False 单位:厘(不允许小数点)(如果充值产品为流量,面值=需要充值 的流量包大小,例如充值 30M,面值=30M*1000,如果无限流量包 传 0)
BuyNum 购买数量 False 话费除 1 元面值可叠加数量,其他面值必须是 1
TotalPrice 总交易金额或交易总流量(面值*数量) False 单位:厘(不允许小数点)或 UnitPrice*BuyNum
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
Operator 运营商 True 1:电信,2:联通,3:移动 (非必传,不参与签名。)
Sign 签名字符串 False Md5(APIID=1504102**91864&Account=13896193383&BuyNum=1&C reateTime=20150426230043&isCallBack=0&OrderID=123456789 10&TotalPrice=10000&TradeType=10&UnitPrice=10000&APIKEY =BA336*******B90568D) 转大写

请求示例:

1、话费充值
http://localhost/Api/PayMobile.aspx?APIID=**********&TradeType=10&Account=13896 193383&UnitPrice=100000&BuyNum=1&TotalPrice=100000&OrderID=1234567891012112&Cre ateTime=20150426200630&IsCallBack=0&Sign=68858E4D4D8EF8FE765315C87F48FC2D

请求返回结果:
{
"Code": "10018",
"Msg": "订单提交成功",
"OrderID": "1234567891012112",
"Account": "13896193383",
"UnitPrice": "100000",
"ReturnOrderID": "1000426063776464",
"TradingID": "10020150426377080643654"
}


2、流量充值

http://localhost/Api/PayMobileFlow.aspx?APIID=1*********0&Account=15595518173&B uyNum=1&CreateTime=20170426193356&IsCallBack=1&OrderID=12345678910&TotalPrice=1 0000&TradeType=13&UnitPrice=10000&Sign=68858E4D4D8EF8FE765315C87F48FC2D

请求返回结果 {
"Code":"10018",

"Msg":"订单提交成功",
"OrderID":"2017042619335698358456",
"Account":13896193383,
"UnitPrice":1000,
"ReturnOrderID":1000426063776464,
"TradingID":"10020150426377080643654"
}


返回参数列表:

参数 说明 备注
Code 返回状态码 具体参照:交易结果码备注
Msg 返回状态说明 具体参照:交易结果码备注
OrderID 合作方订单编号 状态等于 10018 时返回
Account 充值号码 状态等于 10018 时返回
UnitPrice 充值金额 状态等于 10018 时返回
ReturnOrderID 缴费 100 订单编号 状态等于 10018 时返回
TradingID 缴费 100 交易流水 状态等于 10018 时返回


2. 固话充值接口

此接口依据用户提供的请求为指定固话号码进行缴费充值请求参数说明

请求地址: http://open.jiaofei100.com/Api/PayFixPhone.aspx
请求参数列表

参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
UnitPrice 该商品面值 False 单位:厘(不允许小数点)
BuyNum 购买数量 False 话费除 1 元面值可叠加数量,其他面值必须是 1
TotalPrice 总交易金额(面值*数量) False 单位:厘(不允许小数点)
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不 允许充值。
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
Operator 运营商 False 1:电信,2:联通,3:移动,4:铁通
Sign 签名字符串 False Md5(APIID=1504102**91864&Account=13896193383& BuyNum=1&CreateTime=20150426230043&isCallBack =0&Operator=1&OrderID=12345678910&TotalPrice= 10000&TradeType=10&UnitPrice=10000&APIKEY=BA3 36*******B90568D) 转大写

请求示例:

http://localhost/Api/PayFixPhone.aspx?APIID=**********&TradeType=10&Account=138 96193383&UnitPrice=100000&BuyNum=1&TotalPrice=100000&OrderID=1234567891012112&C reateTime=20150426200630&IsCallBack=0&Operator=1&Sign=68858E4D4D8EF8FE765315C87 F48FC2D

请求返回示例请参阅话费充值接口.


3. 游戏/卡密/卡券充值接口


请求参数说明

请求地址: http://open.jiaofei100.com/Api/PayGame.aspx

请求参数列表



参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
当商品类型为卡密的时候 此参数为空字符串(不是null)
UnitPrice 该商品面值 False 单位:厘(不允许小数点)(Q 币固定值 1000)
BuyNum 购买数量 False
TotalPrice 总交易金额(面值*数量) False 单位:厘(不允许小数点)
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
GoodsID 商品 ID False (Q 币商品 ID: 23071900)
ClientIP IP 地址 False 客户端IP,如果是游戏充值,该字段为区服参数
Sign 签名字符串 False Md5(APIID=1504102**91864&Account=13896193383& BuyNum=1&ClientIP=121.10.42.10&CreateTime=201504 26230043&GoodsID=23071900&isCallBack=0&OrderID= 12345678910&TotalPrice=10000&TradeType=23& UnitPrice=10000&APIKEY=BA336*******B90568D) 转大写

请求示例:

http://localhost/Api/PayGame.aspx?APIID=1504102**91864&Account=13896193383&BuyNum=1&ClientIP=121.10.42.10 &CreateTime=20150426230043&GoodsID=23071900&isCallBack=0 &OrderID=12345678910&TotalPrice=10000&TradeType=23&UnitPrice=10000& Sign=68858E4D4D8EF8FE765315C87F48FC2D

1.游戏/娱乐请求返回示例请参阅话费充值接口

2.特殊订阅联通沃阅读产品请求返回示例请参阅(注意看字)

请求返回结果
{
"Code":"10018",
"Msg":"订单提交成功",
"Requrl":"http://"
}


返回参数列表:

参数 说明 备注
Code 返回状态码 具体参照:交易结果码备注
Msg 返回状态说明 具体参照:交易结果码备注
Requrl 用户订购页面 状态等于 10018 时返回

4. 视频充值接口


请求参数说明

请求地址: http://open.jiaofei100.com/Api/PayVideo.aspx

请求参数列表



参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
Account 充值账号 False 充值账号
ProductCode 商品编号 False 由缴费 100 平台提供
BuyNum 购买数量 False
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
Sign 签名字符串 False Md5(APIID=1504102**91864&Account=13896193383&BuyNum=1& CreateTime=20150426230043&IsCallBack=0&OrderID=123456789 10&ProductCode=60007088&APIKEY=BA336*******B90568D)
转大写

请求示例:

http://localhost/Api/PayVideo.aspx?APIID=1504102**91864&Account=13896193383&BuyNum=1 &CreateTime=20150426230043&IsCallBack=0&OrderID=12345678910&ProductCode=60007088& Sign=68858E4D4D8EF8FE765315C87F48FC2D

请求返回示例请参阅话费充值接口.


5. 交通罚款查询接口


请求参数说明

请求地址: http://open.jiaofei100.com/Api/GetTrafficBill.aspx

请求参数列表



参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Mobile 查询号码 False 查询号码
Operator 运营商 False 默认值(0)
Province False
City False
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
ServiceType 业务类型 False GetBill
Sign 签名字符串 False Md5( APIID=150601510235****64&City=重庆 &CreateTime=20160325143***307&Mobile=5**3&Oper ator=0&Province=重庆 &ServiceType=GetBill&TradeType=44&APIKEY=F4938 514B22F298038291795***A556E60F ) 转大写

请求示例:


http://open.jiaofei100.com/Api/GetTrafficBill.aspxAPIID=15060151023**564&Mobile=5008001* **84413&Operator=0&Province=%e9%87%8d%e5%ba%86&City=%e9%87%8d%e5%ba%86&CreateTi me=20160325143307&TradeType=44&ServiceType=GetBill&Sign=6542FF054F11CE5D08F3C58 9897FB824


请求返回结果:

. {
"Code": "success",
"NotcNo": "5008001002808103",
"AccumWthdrAmt": "50.00",
"LateFee": "0.00",
"FineAmtTot": "50",
"StartDate": "20160324",
"DriLicseNo": "512928195610042815",
"BudgUnitNme": "500800",
"OrderID": "23001212313212114"
}.

返回参数列表:
参数 说明 备注
Code 返回状态码 Success,fail
Msg 返回状态说明 Code 为 fail 返回具体说明
OrderID 查询订单号 系统返回
NotcNo 罚单
AccumWthdrAmt 处罚金额 状态等于10018时返回
LateFee 滞纳金
FineAmtTot 总金额
StartDate 处罚日期
DriLicseNo 驾驶证号
BudgUnitNme 处罚单位

6. 交通罚款充值接口

请求参数说明

请求地址: http://open.jiaofei100.com/Api/GetTrafficBill.aspx
请求参数列表

参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
Province False 单位:厘(不允许小数点)(Q 币固定值 1000)
City False
TotalPrice 总交易金额 False 单位:厘(不允许小数点)
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允 许充值。
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
ServiceType 业务类型 False PayBill
Sign 签名字符串 False Md5( APIID=150601510**23564&Account=1388358146** 6&City=重庆 &CreateTime=20160325144500&isCallBack=0&OrderID =20160325144500test&Province=重庆 &ServiceType=PayBill&TotalPrice=100000&TradeTyp e=25&APIKEY=F493851**1795A556E60F) 转大写

请求示例:

http://localhost/Api/GetTrafficBill.aspx?APIID=1506****3564&Account=13883581466&Province=%e9%87%8d%e5%ba%86&City=%e9%87% 8d%e5%ba%86&CreateTime=20160325144500&IsCallBack=0&OrderID=20160325144500test& TotalPrice=100000 &TradeType=25&ServiceType=PayBill&Sign=EB189C1F28315172B783B872 240EAAB5

请求返回结果.

. {
"Code": "success",
" Yearmonth": "5008001002808103",
" Username": "0.00",
" Bills": "50",
" OrderID": "20160324",
}.

返回参数列表:

参数 说明 备注
Code 返回状态码 Success,fail
Yearmonth 账单月份 不支持分月账单返回空值
Username 用户名 用户姓名或未欠费
Bills 账单金额 金额单位为 厘
OrderID 查询订单号 查询成功时返回


7. 水电气查询接口

请求参数说明

请求地址: http://open.jiaofei100.com/Api/PayLife.aspx

请求参数列表

参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
GoodsID 商品 ID False 由缴费 100 平台提供
Yearmonth 账单月份 False 默认值(all)
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
ServiceType 业务类型 False GetBill
Sign 签名字符串 False Md5(Account=01181575&APIID=150***3564&CreateTim e=20160524123550&GoodsID=32745028&ServiceType=G etBill&TradeType=14&Yearmonth=all&APIKEY=F4***1 795A556E60F) 转大写

请求示例:

http://localhost/Api/PayLife.aspx? APIID=15060***3564&Account=01181575&CreateTime=20160524123550&GoodsID=32745028& TradeType=14&ServiceType=GetBill&Yearmonth=all&Sign=14B46**E2DC1C2F1E4FFD1

请求返回结果.

. {
"Code": "success",
" Yearmonth": "5008001002808103",
" Username": "0.00",
" Bills": "50",
" OrderID": "20160324",
}.

返回参数列表:

参数 说明 备注
Code 返回状态码 Success,fail
Yearmonth 账单月份 不支持分月账单返回空值
Username 用户名 用户姓名或未欠费
Bills 账单金额 金额单位为 厘
OrderID 查询订单号 查询成功时返回

8. 水电气缴费接口

请求参数说明

请求地址: http://open.jiaofei100.com/Api/PayLife.aspx

请求参数列表

参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
GoodsID 商品 ID False 由缴费 100 平台提供
Yearmonth 账单月份 False 默认值(all)
TotalPrice 总交易金额 False 单位:厘(不允许小数点)
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允 许充值。
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
ServiceType 业务类型 False PayLifeOrder
Sign 签名字符串 False Md5(APIID=150****1023564&Account=01181575&Creat eTime=20160524124524&GoodsID=14743052&isCallBac k=0&OrderID=test20160524124524&ServiceType=PayL ifeOrder&TotalPrice=1000&TradeType=14&Yearmonth =all&APIKEY=F4938514B22F2980****1795A556E60F) 转大写

请求示例:

http://localhost/Api/PayLife.aspx? APIID=15060151023564&Account=01181575&CreateTime=20160524124524&GoodsID=1474305 2&TradeType=14&ServiceType=PayLifeOrder&Yearmonth=all&IsCallBack=0&OrderID=test 20160524124524&TotalPrice=1000&Sign=6B8F00428740A5BAB1274C74333CEFB7


请求返回示例请参阅话费充值接口.


9. 订单查询接口

此接口返回某一订单的处理结果。

请求参数说明
请求地址:http://open.jiaofei100.com/Api/GetOrderInfo.aspx
请求参数列表

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
OrderID 合作方订单编号 False 由合作方负责生成该订单号,且保证每笔唯 一,重复则缴费 100 不允许充值。
ServiceType 查询类型 False ServiceType=GetCombination(组合商品订单查询才传入不参与md5加密)
Sign 签名字符串 False Md5(APIID=150410****64&OrderID=1504171 9891319&APIKEY=BA33*****BFA51F95617B90 568D) 转大写

请求示例:

http://open.jiaofei100.com/Api/GetOrderInfo.aspx?APIID=1504102****864&OrderID=1504171989 1319&Sign=3541F9E0F09B0D4A1****2E592E4BBD0

1. 请求返回结果

{
"Code": 10027,
"OrderID": 1000417004846484,
"OutID": 15041719891319,
"Msg": "交易成功"
"OutOrderNo":"438425338168022871"
"VacherType":"0"
}

2. 卡密订单请求返回结果

{
"Code": 10027,
"OrderID": 1000417004846484,
"OutID": 15041719891319,
"Msg": "交易成功"
"OrderInfo": [{"CardNumber":"s1fr+FhNzh4p/sJuFQhDLA==","CardPass":"ioG8y2rz1drk6a2DRPqbIQ=="}]
}

请求返回参数列表

参数 说明 备注
Code 响应码 具体参照:交易结果码说明)
Msg 响应码说明 具体参照:交易结果码说明
OrderID 缴费 100 订单号 缴费 100 订单号
OutID 合作方订单编号 请求的“合作方订单编号”
OrderInfo 卡密列表 解密查看附录4

10. 机票查询接口

此接口返回某一订单的处理结果。

请求参数说明
请求地址:http://open.jiaofei100.com/Api/SelectPlaneTicket.aspx
请求参数列表

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
OrderID 合作方订单编号 False 由合作方负责生成该订单号,且保证每笔唯 一,重复则缴费 100 不允许充值。
TradeType 商品类型 False 请参数附录商品类型
StartCity 出发城市 False 城市数据请访问 http://jiaofei100.com/open/City.js
EndCity 终点城市 False 城市数据请访问 http://jiaofei100.com/open/City.js
StartTime 出发时间 False yyyy-MM-dd
Sign 签名字符串 False Md5(APIID=150410****64&OrderID=1504171 9891319&EndCity=UrlEncode(北京)&StartCity=UrlEncode(重庆)& StartTime=2018-05-22&TradeType=50& APIKEY=BA33*****BFA51F95617B90568D) 转大写
UrlEncode(北京)=%E5%8C%97%E4%BA%AC
编码后字符串中间的英文是大写

请求示例:

http://open.jiaofei100.com/Api/SelectPlaneTicket.aspx?APIID=150410****64& OrderID=15041719891319&EndCity=北京& StartCity=重庆&StartTime=2018-05-22& TradeType=50&Sign=3541F9E0F09B0D4A1****2E592E4BBD0

请求返回结果

{
"Code":"success",
"OrderID":"3000523336049689",
"retuinfo":
[
[
{
"week":"星期三",
"depDate":"2018-05-23",
"flightsShortName":"国际航空",
"flightNo":"CA4557",
"fromtime":"16:45",
"totime":"19:00",
"playtype":"73T",
"sheatNum":"2",
"shetclasscode":"经济舱",
"price":"998",
"saleprice":"996",
"audletAirportTax":"50",
"audultFuelTax":"10",
"fromport":"CKG",
"toport":"NKG",
"fromTerminalBuild":"T3",
"totTrminalBuild":" ",
"token":"y3Csoq7zYS4VMtjr1pU8FbWTXNLns3yM%2fzSaLzrPKyl02MAPq6tGZltui4P2C Y4cYs4WJvv40VgPLafNS9lcwXy%2fgOszPOpby5zcfsfKd%2bGRho%2fUOd7QD31 G7D0X72I9vboT63kgiz3424I1cfBoIWBkEweGBQPXMB3VTEn%2boPGAt7vJzG9Ri CxFY%2bHpLf3d6tYv28N3gRgZR%2fgEf9E%2bRTc4fyDCk%2bRDa7VtGOEfqVAv9 sHp4HwTb8vjNIxuOT4Q29029sS%2f%2fsfl9gcv0zrsY4ffpYrO6s321uKuyALUz bsWW8jx%2f0gsCktwixXuTANldPZgfwXEqOToYbJEOsHgbZjmDvLnk%2fL4zJ5wE ZlFD1PNvVVTahUFPPReuuDf6gHgD4UmSRwb6L5a5XlE57huUCTz%2fkTmpYCltCL u6kwozpIA%2bunFTRDF7tvNOREs58%2bgZXolh4HFhi94Q5%2fbEqsG0ex%2f7yc EPhNKzZU5VNbFJFoLeZQX7VO%2bqlUYZHn3gBlOWyxkTX1oqchPnkzgADe%2b38H 5HidmTxqY4NzX1g3GckI%2bQ4VRE1tZANF8OZgKN8jm1hEtXEhR2Gs0dtVUs1OtZD Ls3YCDG7BnRPJxFRVURj%2bBJ4qZTLc%2fY9kLRvT9Phm1YjHCjkvlA2gjOOE5ltA Y4G3rsvLKFClVVu04Z5QfFrkuRZSzPmHcFey3upQMtNA4CfUB%2bpmZYeaIExKC0J jl4kKzK1rAnUBGjeSWHh1ky5hIlbWsquUYU7RdQsyFC8nGBV9PTuymnzaPYrzaIfz UT2RvYIO0uQVuZt5%2fcKe5%2fwbuoB6pOpG%2bNnrDWj%2bw3eT01v2fu%2fCnZy aYLCswVFHnZDYBCKSQ0KouCGeJNpd7LDOxWCwVJgci%2fXOFnLQj3BfyrejI%2bwQ e7aGS9DVdxDRIAj4dy5mzb3xuVmqLBYGZNTfGtClL32vFEToA3Ljz%2f0sO"
}
]
]
}

参数 说明 备注
Code 响应结果 success 成功 fail 失败
OrderID 合作方订单编号 合作方订单编号
week
depDate 出发日期 出发日期
flightsShortName 航班简称 航班简称
flightNo 航班号 航班号
fromtime 起飞时间 起飞时间
totime 到达时间 到达时间
playtype 机型 机型
sheatNum 剩余票数 当票数大于等于9张的时候 就返回9
shetclasscode 舱位 舱位
price 面值价格 不包含 机场建设费和燃油费
saleprice 售价 不包含 机场建设费和燃油费
audletAirportTax 机场建设费用 50
audultFuelTax 飞机燃油费 10
fromport 出发地 出发地
toport 目的地 目的地
fromTerminalBuild 出发航站楼 出发航站楼
totTrminalBuild 到达航站楼 到达航站楼
token 数据令牌 数据令牌

11. 机票代购接口


此接口依据用户提供的请求为指定数据

请求参数说明:

机票代购请求地址: http://open.jiaofei100.com/Api/PayPlaneTicket.aspx
请求参数列表

参数 说明 可空 说明
APIID 合作方用户系统编号 False 由缴费100平台提供
TradeType 商品类型 False 请参数附录商品类型
GoodsID 商品编号 False 由缴费100平台提供
UserName 乘机人姓名 False 乘机人姓名
CardID 乘机人身份证 False 乘机人身份证
ContactsName 联系人姓名 False 联系人姓名
Mobile 联系人手机号码 False 联系人手机号码
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
ServiceType 业务类型 False SubPlaneTicket
Token 数据令牌 False 查询机票的时候包含在里面的
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
Sign 签名字符串 False Md5(APIID=1504102**91864&CardID=500108
**********12&ContactsName=UrlEncode(刘先生,UTF-8)
&CreateTime=20150426230043&GoodsID=1212121&
Mobile=13896***112&OrderID=1235678910&
ServiceType=SubPlaneTicket&TradeType=22&Use
rName=UrlEncode(刘先生,UTF-8)&APIKEY=BA336*******B90568D)
转大写

UrlEncode(刘先生,UTF-8)=%E5%88%98%E5%85%88%E7%94%9F
编码后字符串中间的英文是大写

请求示例:

http://localhost/Api/PayPlaneTicket.aspx? APIID=16071***265600&CardID=5001***98512140412&ContactsName=赵先生&CreateTime= 201805290956&GoodsID=22145121&Mobile=13896069591&OrderID=1234567890A&ServiceType =SubPlaneTicket&TradeType=22&UserName=赵意&Sign=6B8F00428740A5BAB1274C74333CEFB7 Token=y3Csoq7zYS4VMtjr1pU8FbW****************


请求返回示例请参阅话费充值接口.


12. 交通意外险代购接口


此接口依据用户提供的请求为指定数据

请求参数说明:

机票代购请求地址: http://open.jiaofei100.com/Api/PayPlaneSafe.aspx
请求参数列表

参数 说明 可空 说明
APIID 合作方用户系统编号 False 由缴费100平台提供
TradeType 商品类型 False 请参数附录商品类型
GoodsID 商品编号 False 由缴费100平台提供
UserName 乘机人姓名 False 乘机人姓名
CardID 乘机人身份证 False 乘机人身份证
Mobile 联系人手机号码 False 联系人手机号码
Time 出发时间 False 出发时间(格式:2018-06-03)
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
ServiceType 业务类型 False SubPlaneSafe
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
Sign 签名字符串 False APIID=504102**91864&CardID=500108********
**12&CreateTime=20150426230043&GoodsID=22
004706&Mobile=13896***112&OrderID=12356789
10&ServiceType=SubPlaneSafe&Time=2018-06-2&
TradeType=22&UserName=UrlEncode(刘先生)&API
KEY=BA336*******B90568D)
转大写

UrlEncode(刘先生,UTF-8)=%E5%88%98%E5%85%88%E7%94%9F
编码后字符串中间的英文是大写

请求示例:

http://localhost/Api/PayPlaneSafe.aspx? APIID=504102**91864&CardID=500108**********12& CreateTime=20150426230043&GoodsID=22004706 &Mobile=13896***112&OrderID=1235678910&ServiceType=SubPlaneSafe &Time=2018-06-02&TradeType=22&UserName=UrlEncode(刘先生) &APIKEY=BA336*******B90568D)&Sign=6B8F00428740A5BAB12 74C74333CEFB7


请求返回示例请参阅话费充值接口.


13. 汽车票查询接口

此接口返回某一订单的处理结果。

请求参数说明
请求地址:http://open.jiaofei100.com/Api/SelectInquiringbus.aspx
请求参数列表

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
OrderID 合作方订单编号 False 由合作方负责生成该订单号,且保证每笔唯 一,重复则缴费 100 不允许充值。
TradeType 商品类型 False 请参数附录商品类型
StartCity 出发城市 False 城市数据请访问 http://jiaofei100.com/open/City.js
EndCity 终点城市 False 城市数据请访问 http://jiaofei100.com/open/City.js
StartTime 出发时间 False yyyy-MM-dd
Sign 签名字符串 False Md5(APIID=150410****64&OrderID= 15041719891319&EndCity=UrlEncode (北京)&StartCity=UrlEncode(重庆) &StartTime=2018-05-22&TradeType=50& APIKEY=BA33*****BFA51F95617B90568D) 转大写UrlEncode(北京)=%E5%8C%97%E4%BA %AC 编码后字符串中间的英文是大写

请求示例:

http://open.jiaofei100.com/Api/SelectInquiringbus.aspx?APIID=150410****64& OrderID=15041719891319&EndCity=北京& StartCity=重庆&StartTime=2018-05-22& TradeType=21&Sign=3541F9E0F09B0D4A1****2E592E4BBD0

请求返回结果

{
"Code":"success",
"OrderID":"2900824018608037",
"retuinfo":
[
{
"schDate":"2018-9-11 06:20",
"schDist":"25.00",
"schStationName":"垫江客运中心",
"schDstNodeName":"垫江杠家",
"Linename":"丰都",
"Typeofpassengercar":"中型中级",
"Trainnumber":"2301","price":"7.50",
"saleprice":"7.50",
"Spareticket":"31",
"Routeline":"垫江杠家,垫江豹山,垫江大石,垫江高石坎,丰都许明,丰都唐家岩,丰都梯子河,丰都仁沙,丰都社坛,丰都永兴,丰都大池,丰都汽车站" "token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"; }
]
}

参数 说明 备注
Code 响应结果 success 成功 fail 失败
OrderID 合作方订单编号 合作方订单编号
schDate 出发时间 出发时间
schDist 距离目的地多少千米 距离目的地多少千米
schStationName 出发客运中心 出发客运中心
schDstNodeName 到达客运中心 到达客运中心
Linename 线路名 线路名
Typeofpassengercar 客车类型 客车类型
Trainnumber 车次 车次
price 面值价格 面值价格
saleprice 售价 售价
Spareticket 余票 余票
Routeline 途径线路 途径线路
token 数据令牌 数据令牌

14. 汽车票代购接口


此接口依据用户提供的请求为指定数据

请求参数说明:

机票代购请求地址: http://open.jiaofei100.com/Api/PayBUSTicket.aspx
请求参数列表

参数 说明 可空 说明
APIID 合作方用户系统编号 False 由缴费100平台提供
TradeType 商品类型 False 请参数附录商品类型
GoodsID 商品编号 False 由缴费100平台提供
UserName 乘机人姓名 False 乘车人姓名
CardID 乘机人身份证 False 乘车人身份证
ContactsName 联系人姓名 False 联系人姓名
Mobile 联系人手机号码 False 联系人手机号码
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
ServiceType 业务类型 False SubBUSTicket
Token 数据令牌 False 查询机票的时候包含在里面的
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
Sign 签名字符串 False Md5(APIID=16071*****600&CardID=500**********12&
ContactsName=UrlEncode("刘先生", Encoding.UTF8)
&CreateTime=20180608091138&GoodsID=20126616&Mobile
=138*******91&OrderID=a1234567891ABCDGHFFH&
ServiceType=SubTrainTicket&TradeType=20&
UserName=UrlEncode("刘先生", Encoding.UTF8)&
APIKEY=BA336*******B90568D)
转大写

UrlEncode(刘先生,UTF-8)=%E5%88%98%E5%85%88%E7%94%9F
编码后字符串中间的英文是大写

请求示例:

http://localhost/Api/PayBUSTicket.aspx? APIID=160718***65600&CardID=500108****12140412&ContactsName=刘先生& CreateTime=20180608091138&GoodsID=20126616&Mobile=13896069591&OrderID =a1234567891ABCDGHFFH&ServiceType=SubTrainTicket&TradeType=20& UserName=刘先生&Token=y3Csoq7zYS4VMtjr1pU8FbW****************


请求返回示例请参阅话费充值接口.


15. 火车票查询接口

此接口返回某一订单的处理结果。

请求参数说明
请求地址:http://open.jiaofei100.com/Api/SelectTrainTicket.aspx
请求参数列表

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
OrderID 合作方订单编号 False 由合作方负责生成该订单号,且保证每笔唯 一,重复则缴费 100 不允许充值。
TradeType 商品类型 False 请参数附录商品类型
StartCity 出发城市 False 城市数据请访问 http://jiaofei100.com/open/City.js
EndCity 终点城市 False 城市数据请访问 http://jiaofei100.com/open/City.js
StartTime 出发时间 False yyyy-MM-dd
Sign 签名字符串 False Md5(APIID=150410****64&OrderID= 15041719891319&EndCity=UrlEncode (北京)&StartCity=UrlEncode(重庆) &StartTime=2018-05-22&TradeType=50& APIKEY=BA33*****BFA51F95617B90568D) 转大写UrlEncode(北京)=%E5%8C%97%E4%BA %AC 编码后字符串中间的英文是大写

请求示例:

http://open.jiaofei100.com/Api/SelectTicket.aspx?APIID=150410****64& OrderID=15041719891319&EndCity=北京& StartCity=重庆&StartTime=2018-05-22& TradeType=50&Sign=3541F9E0F09B0D4A1****2E592E4BBD0

请求返回结果

{
"Code":"success",
"OrderID":"12121212ab",
"retuinfo":[
{
"train":"Z50",
"fromstation":"重庆北",
"tostation":"北京西",
"dptTime":"2018-06-05 14:44:00",
"arrTime":"2018-06-06 14:44:00",
"lishiValue":"1158",
"seatList":[
{
"seat":"无座",
"price":"229",
"saleprice":"229",
"count":"100",
"token":"gL95yA3XJjlZfe3Wry08uJ32dduVKtaGk0ZMY1%2bJhiESJ%2f0GM7U
DdCFTj%2bn%2bsr29eGTaO2QYiPtHs5MzkQ4Bqlk139YrBvKhMQVSYbO2a0QR9I
HW0dGMc3faKYp6jr8LaC6dqm5DAtvUuCG4dGJP4uH7tzf0cqkN4MR1e1cS0UU%3d"
}
]
}
]
}

参数 说明 备注
Code 响应结果 success 成功 fail 失败
OrderID 合作方订单编号 合作方订单编号
train 车次
fromstation 出发地方 出发地方
tostation 到达地方 到达地方
dptTime 发车时间 发车时间
arrTime 到达时间 到达时间
lishiValue 运行时间(分钟) 运行时间(分钟)
seat 座位 座位
price 面值价格 面值价格
saleprice 售价 售价
count 剩余座位 剩余座位
token 数据令牌 数据令牌

16. 火车票代购接口


此接口依据用户提供的请求为指定数据

请求参数说明:

机票代购请求地址: http://open.jiaofei100.com/Api/PayTrainTicket.aspx
请求参数列表

参数 说明 可空 说明
APIID 合作方用户系统编号 False 由缴费100平台提供
TradeType 商品类型 False 请参数附录商品类型
GoodsID 商品编号 False 由缴费100平台提供
UserName 乘机人姓名 False 乘车人姓名
CardID 乘机人身份证 False 乘车人身份证
ContactsName 联系人姓名 False 联系人姓名
Mobile 联系人手机号码 False 联系人手机号码
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
ServiceType 业务类型 False SubTrainTicket
Token 数据令牌 False 查询机票的时候包含在里面的
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
Sign 签名字符串 False Md5(APIID=16071*****600&CardID=500**********12&
ContactsName=UrlEncode("刘先生", Encoding.UTF8)
&CreateTime=20180608091138&GoodsID=20126616&Mobile
=138*******91&OrderID=a1234567891ABCDGHFFH&
ServiceType=SubTrainTicket&TradeType=20&
UserName=UrlEncode("刘先生", Encoding.UTF8)&
APIKEY=BA336*******B90568D)
转大写

UrlEncode(刘先生,UTF-8)=%E5%88%98%E5%85%88%E7%94%9F
编码后字符串中间的英文是大写

请求示例:

http://localhost/Api/PayTrainTicket.aspx? APIID=16071***265600&CardID=500108***2140412&ContactsName=刘先生& CreateTime=20180608091138&GoodsID=20126616&Mobile=13896**9591&OrderID =a1234567891ABCDGHFFH&ServiceType=SubTrainTicket&TradeType=20& UserName=刘先生&Token=y3Csoq7zYS4VMtjr1pU8FbW****************


请求返回示例请参阅话费充值接口.


17. 订单状态异步通知接口

该接口是以 post 方式将订单状态通知合作方绑定的回调地址上

异步通知返回参数列表

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
TradeType 商品类型 False 请参数附录商品类型
OutID 合作方订单编号 False 由合作方负责生成该订单号,且保证每笔唯 一,重复则缴费 100 不允许充值。
OrderID 缴费 100 订单号 False 缴费 100 系统订单号
Account 充值号码 False 返回充值手机号
TotalPrice 充值金额 False 返回充值金额
State 订单状态 False 返回订单充值状态, 具体参照:交易结果码 说明
OrderInfo 卡密订单返回卡密列表 True 接收到参数需要先Url解码后在参考 附录4 进行解密
Sign 签名字符串 False MD5(APIID=1504102**91864&Account=13896 193383&OrderID=12345678910&OutID=12345 678&State=10027&TradeType=10&TotalPric e=10000&APIKEY=BA336*******B90568D) 转 大写

注: 合作方成功接收到充值通知之后,请立即回写字符串“success”,标识合作方已接收 到通知。

返回示例:
APIID=150410****1864&OrderID=15041*****1319Account=13896193383&OrderID=12345678 910&OutID=12345678&TradeType=10&TotalPrice=10000&State=10027&Sign=3541F9E0F09B0 ******472E592E4BBD0
返回结果
OrderInfo=
[
{
"CardNumber":null,
"CardPass":"C837T52Exxxxx67xxxxxx",
"CardEffectiveTime":"2018-12-06",
"start_time":"2018-12-06 06:06:00"
}
]
CardNumber = 卡密账号 (多数产品没有,可能为空)
CardPass = 卡密密码
CardEffectiveTime = 兑换失效时间
start_time= 兑换生效时间


18.账户余额接口

此接口返回合作方用户可用余额

请求地址:http://open.jiaofei100.com/Api/GetUserMoney.aspx

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
Sign 签名字符串 False Md5(APIID=150410****64&APIKEY=BA33**** *BFA51F95617B90568D) 转大写

请求示例:

http://open.jiaofei100.com18710/Api/GetUserMoney.aspx?APIID=150520******616&Sign=12AEC73 C******BFB5329207585F1F16

返回示例:
{
"APIID": "150520******616",
"Money": "1000.407"
}

错误返回示例:
{
"Code": "10010",
"Msg": "代理商 ID 不存在"
}

返回参数列表

参数 说明 备注
APIID 合作方用户系统编号
Money 合作方用户账户可用余额

注:如返回错误,请参照交易结果码说明


19.加油卡充值接口

此接口依据用户提供的请求为指定加油卡号码进行缴费充值请求参数说明
请求地址: http://open.jiaofei100.com/Api/PayFuelCard.aspx
请求参数列表

参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
UnitPrice 商品面值 False 单位:厘(固定值 1000)
BuyNum 购买数量 False 例如:充值 10 元(BuyNum=10)
TotalPrice 总交易金额(面值*数量) False 单位:厘(不允许小数点)
OrderID 合作方订单编号 False 2015-06-25
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
Sign 签名字符串 False Md5(APIID=1504102**91864&Account=13896193383&B uyNum=1&CreateTime=20150426230043&isCallBack=0 &OrderID=12345678910&TotalPrice=10000&TradeTyp e=10&UnitPrice=10000&APIKEY=BA336*******B90568 D) 转大写

请求示例:
http://localhost/Api/PayFuelCard.aspx?APIID=**********&TradeType=10&Account=138 96193383&UnitPrice=100000&BuyNum=1&TotalPrice=100000&OrderID=1234567891012112&C reateTime=20150426200630&IsCallBack=0&Sign=68858E4D4D8EF8FE765315C87F48FC2D

1) 请求返回结果.
. {
"Code": "10018",
"Msg": "订单提交成功",
"OrderID": "1234567891012112",
"Account": "13896193383",
"UnitPrice": "100000",
"ReturnOrderID": "1000426063776464",
"TradingID": "10020150426377080643654"
}

返回参数列表:
参数 说明 备注
Code 返回状态码 具体参照:交易结果码备注
Msg 返回状态说明 具体参照:交易结果码备注
OrderID 合作方订单编号 状态等于 10018 时返回
Account 充值号码 状态等于 10018 时返回
UnitPrice 充值金额 状态等于 10018 时返回
ReturnOrderID 缴费 100 订单编号 状态等于 10018 时返回
TradingID 缴费 100 交易流水 状态等于 10018 时返回

20.动态券获取接口

此接口通过上游渠道商下单收到卡券信息后,可通过卡券的token使用该接口换取动态券生成二维码,用户可使用该二维码在油站进行销券。该动态码每五分钟刷新一次。
请求地址: http://open.jiaofei100.com/Api/Getdynamiccode.aspx
请求参数列表

参数 说明 可空
ServiceType 查询类型 False Getdynamiccode
request_id 上游订单号 False 66666666
coupon_id 卡密账号 False 1685939
coupon_token 卡密密码 False b5509571b54882543fc2d27e42d5619e
sign 签名字符串 False Md5(request_id=6666666666666&coupon_id=1685939 &coupon_token=b5509571b54882543fc2d27e42d5619e) 转大写

请求示例:
http://open.jiaofei100.com18710/api/Getdynamiccode.aspx? ServiceType=Getdynamiccode&request_id=6666666666666& coupon_id=1685939&coupon_token=b5509571b54882543fc2d27e42d5619e& sign=5F63D362AAC0B7DC8AB399AFB068C380

1) 请求返回结果.
{ "status":"SUCCESS", "failed_code":"10018", "failed_msg":"请求成功", "request_id":"6666666666666", "coupon_id":1685939, "coupon_qrcode":"846465193933683261fb679612555aab60", "coupon_overtime":300 }

返回参数列表:
参数 说明 备注
status 返回状态码 具体参照:交易结果码备注
failed_code 返回状态说明 具体参照:交易结果码备注
failed_msg 错误消息 错误消息
request_id 下游渠道商订单编号 状态等于 10018 时返回
coupon_id 券编号,编程使用 状态等于 10018 时返回
coupon_code 动态券编号 状态等于 10018 时返回
coupon_overtime 动态码过期剩余秒数 状态等于 10018 时返回
coupon_qrcode 动态券二维码原文 状态等于 10018 时返回

21.消券回调请求

客户通过加油站终端销券成功后系统向下游渠道商发送销券请求,下游渠道商收到请求后应修改券的状态为已使用。
异步通知返回参数列表

参数 说明 可空
OrderInfo 系统订单号 False 20181212
OutID 下游游订单号 False 20181212
Coupon_id 卡密账号 False 1685939
State 状态 False 10027

注: 合作方成功接收到充值通知之后,请立即回写字符串“success”,标识合作方已接收 到通知。 返回示例:
OrderInfo=20181212&OutID=20181212&Coupon_id=1685939&State=10027



22. 短信/群发短信充值接口


请求参数说明

请求地址: http://open.jiaofei100.com/Api/PaySendmessage.aspx

请求参数列表



参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
Account 接送短信号 False 接送短信号(短信接收手机号码集合,用英文逗号分开,如 "13810001000,13810011001",最多一次发送200个。)
ProductCode 商品编号 False 由缴费 100 平台提供(单条短信用36 批量发送用37
BuyNum 购买数量 False 只能是1
Smsdata 数据 False 后台绑定签名 发送内容
http://api.jiaofei100.com/SMS/smsTemplate.html
您的验证码是{1},请于{2}分钟内正确输入"模板id,123,6666"
您的验证码是123,请于6666分钟内正确输入
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
ServiceType 类型 False Sendmessage
IsCallBack 开启异步通知 False 开启异步通知( 1 开启异步通知, 0 不开启)
Sign 签名字符串 False Md5(APIID=1504102**91864&Account=13896193383&BuyNum=1&Smsdata=模板id,123,6666 &CreateTime=20150426230043&IsCallBack=0&OrderID=123456789 10&ProductCode=60007088&APIKEY=BA336*******B90568D)
转大写

请求示例:

http://localhost/Api/PaySendmessage.aspx?APIID=1504102**91864&Account=13896193383&BuyNum=1&Smsdata=模板id,123,6666 &CreateTime=20150426230043&IsCallBack=0&OrderID=12345678910&ProductCode=60007088& Sign=68858E4D4D8EF8FE765315C87F48FC2D

请求返回示例请参阅话费充值接口.


备注:接口返回成功不代表接收成功,接口提交成功计费,具体接收状态只能由运营商查询;运营商限制同1个号码同1个签名的内容1分钟内只能接收1条,10分钟3条,1小时内4条,一天20条,否则可能会被运营商屏蔽,短信api接口本身不限制发送频率,具体发送频率需要用户自行设置,只限国内手机号。请务必添加图片验证码等防恶意攻击的机制,以防短信轰炸,营销内容最后加回T退订,营销短信发送时间为:8:30至21:30,字数限制:短信内容(包含签名)小于等于70个字符为计费1条。超过70个字符为长短信,按每67个字符计费1条,中英文标点空格都算作一个字符,最多300字符。


请求示例:

http://localhost/Api/PayFixPhone.aspx?APIID=**********&TradeType=10&Account=138 96193383&UnitPrice=100000&BuyNum=1&TotalPrice=100000&OrderID=1234567891012112&C reateTime=20150426200630&IsCallBack=0&Operator=1&Sign=68858E4D4D8EF8FE765315C87 F48FC2D

请求返回示例请参阅话费充值接口.


23. 组合商品充值接口


请求参数说明

请求地址: http://open.jiaofei100.com/Api/PayCombination.aspx

请求参数列表



参数 说明 可空
APIID 合作方用户系统编号 False 由缴费 100 平台提供
TradeType 商品类型 False 请参数附录商品类型
Account 充值号码 False 充值号码
UnitPrice 该商品面值 False 单位:厘(不允许小数点)(Q 币固定值 1000)
BuyNum 购买数量 False
TotalPrice 总交易金额(面值*数量) False 单位:厘(不允许小数点)
OrderID 合作方订单编号 False 由合作方生成该订单号,且保证每笔唯一,重复则不允许充值。(请勿在几毫秒内重复请求)
CreateTime 合作方交易时间 False yyyyMMddHHmmss(只接受 3 分钟以内的订单请求)
IsCallBack 开启异步通知 False 0
GoodsID 商品 ID False 23071900
ClientIP IP 地址 False 用户充值真实 IP 地址
Sign 签名字符串 False Md5(APIID=1504102**91864&Account=13896193383& BuyNum=1&CreateTime=201504 26230043&GoodsID=23071900&isCallBack=0&OrderID= 12345678910&TotalPrice=10000&TradeType=23& UnitPrice=10000&APIKEY=BA336*******B90568D) 转大写

请求返回示例请参阅话费充值接口.


24. 查询实时油站信息及相应油品价格

此接口返回某一订单的处理结果。

请求参数说明
请求地址:http://open.jiaofei100.com/Api/GetOrderInfo.aspx
请求参数列表

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
Station_id 加油ID False 8745asgashash
ServiceType 查询类型 False ServiceType=Getquery
Sign 签名字符串 False Md5(APIID=150410****64&Station_id=1504171 9891319&APIKEY=BA33*****BFA51F95617B90 568D) 转大写

请求示例:

http://open.jiaofei100.com/Api/GetOrderInfo.aspx?APIID=1504102****864&Station_id=1504171989 1319&Sign=3541F9E0F09B0D4A1****2E592E4BBD0

1. 请求返回结果

{"Code":"10018","Data":[ {"M_id":"3b011280305506b77673b16efe6fbff6", "M_pricejson":"
[ {\"oil_level\":\"国三\",\"oil_type\":\"-20#\",\"oil_name\":\"柴油\",\"price\":\"5.50\",\"starttime\":\"2019-12-04 00:00:00\",\"endtime\":\"2099-12-31 00:00:00\"},
{\"oil_level\":\"国三\",\"oil_type\":\"92#\",\"oil_name\":\"汽油\",\"price\":\"6.33\",\"starttime\":\"2019-12-04 00:00:00\",\"endtime\":\"2099-12-31 00:00:00\"},
{\"oil_level\":\"\",\"oil_type\":\"\",\"oil_name\":\"液化天然气\",\"price\":\"7.00\",\"starttime\":\"2019-12-04 00:00:00\",\"endtime\":\"2099-12-31 00:00:00\"}]"}] }


25. 加油订单状态异步通知验证接口

该接口是以 post 方式将订单状态通知合作方绑定的回调地址上
通过TradeType来判断处理业务逻辑

异步通知返回参数列表

参数 说明 可否空值 备注
APIID 合作方用户系统编号 False 由缴费 100 提供
Data 二维码解析字符串 False 返回加密二维码字符串
TradeType 商品类型 False paycode
Timestamp 时间戳 False 请求时间,格式为 yyyy-mm-dd hh:mm:ss,例如:2010- 02-08 20:23:30,以字符串类型传输
SysOrderID 本系统订单号 False 本系统订单号
Sign 签名字符串 False MD5(APIID+Data+SysOrderID+Timestamp+APIKEY) 转 大写

注: 合作方成功接收到充值通知之后,接口调用状态码,0:代表成功;非 0:有错误,标识合作方已接收 到通知。

返回示例:
APIID=*****&Data=lf_100000_aajsdlkgjaslkdgj==&TradeType=paycode&Timestamp=-********&SysOrderID=********&Sign=3541F9E0F09B0 ******472E592E4BBD0

四、附录

1.交易状态码附录

对应错误代码 对应汉字规范(失败原因) 备注
10007 参数错误
10008 订单超时 不能直接作失败处理
10009 参数校验错误
10010 代理商 ID 不存在
10011 订单号长度大于 36
10012 代理商状态错误
10013 账户余额不足
10014 IP 地址验证失败
10015 充值号码有误
10016 暂不支持该号码
10017 禁止采购该商品
10018 订单提交成功 不能直接作失败处理
10020 订单提交失败
10021 未知错误
10022 订单号重复 不能直接作失败处理
10024 暂不支持该面值
10025 订单处理中 查询订单状态时返回
10026 交易失败 查询订单状态时返回
10027 交易成功 查询订单状态时返回
10029 订单不存在 不能直接作失败处理

2.商品类型附录

商品编码 解释
10 话费直充
11 话费慢充
131/132 流量全国包(新资费)/流量省内包(新资费)
(提交日包:在最后增加日包天数 如:全国1日包 1311 省内1日包 1321)
141/142 流量全国包(旧资费)/流量省内包(旧资费)
14 水费代缴
15 电费代缴
16 燃气费代缴
17 有线电视费代缴
18 固话充值
19 宽带充值
23 游戏充值
22 机票查询/机票代购/机票保险代购
21 汽车票查询/汽车票代购
20 火车票查询/火车票代购
45 卡密/卡券
25 交通罚款代缴
32 水费查询
33 电费查询
34 燃气费查询
35 有线电视费查询
44 交通罚款查询
48 中石化加油卡充值
49 中石油加油卡充值
36 普通短信发送
37 营销短信发送

3.获取水电气商品信息附录


1、获取水电气查询商品地址: http://localhost/Api/GetLifeSelectInfo.aspx

2、获取水电气提交商品地址: http://localhost/Api/GetLifeSubInfo.aspx


4.卡密解密


卡密是采用DES加密方式
在线测试工具:http://tool.chacuo.net/cryptdes

解密密钥:合作方订单编号前8位字符,如果合作方订单编号不足8位请在订单编号后面用0补满8位
偏量:固定00000000
例:
合作方订单编号:3213232132119845
{"CardNumber":"s1fr+FhNzh4p/sJuFQhDLA==","CardPass":"ioG8y2rz1drk6a2DRPqbIQ=="}
解密后:
{"CardNumber":"无卡号","CardPass":"294988736108"}