翼支付网关商户技术接口规范
Version2.04
修订历史记录
2012年5月
目录
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)
1.1.10 接口参数 (52)
1.1.11 接口响应 (53)
1.1.12 响应示例 (53)
1.1.13 接口说明 (53)
1.1.14 测试用例 (54)
3.5.3分账退款 (55)
1.1.15 接口描述 (55)
1.1.16 接口地址 (55)
1.1.17 接口参数 (55)
1.1.18 接口响应 (56)
1.1.19 响应示例 (56)
1.1.20 接口说明 (57)
1.1.21 测试用例 (57)
2. 附录 (58)
2.1 参数类型说明 (58)
2.2 符号约定 (59)
2.3 响应码说明 (59)
3.6查询订单 (67)
3.6.1 查询订单接口 (67)
4. 开发提示 (73)
4.1 商户对支付结果的处理 (73)
4.2 MD5算法样例（JAVA） (73)
4.3 防钓鱼说明 (74)
4.4 防钓鱼验证方法 (75)
4.5 3DES算法样例 (75)
4.6 WebService消息格式 (76)
5.附录 (77)
5.1 参数类型说明 (77)
5.2 符号约定 (77)
5.3 响应码说明 (78)
5.4 翼支付网关平台个人网银银行编码表 (86)
5.5 翼支付网关平台快捷银行编码表 (89)
5.5 翼支付网关平台第三方账户银行编码表 (90)
5.6 翼支付网关平台卡类银行编码表 (91)
5.5 翼支付网关平台个人信用卡分期支付银行编码表 (91)
5.7 翼支付网关平台电信账单支付编码表 (91)
5.8翼支付电信账单支付验证码说明 (91)
5.8 翼支付网关平台企业网银银行编码表 (92)
5.10 业务填写说明 (94)
1. 文档说明
1.1 文档目标
本文档的目的是为翼支付网关平台定义一个标准接口规范，以帮助各省电信及合作商户技术人员接入翼支付网关平台，并快速掌握翼支付网关平台支付业务的相关功能，为业务开展提供支付服务。
1.2 阅读对象
对翼支付网关平台支付业务存在需求的公司、机构及合作商户的网上应用开发人员、维护人员和业务管理人员。
1.3 相关约定
商户：指已注册成为翼支付网关用户、并使用翼支付网关产品实现其收付费功能需求、为其用户提供各类产品或者相关服务的个人。
用户：指在商户网站等系统购物的个人。
购物：指用户在商户网站购买相关产品或服务。
编码格式：所有报文交互的编码均为UTF-8
1.4 业务及技术支持
如果您有任何业务及技术上的疑问，可联系天翼电子商务有限公司技术人员。
2. 业务描述
2.1 WEB/WAP支付说明及流程
WEB/WAP支付方式是指利用网银账户，通过互联网WEB/WAP网页操作完成支付过程的方式。此种方式下，客户利用PC终端，通过登陆翼支付网关或合作方网站，进行商品或服务选购，生成并确认订单信息，根据本人使用借记卡或贷记卡付款的要求，选择相应银行通过银行网银界面实现支付的功能。
用户向交易网站购物时，需要通过一定方式向商户支付相关费用。商户网站系统如果集成翼支付网关网上支付功能，则可以让用户安全、方便、快捷地向商户支付选购商品及服务款项，并且商户也可以很容易了解到款项的到帐情况及用户购买的产品或服务。
整体流程如下：
用户在商户交易网站选择产品或服务，在下订单支付完成后，商户网站会将该订单号及对应订单金额等相关信息提交到翼支付网关，然后跳转到翼支付网关页面进行支付。当支付完成后，翼支付网关将支付结果返回商户，并且根据商户指定的地址跳转到商户指定页面。商户系统后台接收到支付结果之后，对数据库进行相应更新，然后在显示给用户的页面中作出相应提示。
2.2 IVR支付说明及流程
业务描述（以电话订票业务为例）
客户拨打订票电话进来，由坐席人员接听并询问客户对所订航班的要求后，查询合适航班告知客户，如客户确定出票则询问客户是否可用信用卡支付，如确定支付则坐席将电话转入IVR语音提示客户输入信用卡相关信息即完成订票支付，再由后台执行出票，出票成功短信通知客户。
从业务描述上看，电话订票支付是在号百订票流程环节中增加一个支付的流程，因此，对原订票业务流程没有影响，只是给客户增加一个支付手段的选择。
在此业务中有三个节点：一是坐席人员将电话转IVR后，坐席电话即挂断；二是IVR语音提示用户完整键入卡号、有效期及CVV2码后IVR语音挂断；三是需要中台人员操作出票、退款及二次电话与客户沟通等内容。
(一)电话支付订票结果的各种情况处理( 支付状态由翼支付网关支付平台给出，
出票状态由合作方系统给出)
1、支付成功、出票成功
短信通知客户行程信息。
2、支付成功、出票失败
中台（系统）发起退款处理，中台电话联系客户说明情况，询问重新订票或放弃订票。
3、支付失败
中台人员根据系统返回状态，电话联系客户说明支付失败的原因，询问用户重新支付或放弃订票。
4、支付中断
客户支付过程中止（IVR中挂断电话），由中台人员一定时间后，电话联系用户重新支付或放弃订票。
5、支付成功、出票成功但客户主动退票
由坐席处理并经系统返回退票状态及金额，由中台（系统）发起退款申请。
(二)标准语音服务用语：（仅供参考）
CSR：（现付客人预订完成后）XX先生/小姐，目前我们支持语音支付方式，只要您拥有xxx这几家银行的信用卡，就可以进行语音支付。
客户：好，我选语音支付
CSR：请问您使用哪一家银行的信用卡来支付？
客户：我选择XX。
CSR：稍后会为您转入语音支付系统，请您根据系统提示音操作，请正确输入您的信用卡卡号、有效期和背面3位数字(CVV2)的验证码。如信息完整无误并且支付成功，我们会及时为您出票并且在出票后发送短信通知您。
客户：好的。
CSR：如果没有其他问题，现在就将为您转入自动语音。
客户：好
CSR：感谢您使用号码百事通商旅服务,再见！
(三)系统提示音:
系统提示：请输入您的信用卡卡号，按#号结束
客户输入：卡号键入
系统提示：您的信用卡卡号是……，确认请按1，重新输入请按2
客户输入：1（若用户输入2，重新提示用户输入）
系统提示：请输入您的信用卡有效期，有效期为四位数字（两位月份两位年份），按#号结束
客户输入：有效期键入
系统提示：您的信用卡有效期是……，确认请按1，重新输入请按2
客户输入：1（若用户输入2，重新提示用户输入；）
系统提示：请输入您的信用卡背后3位CVV2验证码，按#号结束
客户输入：信用卡CVV2验证码
系统提示：您的信用卡CVV2验证码是……，确认请按1，重新输入请按
客户输入：1（若用户输入2，重新提示用户输入）
系统提示：输入已完成，我们将及时验证您的卡片信息及余额并尽快为您出票，稍侯短信通知您，如果您有任何问题请随时和我们联系。感谢您使用号码百事通，再见！（以下借记卡流程）
系统提示：请输入您的借记卡卡号，按#号结束
客户输入：卡号键入
系统提示：您的借记卡卡号是……，确认请按1，重新输入请按2
客户输入：1（若用户输入2，重新提示用户输入）
系统提示：输入已完成，我们将及时验证您的卡片信息及余额并尽快为您出票，稍侯短信通知您，如果您有任何问题请随时和我们联系。感谢您使用号码百事通，再见！
(四)问题解答：
1．什么是信用卡有效期？
答：信用卡有效期是指在信用卡正面所标注的“VALID THRU”有效截止日期，一般格式为“月份/年”，月份在前，年份在后，输入时请连续输入四位数字即可。
2．什么是CVV2验证码？
答：CVV2验证码：信用卡背面，后3位数字，以用作安全认证的数字。
3．支付是否有要收取服务费？
答：我们提供的语音支付方式不会收取除用户选取商品或服务费用以外的任何费用。
4．如果我操作失误，该怎么办？
答：如果您操作失误，可以根据系统提示重新进行输入。或者，您也可以给我们来电，提供相应的信息后，我们会及时为您处理。
2.3翼支付电信账单支付说明及流程
中国电信翼支付账单支付业务（以下简称账单支付）是指中国电信用户在天翼电子商务有限公司的合作商户或翼支付门户购买商品或服务后，由翼支付电信账单对所购买的商品或服务进行消费记录，最后由用户按照账单统一结付的业务。
2.4借记卡一线通业务流程说明
用户向商户发起业务请求（语音通道），商户平台生成订单并发送至翼支付平台，翼支付平台从银联语音系统中获取支付线路预约码（如001）并返回给商户，商户以短号加位的方式呼叫银联语音支付平台（0731*******+001）语音连接建立后，将用户的线路（支付接口中tmNum）和银联语音支付平台的线路并到一起即可（语音通道）。然后由银联语音支付平台进行敏感信息的收集及后续支付（语音通道）。在语音线路中播报结果，同时翼支付网关通过商户提供的支付结果返回接口返回支付结果到商户平台。（语音通道和数据通道）。
3. 收银台
3.1 WEB支付
3.1.1 Web收银台
1）接口描述
2）接口地址
https://https://www.doczj.com/doc/1d12805483.html,/payWeb.do
3）接口定义
4）接口说明
1.商户要保证订单号的唯一性。
2.订单请求流水号不能重复,建议以日期时间（yyyyMMDDhhmmss格式）加
一固定长度（不小于4位）流水号组成，如：20061012132425 + 0001或20061012132425 + 00001等。
3.在商户提交订单的页面上，提交按钮应该是点击一次后，马上不可用，防止
用户多次提交。
4.接口方式采用表单方式，商户将以上信息包含在表单中，直接SUBMIT 到
翼支付网关翼支付网关平台url上。
5.MAC校验，保证了交易信息到翼支付网关平台的完整性，参与MAC运算
的字符及其顺序如下：
MERCHANTID=123456789&ORDERSEQ=20060314000001&ORDER DATE=20060314&ORDERAMOUNT=10000&CLIENTIP=127.0.0.1&KE Y=344C4FB521F5A52EA28FB7FC79AEA889478D4343E4548C02
将上述固定顺序组织的字符串，参数名均为大写，使用标准md5 32位算法进行加密，就是校验域MAC的值，并在提交订单时，将MAC值和订单信息一起提交到翼支付网关翼支付网关平台。
6.分账明细说明: DIVDETAILS, 对于支付：如果商户仅仅实现支付功能，无分
帐需求，该域为空；否则填写的格式为“商户身份标识:金额”，如果多笔分帐时使用”|”分割，其中商户身份标识填写商户申请时关联的结算商户身份标识，金额单位为分。
例如商户0018888888订单总金额为1000 分，分账明细为：
0018888888:800|0018888887:100|0018888886:100
商户0018888888本身得到这笔交易中的800分
商户0018888887分得交易的100分
商户0018888886分得交易的100分
所有参加分账的商户分账的分账金额相加必须和交易总金额一致,且分账单笔订单商户身份标识只能出现一次，参与分账的商户，分账金额不能为0。
7.CLIENTIP说明：
填写该参数：
1．网关平台会校验该参数与用户访问翼支付网关时候的IP是否一致，如不一致，则认为异常IP。
2．需要在MAC原串中加入CLIENTIP和KEY两个参数来校验，详情见接口说明4。