天宏一卡通支付接口说明文档V.doc

天宏一卡通支付接口说明文档V 作者： 日期：9 个人收集整理 勿做商业用途1 引言1.1 编写目的文档历史修订日期修订内容修订版本修订人2010-7-创立.0.1vzhe210-14修改支付金额为可选参数。1.2lvzh本文档说明了如何通过网关系统和天宏公司一卡通游戏充值系统进展对接。2 协议概述2.1 协议列表协议名称说明销售协议充值一卡通的协议2.2 协议的交互逻辑商家华彤销售请求销售结果3 销售协议3.1 协议说明协议采用TT协议,经销商将请求报文pst或get到天宏的一卡通充值的8端口：正式地址:支付地址:ttp:/port.279comgaewa/Cad_ayGte.do单笔查询地址:tp:/port279com/gaay/ECar_QueryateSngle.do批量查询地址:htp：/ort.2799.om/aeway/ECard_QueryGatedourl例如:tt：/ort2399.cmgy/Card_Pyate.do?usename=*&producid=*cknm*kahao1*ima1=* bum=*&rdN*adin=*&returnUrl=*&mdtosel=*htp:/prt2739.om/gatway/ECad_Queryinl.do?usrName=*&orm=*&md5olf*ht:/port.27399 /gatewCardurGatd?usrame*&ructID=*&Cardm=* &buNum=*&orderNum=*trtDte=*&edDae=*&ip=*&ageoun=*ageInex=*&dtoself*测试地址：支付地址：hp:/2222.59.248ECardPaygatway /CrdPayte.o单笔查询地址: :/.22.5928/ECadPaygaeway / ECrd_QeyGate_Sile.do批量查询地址:ht:/2.222.9.248/ECaraew/ ECard_Qeryed3.1.1 支付接口调用说明支付接口参数说明:输入参数数据类型说明是否必填usrnavachr(2)商户名proctd产品类型，请和公司申请YcknumInt一卡通张数Ykaha1mima1kahao2mia2vchr(50)一卡通卡号密码(最多支持5张一卡通组合充值支付YbunumInt购置数量(按元计算,1=元)orderNumarchar(50)商户订单号Yddtionvarca50)附加信息retunUrlvrchar(2)回调地址m5toselfInt 数字签名Y调用说明：1. 所有字段中不能包含 “& 和 “ 2. sernme: 商户名,例如 huaon3. producti:表示产品类型，真实产品I请和天宏公司索要。4. cknm：本次充值所提交的一卡通数量，请注意和aao、mim字段要保持一致。5. ahaomima:所提交的一卡通卡号密码,形式为kaao1、hao2.mia1、mima,，其中密码为M(3位)加密后的结果卡号密码提交前请务必请转换成大写。6. buyum：充值数量 表示充值1面值卡的张数,取值范围1,00。可选参数，不传时默认全额支付支付所传一卡通的所有余额。7. odem:商户订单号8. ddi:附加信息9. turrl： 回调地址,用于异步调用时的回调。10. md5toself为按顺序对交易信息的MD5加密签名的32位字符串：md5toslf =d5(username=*ructd*&cnm=*khao1*&ima1=*&buynm* orderNm=*&addtio=*&eurnUr=* |enc_k) 。l 可选参数如果不传的话,不能包含在加密串中。l 其中nc_key为双方约定的ky,用于验证交易的合法性，请和天宏公司申请。3.1.2 支付接口返回结果说明返回结果是l格式数据字符串 1 成功！ mone0充值结果代码结果说明0未知异常1成功-参数验证异常-一卡通验证异常-账户验证异常-支付类型验证异常-5订单验证异常-6支付操作异常3.1.3 查询接口调用说明1. 单笔查询接口参数说明：输入参数数据类型说明默认值是否必填userNmeaar(20)商户名Yoreuvachar(50)商户订单号Ymd5tofInt 数字签名Y调用说明：1. 所有字段中不能包含 “&和 “2. usrNme: 商户名,例如 hatng3. orrNu: 商户订单号4. md5osel为按顺序对交易信息的D5加密签名的32位字符串：md5el =md5(userName=*&ordum=*|enckey。l 其中ec_key为双方约定的ke,用于验证交易的合法性，请和天宏公司申请。2. 批量查询接口参数说明:输入参数数据类型说明默认值是否必填usramevarcar(20)商户名YprodcIDnt产品类型,请和公司申请0eCardNuvrcar(5一卡通卡号bumInt购置数量按元计算,1=1元0orderNuvarcar(0)商户订单号strtatevarhr0)开场时间ndatevarchar(0)截止时间ipvacr(50)支付ip地址pageCuntt每页数量00(暂定)pgeIndexi页码m5toselIn 数字签名Y调用说明:5. 所有字段中不能包含 “& 和 “6. uerName:商户名，例如 uatng7. productD:表示产品类型，真实产品ID请和天宏公司索要。8. eCadNu:所提交的一卡通卡号。9. uyNm：充值数量 表示充值面值卡的张数，取值范围1, 0010. orderm: 商户订单号11. strate: 开场时间12. edDate:截止时间13. p:支付时的ip地址14. agCount:每页记录数15. pagendx:当前页码16. md5toself为按顺序对交易信息的MD5加密签名的2位字符串：mdtoelf =duserae=*&pouctID=*&eCrNum=*&byNm=* oderN=*&starDt=*&ndDae* &*peCunt=&pgeIde=*|en_key 。l 可选参数如果不传的话，不能包含在加密串中。l 其中nc_key为双方约定的key,用于验证交易的合法性,请和天宏公司申请。3.2 返回结果说明返回结果是m格式数据字符串1 单笔查询： coe 查询成功！ items/mdey2 批量查询 查询成功！/ talCount30/prPaeCot 1pagendex /itms/root1. Cod: 返回值编码2. g： 返回信息3. otalout:记录总数4. perPageCt: 每页记录数5. pgeInd:当前页码6. md5Key： m加密的数据信息。用于单笔查询中的平安认证。规那么:dKey= m(urNae*&buyNum*erNum*pyDae=* &cod=*|en_key其中ncke为双方约定的key,用于验证交易的合法性，请和天宏公司申请。7. items： 数据明细节。用于显示数据的详细信息。例如: /serNam G7610328 1/buyNum 21/7/ 1:1:2/ayDae 11/derNum rtrnr :/localhot:303/por27399/gatway/RurnPgeasx/rurrl 查询结果代码结果说明1成功0未知异常-1系统检测到不平安的字符!-2用户名不能为空!-3参数类型错误!md5串格式错误！-5用户验证失败！-6ip地址校验失败!-m5校验失败!