翼支付网关商户技术接口规范
Version2.04
修订历史记录
日期 2012.05.20 2012.11.01 2012.11.10 2012.11.14 2012.11.15 版本 1.0 1.1 1.2 1.3 1.4 初稿 增加预付卡查询 增加工行分期 增加统一收银台 统一收银台修改充值状态，0002改为0009 2012.11.23 2012.12.31 2013.2.16 1.5 1.6 1.7 增加3G流量卡发票信息 增加中行分期 更新支付结果通知接口为交易结果通知接口 2013.3.19 2013.3.21 1.8 1.81 WEB支付增加订单关闭时间参数 个人银行编码增加快丁人为 夏琨 夏琨 更新统一收银台接口 丁人为 夏琨 说明 丁人为 梁志壮 夏琨 夏琨 魏巍 修订 2012年5月
中国电信天翼电子商务有限公司
捷 2013.4.8 1.82 把天翼预付卡和帐单支付重新整合至文档中 2013.5.6 2013.5.7 2013.5.10 2013.11.21 2013.11.22 2013.12.13 1.83 1.84 1.85 2.0 2.01 2.02 增加预付卡密码修改接口 增加翼充卡卡激活接口 WEB支付B2B类交易，描述信息限制 新网关平台支付地址及参数长度变更 更改分账金额不能为0 邮政储蓄银行BANKID由PSBC还原为POST 2015.04.23 2015.06.16 2015.12.11 2.03 2.04 增加快捷银行编码 王蕙 添加退款响应码说明 王蕙 时间戳字段。IP、产品信息字段必填 2016.01.18 2.0.6 添加获取ClientIP示黄俊 例，完善MAC组装描述 肖小明 肖小明 肖小明 肖小明 杨星 杨星 梁志壮 2.0.5 web收银台接口添加黄俊
翼支付网关平台开发小组
目录
1. 文档说明 ............................................................................................................................................ 7
1.1 文档目标 ........................................................................................................................... 7 1.2 阅读对象 ........................................................................................................................... 7 1.3 相关约定 ........................................................................................................................... 7 1.4 业务及技术支持 ............................................................................................................... 7
2. 业务描述 ............................................................................................................................................ 8
2.1 WEB/WAP支付说明及流程 ........................................................................................... 8 2.2 IVR支付说明及流程 ...................................................................................................... 10 业务描述（以电话订票业务为例） ..................................................................................... 10 2.3翼支付电信账单支付说明及流程 .................................................................................. 14 2.4借记卡一线通业务流程说明 .......................................................................................... 15
3. 收银台 .............................................................................................................................................. 16
3.1 WEB支付 ........................................................................................................................ 16
3.1.1 Web收银台 ......................................................................................................... 16 3.1.2 时间戳生成接口 .................................................................................................. 21 3.1.3 Web收银台-后台通知 ....................................................................................... 23 3.2 IVR支付 .......................................................................................................................... 27
3.2.1 支付请求接口 ...................................................................................................... 27
翼支付网关平台开发小组
3.2.2支付结果通知接口 ............................................................................................... 32 3.3翼支付电信账单支付(正常扣费场景) ............................................................................ 34 3.4 天翼预付卡 ..................................................................................................................... 34
3.4.1 扣费请求接口(后台) ........................................................................................... 34 3.4.2 余额查询接口 ...................................................................................................... 38 3.4.3 有密卡信息查询接口 .......................................................................................... 40 3.4.4 积点卡密码修改接口 .......................................................................................... 43 3.5退款 .................................................................................................. 错误！未定义书签。 3.5.1普通退款 ........................................................................................................................ 46
1.1.1 接口描述 .............................................................................................................. 46 1.1.2接口地址 ............................................................................................................... 46 1.1.2 接口参数 .............................................................................................................. 46 1.1.3 接口响应 .............................................................................................................. 48 1.1.4 请求响应示例 ...................................................................................................... 48 1.1.5 接口说明 .............................................................................................................. 48 1.1.6 测试用例 .............................................................................................................. 49 1.1.7 错误码 .................................................................................................................. 51 3.5.2退款 ................................................................................................................................ 52
1.1.8 接口描述 .............................................................................................................. 52 1.1.9 接口地址 .............................................................................................................. 52
翼支付网关平台开发小组
