缴费 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 | 返回状态码 | 具体参照：交易结果码备注 | 字符串 5 |
| Msg | 返回状态说明 | 具体参照：交易结果码备注 | 字符串 100 |
| OrderID | 合作方订单编号 | 状态等于 10018 时返回 | 字符串 35 |
| Account | 充值号码 | 状态等于 10018 时返回 | 字符串 35 |
| UnitPrice | 充值金额 | 状态等于 10018 时返回 | int 类型 |
| ReturnOrderID | 缴费 100 订单编号 | 状态等于 10018 时返回 | 字符串 35 |
| TradingID | 缴费 100 交易流水 | 状态等于 10018 时返回 | 字符串 35 |
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) 转大写 |
旅游产品附加参数
续接口文档| 参数 | 说明 | 可空 | |
| Auid | 第三方用户id | False | 由对接平台提供 |
| UserName | 用户名 | False | 由对接平台提供 |
| CardID | 身份证 | False | 由对接平台提供 |
| Phone | 手机号 | False | 由对接平台提供 |
请求示例:
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.游戏/娱乐请求返回示例请参阅话费充值接口
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 不开启) |
| CallBack | 自定义回调地址 | true | 不参与签名 |
| 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
请求返回示:
{
"Code":"10018",
"Msg":"订单提交成功",
"OrderID":"2020040715",
"Account":26****,
"UnitPrice":20000,
"ReturnOrderID":60672247710407152653,
"TradingID":"60672247710407152653
"}
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,
"SalesMoney": "99700",
"Msg": "交易成功"
"OutOrderNo":"438425338168022871"
"VacherType":"0"
}
2. 卡密订单请求返回结果
{
"Code": 10027,
"OrderID": 1000417004846484,
"OutID": 15041719891319,
"Msg": "交易成功"
"OrderInfo": [{"CardNumber":"s1fr+FhNzh4p/sJuFQhDLA==","CardPass":"ioG8y2rz1drk6a2DRPqbIQ=="}]
}
请求返回参数列表
| 参数 | 说明 | 备注 | 长度 |
| Code | 响应码 | 具体参照：交易结果码说明） | 字符串 5 |
| Msg | 响应码说明 | 具体参照：交易结果码说明 | 字符串 100 |
| OrderID | 缴费 100 订单号 | 缴费 100 订单号 | 字符串 35 |
| OutID | 合作方订单编号 | 请求的“合作方订单编号” | 字符串 35 |
| SalesMoney | 扣费价格 | 扣费价格 | int |
| OrderInfo | 卡密列表 | CardNumber 卡号（不一定会有） CardPass 卡密 可能是 链接 或者 字符串 |
字符串 （max） |
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 | 返回充值手机号 |
| SalesMoney | 扣款金额 | False | 返回扣款金额 |
| TotalPrice | 充值金额 | False | 返回充值金额 |
| State | 订单状态 | False | 返回订单充值状态, 具体参照：交易结果码 说明 |
| OrderInfo | 卡密订单返回卡密列表 | True | 接收到参数需要先Url解码 |
| Sign | 签名字符串 | False | MD5(APIID=1504102**91864&Account=13896 193383&OrderID=12345678910&OutID=12345 678&State=10027&TradeType=10&TotalPric e=10000&APIKEY=BA336*******B90568D) 转 大写 |
| OrderInfo | 卡密订单返回卡密列表 | True | 接收到参数需要先Url解码 |
| OutOrderNo | 流水号 | true | 不参与加密 |
注: 合作方成功接收到充值通知之后，请立即回写字符串“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 | 例如:(BuyNum=1) |
| TotalPrice | 总交易金额(面值*数量) | False | 单位：厘(不允许小数点) |
| OrderID | 合作方订单编号 | False | 2015-06-25 |
| CreateTime | 合作方交易时间 | False | yyyyMMddHHmmss(只接受 3 分钟以内的订单请求) |
| IsCallBack | 开启异步通知 | False | 开启异步通知( 1 开启异步通知, 0 不开启) |
| UserName | 用户姓名 | True | 用户姓名(可空，不参与加密) |
| CardID | 用户身份证 | True | 用户身份证(可空，不参与加密) |
| Phone | 用户手机号 | True | 用户手机号(可空，不参与加密) |
| 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 时返回 |
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
26. 加油卡核销接口（重庆中石化卡券接口）（预留未开启）
该接口是以 post 方式将订单状态通知合作方绑定的回调地址上
通过TradeType来判断处理业务逻辑
异步通知返回参数列表
| 参数 | 说明 | 可否空值 | 备注 |
| APIID | 合作方用户系统编号 | False | 由缴费 100 提供 |
| CardNumber | 卡号 | False | 卡号 |
| Cardexchangetime | 核销使用时间 | False | 请求时间，格式为 yyyy-mm-dd hh:mm:ss，例如：2010- 02-08 20:23:30，以字符串类型传输 |
| TradeType | 商品类型 | False | CallBackCard |
| Branchoffice | 分公司 | False | 分公司 |
| Carddot | 网点 | False | 网点 |
| Sign | 签名字符串 | False | MD5(APIID=&CardNumber=&Cardexchangetime=&APIKEY=) 转 大写 |
注: 合作方成功接收到充值通知之后，请立即回写字符串“success”,标识合作方已接收 到通知。
返回示例:
APIID=20040******4780&CardNumber=200325***385&Branchoffice=中国石化销售有限公司重庆三峡分公司&Carddot=中国石油化工股份有限公司重庆三峡石油分公司云阳滨江路加油站&Cardexchangetime=2020-04-04 19:49:18&TradeType=CallBackCard&Sign=B98EC63DF5A21625ECC1D163D65EC304
27. 获取优惠券状态（四川中石油）
此接口返回某一加油券的状态结果。
请求参数说明
请求地址:http://open.jiaofei100.com/Api/GetOrderInfo.aspx
请求参数列表
| 参数 | 说明 | 可否空值 | 备注 |
| APIID | 合作方用户系统编号 | False | 由缴费 100 提供 |
| CouponCode | 卡券号 | False | 提交订单后 异步查询的卡券号 |
| ServiceType | 查询类型 | False | ServiceType=getMerchantCouponState |
| Sign | 签名字符串 | False | Md5(APIID=150410****64&CouponCode=1504171 9891319&APIKEY=BA33*****BFA51F95617B90 568D) 转大写 |
请求示例:
open.jiaofei100.com/Api/GetOrderInfo.aspx?ServiceType=getMerchantCouponState&APIID=20021104593432&CouponCode=76071619188656465&Sign=666666666666666666666
1. 请求返回结果
{ "code": 200, "data": { "code": " success", "msg":“正常"， "state": 1, "sign": " d609df43d5e58fd8e179a9133 bo58b831e0occcf" }， "msg":“请求成功 }
请求返回参数列表
| 参数 | 说明 | 备注 | 长度 |
| Code | 返回状态 | 具体参照：交易结果码说明） | 返回状态 |
| state | 状态 | 具体参照：交易结果码说明 | 0:无效 1:正常 2:过期 3:已使用 4:作废 |
四、附录
1．交易状态码附录
| 对应错误代码 | 对应汉字规范(失败原因) | 备注 |
| 10007 | 参数错误 | 失败处理 |
| 10008 | 订单超时 | 不能直接作失败处理 |
| 10009 | 参数校验错误 | 人工确认原因 |
| 10010 | 代理商 ID 不存在 | 失败处理 |
| 10011 | 订单号长度大于 36 | 失败处理 |
| 10012 | 代理商状态错误 | 失败处理 |
| 10013 | 账户余额不足 | 失败处理 |
| 10014 | IP 地址验证失败 | 失败处理 |
| 10015 | 充值号码有误 | 人工确认原因 |
| 10016 | 暂不支持该号码 | 失败处理 |
| 10017 | 禁止采购该商品 | 作失败处理 |
| 10018 | 订单提交成功 | 不能直接作失败处理 |
| 10020 | 订单提交失败 | 人工确认原因 |
| 10021 | 未知错误 | 人工确认原因 |
| 10022 | 订单号重复 | 不能直接作失败处理 |
| 10024 | 暂不支持该面值 | 失败处理 |
| 10025 | 订单处理中 | 查询订单状态时返回 |
| 10026 | 交易失败 | 查询订单状态时返回 |
| 10027 | 交易成功 | 查询订单状态时返回 |
| 10029 | 订单不存在 | 不能直接作失败处理 |
| 10035 | 限制5分钟内同一时间和同一个金额 | 失败处理 |
| 10036 | 系统维护 | 失败处理 |
| 10037 | 活动未开始 | 失败处理 |
| 10038 | 活动已经结束 | 失败处理 |
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