浦发银行商户开发指南Java版V71.doc

上传人:仙人指路1688 文档编号:2294021 上传时间:2023-02-09 格式:DOC 页数:46 大小:717KB
返回 下载 相关 举报
浦发银行商户开发指南Java版V71.doc_第1页
第1页 / 共46页
浦发银行商户开发指南Java版V71.doc_第2页
第2页 / 共46页
浦发银行商户开发指南Java版V71.doc_第3页
第3页 / 共46页
浦发银行商户开发指南Java版V71.doc_第4页
第4页 / 共46页
浦发银行商户开发指南Java版V71.doc_第5页
第5页 / 共46页
点击查看更多>>
资源描述

《浦发银行商户开发指南Java版V71.doc》由会员分享,可在线阅读,更多相关《浦发银行商户开发指南Java版V71.doc(46页珍藏版)》请在三一办公上搜索。

1、编号:上海浦东发展银行支付网关商户安装和使用指南(JAVA版)V7.002/2009文档修改记录版本日期说明编写者审核者1.02005-1-17形成初稿张国强1.12005-3-10更新接口说明李霁伦2.02005-4-28更新接口说明、更新开发指引李霁伦2.12005-5-23更新jks使用说明李霁伦3.02005-6-6更新部分说明李霁伦4.02005-12-12交易格式及对帐文件增加部分字段李霁伦4.12006-1-1新增联机查询和新类别文件下载李霁伦4.22006-2-5修正OsttDate字段李霁伦5.02006-2-10新增批量查询功能李霁伦5.22006-3-15新增公司订单相关

2、返回功能,增强批量订单查询条件李霁伦6.02006-7-2新增协议支付系列交易李霁伦7.02009-06-26按新支付系统修改部分说明,新增B2B协议支付及响应码陈恩永7.109/28/10增加防钓鱼接口信息及说明吴吉说明:本文档中所包含的信息属于机密信息,如无上海浦东发展银行书面许可,任何人都无权复制或利用。目 录 1概述61.1 文档说明61.2 版本61.3 阅读对象72 系统概述72.1 相关定义72.2 支付流程简述92.3 撤销、退货、查询及对帐文件下载流程102.4 对帐文件格式102.5 安全控制112.6 防钓鱼控制113 开发准备113.1 环境要求123.2 开发包文件清

3、单123.3 商户支付网关证书安装步骤133.3.1 说明133.3.2 准备工作133.3.3 获得证书133.3.4 商户私钥容器文件“spdbmerchant.jks”143.3.5 商户容器属性文件“spdb_merchant.properties”153.3.6 将密钥导入商户私钥容器文件 “spdbmerchant.jks”163.3.7 更换密钥容器的密码183.3.8 上传商户证书193.3.9 将商户证书通过网上银行安全传递给银行214 签名及验签开发指引214.1 软件包接口说明214.1.1 签名214.1.2 验证224.2 签名及验签的调用224.2.1 签名方法调用

4、224.2.2 验签方法调用234.3 应用部署235 交易接口描述245.1 基本交易要素245.1.1 输入要素245.1.2 输出要素255.2 交易方式255.2.1 如何编写https页面交易接口255.2.2 如何编写https指令交易接口265.3 交易说明285.3.1 支付交易(IPER)285.3.2 撤销、退货交易(IECR,IPSR)295.3.3 单笔查询(IQSR)305.3.4 多笔查询(BQSR)315.3.5 下载对帐文件(IDFR)325.3.6 B2B支付交易(EPER)335.3.7 对公商户撤单(EECR)345.3.8 协议支付签约(XYQY)355

5、.3.9 协议支付签约撤销(XYCX)365.3.10 协议支付(对私)(DPER)375.3.11 B2B协议支付预签约(对公)(EXQY)385.3.12 B2B协议支付签约预撤销(对公)395.3.13 B2B协议支付(对公)(EDER)396 上线步骤406.1 签订业务协议406.2 开户416.3 开通公司网银416.4 申请并下载公司网银证书416.5 开通支付网关416.6 申请并下载支付网关证书416.7 上传网关证书416.8 配置签名服务416.9 配置URL426.10 试运行427 附录常用取值427.1 表71(网关支持的交易方式)427.2 表72(transNa

6、me域的不同取值)427.3 表73(RespCode域的不同取值)431概述1.1 文档说明电子商务支付中,商户是进行商品售出的一方,其连接客户和支付网关。在和支付网关进行连接时,由电子商务支付网关一方提供数据的加密传输和身份验证的接口程序。支付网关接收商户送来的订单信息后进行处理,支付交易处理完毕后将结果返回给商户网站。同时提供多种方式供商户进行撤销、退货、查询订单支付状态以及下载对帐文件等功能。本操作手册用来指导商户技术人员来实现与电子商务支付网关系统的顺利连接。请相关技术人员详细阅读本手册。文中蓝色字体表示要注意该部分内容,红色加粗的内容表示要重点注意的内容,绿色加粗字体表示后期新增的

7、交易字段及相关功能。1.2 版本根据商户平台和应用技术的不同,商户端接口方式分成JAVA 版、ASP版,本文档是JAVA版。1.3 阅读对象商户开发人员上海浦东发展银行支付网关相关技术人员2 系统概述2.1 相关定义“客户”是指电子支付过程中的付款方,分为“个人客户”和“公司客户“一般情况下,使用“卡”或“折”支付的客户是“个人客户”,使用公司帐户支付的是“公司客户”。“商户”是指电子支付过程中的收款方,商户需要向我行相关部门申请后获得商户身份,完成商户开户后会分配一个商户号给该商户,且一个商户号只能对 “个人客户”或者“公司客户”服务,且不可更改。即:如果某商户的客户既有个人客户又有公司客户

8、,就必须申请2个商户号分别进行服务。“发起订单”是指客户(付款方)在商户(收款方)网站上选择商品,商户系统生成相关订单信息后,按照我行网关的格式将订单信息发送到我行网关,我行网关收到订单信息并处理后,会将支付页面显示给客户。“撤销”是指在支付动作完成的当日,商户发起撤销动作,将该笔支付撤销,钱款退还客户,目前我行只支持一次撤销,且金额必须等于原支付金额。“退货”是指在支付动作完成的隔日至订单发起的90天内,商户发起退货动作,对该笔支付进行退货,钱款退还客户,退货动作可以多次,且总金额必须不大于原支付金额。注意,通过公司网银完成的退货交易对于同一笔订单一天只能退货一次。“协议支付”提供客户一站式

9、购物体验,避免客户每次购物时在商户网站和银行网站之间来回切换。客户、商户和银行三方两两签约后,支付信息由商户网站发送到银行支付网关直接完成扣款,不需要客户参与扣款过程。客户首先在商户网站申请开通协议支付功能,在获得商户的ID(客户在商户处的唯一标识)后,可选择是否预留证件号、姓名等信息,并由商户将签约信息发送银行端,并由客户在银行页面端完成客户和银行端签约。签约中需客户将商户端ID和客户的凭证(卡或者存折)关联起来,在验证客户的证件,交易密码等内容后完成银行端签约。三方签约完成后,客户即可在商户网站直接购物,只需商户将相关交易信息发送银行网关即可完成扣款。我行支付网关进行了多次功能扩充和优化。

10、商户使用的功能可以使用3种方式实现:公司网银、https页面、https指令。https页面方式是指通过html页面方式组织相关交易内容,然后发送POST请求到银行网关进行交易,一般适用于asp或者jsp等web应用;https指令方式是指通过xml的标准方式组织交易内容,然后发送到网关进行交易,一般适用于应用程序。通过公司网银,客户可以编写并上传批量交易文件进行批量协议支付和批量退货。这3种方式支持的功能分别如下:表21交易支持方式https页面https指令公司网银个人支付(IPER) 企业支付(EPER)撤销交易(IECR)退货(IPSR)单笔查询(IQSR)多笔查询(BQSR)对帐文件

11、下载(IDFR)对公订单撤销(EECR)协议支付签约(XYQY)协议支付签约撤销(XYCX)(仅对公司会员)协议支付(DPER)B2B协议预签约(EXQY)B2B协议预撤销(EXCX)B2B协议支付(EDER)2.2 支付流程简述图2-11. 商户根据客户选择的商品生成订单,包括商户号、订单号、金额、时间以及对这些关键数据的数字签名。2. 客户提交付款请求时,商户服务器将商户号、订单号、金额、日期和使用商户私钥做的数字签名作为参数传递给支付网关,此时的通讯协议采用SSL。支付网关验证数字签名通过后,确认是商户签署的、有效的支付信息,则产生付款页面。如果数字签名不正确,则发出警告并返回失败信息。

12、3. 客户输入账号和密码后由支付网关验证。验证通过后,根据账号信息将支付请求发至银行业务系统。根据需要,系统同时验证客户的个人证书。4. 银行业务系统接收支付请求,进行相应的业务处理,将结果返回至支付网关。5. 支付网关接收业务系统的处理结果。6. 若由于客户余额不足等原因,业务系统返回处理失败,支付网关直接返回客户失败信息。若业务系统处理成功,支付网关负责将支付结果以http/https的方式通知商户。支付结果中同样有银行使用自己的私钥作的数字签名,以保证信息一定是由银行发出的并且确保其完整性和不可抵赖性。7. 商户接收到支付成功请求后,并发货给客户。8. 支付网关会将交易成功的结果直接显示

13、给客户。如果由于超时等特殊原因导致状态未知,客户可以通过查询帐户得知是否交易成功。注意:在每次成功支付后,商户可以通过3种方式获得交易结果:1 交易成功结束后,将结果返回给客户页面,会从客户页面提交结果内容到商户接收结果的URL;如果客户的页面阻止了跳出页面方式,则不会提交。2 交易成功结束后,将从网关服务器多次直接发送交易结果到商户接收结果的URL。因此商户会多次重复(5次)收到网关送来的支付交易结果(1,2合计6次)。3 商户可以通过5.3.3节描述的查询交易查询某笔交易的状况。2.3 撤销、退货、查询及对帐文件下载流程如2.1节中的图表所示,撤销、退货、查询及对帐文件下载可以通过3种方式

14、完成。商户可以登录公司网银,商户操作员只需在撤销和退货页面中,查询到相关订单后选择并通过相关授权即可完成,另外公司网银中有相关菜单可以完成查询和对帐下载。在https页面和https指令方式下,商户只需按照相应的方式组织相关的交易字段内容,并进行签名后,发送给我行网关即可进行。具体的签名方法将在章节4中进行介绍,交易字段组织方式将在章节5中进行介绍。2.4 对帐文件格式对帐文件的内容是以“|”分隔的如下内容,每条记录记录以回车换行结束具体记录内容格式如下:交易缩写清算日期交易发生时间订单号网关流水号商户号终端号交易金额手续费净清算金额响应码商户保留1商户保留2其中,交易缩写参见表7-2。2.5

15、 安全控制1 采用PKI和数字证书认证体系2 通讯使用SSL协议(128位),对数据进行加密3 商户和银行间数据交互都使用数字签名,并使用公钥进行数据验证,确保数据的完整性和不可抵赖性3 开发准备商户的开发主要包括以下内容:1 组织交易数据并用商户证书签名后,从商户网站页面发送到我行支付网关相关页面。2 接收我行服务器反馈的交易结果,验证我行服务器的签名后,对返回的交易结果做相应的处理。所以商户的开发工作是以签名和验签为中心的相关页面或应用开发。本节对商户开发和生产环境做简要描述,并列出开发包中包含的文件清单。3.1 环境要求硬件方面:由于网上支付系统提供的软件同商户的系统紧密集成,通常不需要

16、额外的硬件投资。系统将安装在商户的应用服务器上,基本配置推荐:基于x86-32位CPU,PIII450以上,256M内存,10M剩余硬盘空间。软件方面:JDK1.3或以上,操作系统不限。3.2 开发包文件清单n spdbmerchant.jks商户密钥容器,参见3.3.4-3.3.7,4.4n spdb_merchant.properties商户配置文件,放置到/WEB-INF/class目录下,参见3.3.5n pfx2jks.bat导入证书的脚本文件(win),在unix或者linux中将其属性设为可执行即可,参见3.3.6n spdbmerchant.jar 开发包类库,放置到/WEB-

17、INF/lib目录下n bcprov-jdk14-127.jar基础类库,放置到/WEB-INF/lib目录下n jce.jar基础类库,放置到/WEB-INF/lib目录下n jcert.jar基础类库,放置到/WEB-INF/lib目录下n jnet.jar基础类库,放置到/WEB-INF/lib目录下n jsse.jar基础类库,放置到/WEB-INF/lib目录下n 目录 cert4test测试用证书相关l spdbmerchant.jks商户密钥容器(测试用),使用时需复制到上 级目录,参见3.3.4-3.3.7,4.4l Readme.txt说明文件l 2002182316.pfx

18、商户测试证书,密码为1n 目录 cert4real生产用证书相关l spdbmerchant.jks商户密钥容器(生产用),使用时需复制到上级目录,参见3.3.4-3.3.7,4.4l Readme.txt说明文件注意:测试用网关证书的有效期到2007年2月9日,如果开发测试在该日期以后,请联系我行人员获取新版本开发包。3.3 商户支付网关证书安装步骤3.3.1 说明商户使用银行为商户申请的支付网关专用的数字证书,由CFCA颁发。3.3.2 准备工作建议使用windows操作系统进行证书下载和安装工作,推荐使用Windows2K/WinXP 或最新的Windows2003。到 或其他下载中心下

19、载相应的JDK安装软件。确保当前的运行路径的PATH系统变量中包含 $JDK_INSTALL_DIR/bin3.3.3 获得证书1 测试证书测试证书一般随开发包提供,如3.2文件清单中的2002182316.pfx,该文件名会因商户不同而不同。该证书也可以由分行开发人员在测试环境申请证书,拿到两码后,自行在CFCA地址下载测试证书:http:/210.74.41.60/cda-cgi/clientcgi?action=start 2 生产证书生产环境证书包括公司网银证书和支付网关证书。这两种证书都是在我行柜面申请,不同的是公司网银证书需要下载到USBKEY中,而支付网关证书直接下载(或导入)到

20、系统中。在实际操作中,可以在Windows机器上下载支付网关证书,然后导出成pfx文件(导出过程中选择“导出私钥”),供步骤3.3.4使用。在柜面申请成功拿到两码后,即可到我行网上银行下载生产证书,下载地址为: 注意:支付网关证书必须选择默认CSP(“Microsoft Enhanced Cryptographic Provider V1.0”)进行下载公司网银证书下载时必须先安装USBKEY驱动,然后选择CSP:“SafeSign CSP Version 1.0”3.3.4 商户私钥容器文件“spdbmerchant.jks”spdbmerchant.jks就是商户的密钥容器(keystor

21、e)文件,应用程序需要的证书都存贮在该容器中,浦发银行事先将生产和测试用的银行网关证书及相应的证书链导入容器中,容器的默认keystore密码是111111使用如下命令可以查看密钥容器中的证书:keytool list keystore spdbmerchant.jks测试用的容器文件运行结果如下所示:上图中一共有4个条目,包括测试用的网关证书(paygate_cert)和测试证书链(cfca_pca,cfca_rca,cfca_oca)。生产用的容器文件运行结果如下所示:上图中一共有4个条目,包括生产用的网关证书(paygate_cert)和生产证书链(cfca_pca,cfca_rca,c

22、fca_oca)。注意:测试和生产用的容器文件千万不要混淆。3.3.5 商户容器属性文件“spdb_merchant.properties”该文件的内容如下所示:development=nocafile=c:/cert4test/spdbmerchant.jksstore_password=111111alias_key=merchant_keykey_alias=merchant_keykey_password=222222alias_paygate=paygate_cert其中,cafile是容器文件存放的位置,在windows平台下路径c:cert4testspdbmerchant.jk

23、s,也可以写作c:cert4testspdbmerchant.jks;在UNIX或者linux平台下,直接写路径就可以,比如: /keystore/spdbmerchant.jksstore_password是容器的访问密码,默认是111111,一般不需要修改,如果需要修改的话,可以参照3.3.6。注意:配置文件的各项中,一般cafile是必须修改的,store_password和key_password可以按照客户需要来修改,其他项一般不需要修改。3.3.6 将密钥导入商户私钥容器文件 “spdbmerchant.jks”将该文件放置在一个新建的工作目录中,并将系统当前路径切换到该目录中。$

24、pfx2jks spdb_merchant.properties -keypassword new 参数说明: spdb_merchant.properties 配置文件名称,一般不需要修改名称 导出的商户证书私钥文件 导出私钥文件时指定的密码商户为自己的证书新设定的密码测试证书导入,如下所示:运行后的最后结果:注意: 1在导入前,如果您没有修改密钥容器文件的密码!则请不要修改对应的spdb_merchant.properties文件。如果修改了密码则请同时修改该配置文件。2这里指定的merchant_key的密码是222222,客户需要按照自己的实际情况输入,并在spdb_merchant.

25、properties文件中的key_password保持一致。3.3.7 更换密钥容器的密码银行为商户提供的密钥容器文件spdbmerchant.jks的初始密码是111111,私钥缺省密码相同。实际的生产环境中,建议更改此密码。l 更改密钥容器文件密码(keytool是JDK默认提供):$keytool storepasswd new -keystore merchant.jks -storepass OLD_PASSWOR原来容器密码为111111,更换为444444,如下所示:l 更改私钥密码:$keytool -keypasswd -new -keystore merchant.jks

26、 -alias merchant_key原来私钥密码为222222,更换为333333,如下所示:注意:这里的merchan_key 和spdbmerchant.properties文件中的key_alias的值相同。3.3.8 上传商户证书在完成步骤3.3.2后,银行要求商户导出商户证书到一个商户自己指定的.cer文件中,然后通过网上银行的商户管理功能中将该证书文件上传到网关。选择 Internet选项-内容-证书,选中商户证书,选择“导出”:选中不,不导出私钥,点击下一步继续在选择到导出类型时,选择默认格式,如下:然后按照提示一步一步做下去,最后得到证书文件。3.3.9 将商户证书通过网上

27、银行安全传递给银行导出商户证书后,需要通过我行的公司网上银行将证书上传到网关。测试环境公司网银地址:http:/xx.xx.xx.xx/ent/gb/login.jsp,其中IP地址需要联络获得。生产环境公司网银地址: 注意:系统正常运行一段时间以后,推荐商户对自己的证书和私钥定期进行更换,以增强安全性。证书更换期一般为一年或两年,商户也可以根据自己的实际情况,随时进行证书更换,但是务必及时上传更新后的数字证书。4 签名及验签开发指引4.1 软件包接口说明4.1.1 签名String com.csii.payment.client.core.MerchantSignVerify.merchan

28、tSignData_ABA( String PlainData );功能描述:静态方法,用于商户使用自己的私钥对原始数据进行数字签名输入参数:签名的原始字符串 PlainData输出参数:签名的目标字符串 signData4.1.2 验证boolean com.csii.payment.client.core.MerchantSignVerify.merchantVerifyPayGate_ABA(sign,Plain)功能描述:静态方法,用于商户使用对银行传递来的信息进行校验输入参数:签名的原始字符串 PlainData签名的目标字符串 signData输出参数: true 校验成功 fal

29、se 校验失败4.2 签名及验签的调用签名是在商户拼装好交易字段的明文后,调用商户的证书私钥进行签名的过程。网关将校验该签名以保证该交易是该商户发起。通常,在商户通过https页面方式或者https指令的方式给网关发起交易的时候,都必须对其交易字段明文进行签名。验签是网关处理完交易(比如支付、撤销、退货、查询等)后,组织好交易结果的明文后,调用网关证书私钥对明文进行签名,商户将通过校验该签名以保证结果是银行网关返回的。通常,在商户接收各种交易结果的时候,都必须对该签名字段进行验签。以下章节以https页面方式下的发送订单和支付后的交易结果发送为例,分别描述签名及验签的用法。4.2.1 签名方法

30、调用以下内容以https页面方式发送订单交易为例,演示签名方法的调用。示例如下:在页面中调用方法:com.csii.payment.client.core.MerchantSignVerify.merchantSignData_ABA(String Plain)方法,将得到数字签名通过sign字段传递给银行。其中: transName: 必须上传,消费交易为IPER,具体见表5-2Plain:商户订单数据组成的原始数据字符串Signature: 原始数据字符串的签名4.2.2 验签方法调用从网关送来的信息中,取得以下2个变量:Plain:订单状态的原始数据字符串,Signature: 银行的数

31、字签名,然后调用方法:com.csii.payment.client.core.MerchantSignVerify. merchantVerifyPayGate_ABA (String Signature,String Plain),校验签名。4.3 应用部署n 首先,将商户密钥容器文件spdbmerchant.jks放在spdb_merchant.properties中cafile指示的文件系统位置。n 然后,按照J2EE WEB应用的部署规范:l 将修改后的spdb_merchant.properties文件放置到/WEB-INF/classes目录l 将spdbmerchant.jar

32、软件包放在/WEB-INF/lib目录下l 将spdbmerchant.jks文件放在spdb_merchant.properties文件中指定的地方。5 交易接口描述https页面方式和https指令方式支持的交易参见表71(网关支持的交易方式),以下将分别对https页面方式和https指令方式下的交易接口进行描述。5.1 基本交易要素5.1.1 输入要素https页面方式和https指令方式下向网关发送交易时,都必须提供3个基本要素:transName、Plain、Signature。其中,transName是交易名;Plain是交易字段拼装的明文,支付、撤销、退货的Plain的组织方式

33、类似;Signature是对Plain的签名。transName域的不同值代表不同的交易,描述如下:表52取值说明IPER个人客户支付EPER企业客户支付IPSR退货交易IECR撤销交易IQSR单笔交易查询BQSR多笔交易查询IDFR对帐文件下载EECR支付前订单撤销(对公支付)DPER协议支付XYQY协议支付签约XYCX协议支付签约撤消EXQYB2b协议支付预签约EXCXB2b协议支付预撤销EDERB2b协议支付Plain域中各元素间用 字符|分开1 字符串的尾部和中间去除空格2 字符区分大小写,汉字使用GBK编码示例如下,以IPER交易为例:TranAbbr=IPER|MercDtTm=2

34、0050201015901|TermSsn=000000123456|OsttDate=|OacqSsn=|MercCode=990108160000101|TermCode=00000000|TranAmt=100.01|Remark1=备忘|Remark2=备注|MercUrl=表5-2中涉及其他各交易组织明文所需的具体字段参见5.3节。Signature域是对plain字段进行的签名。5.1.2 输出要素支付网关返回商户的信息,是以XML报文的组织结构的一段内容交易正常返回交易名称 交易请求明文交易请求明文的签名交易出错返回错误码错误信息注意,类似IPER、XYQY、XYCX等需要客户与

35、支付网关交互的交易,直至交易全部完成才会返回商户结果。5.2 交易方式下面将详细描述页面提交方式和SSL提交方式的具体实现,请务必按照文档进行操作。5.2.1 如何编写https页面交易接口l 交易发起页面input type=hidden name=Plain value=input type=hidden name= Signature value=如以上代码所示,交易发起需要提交3个变量,transName,Plain,Signature。其中,transName的取值参见表72(transName域的不同取值)。Plain的组织方式见本章5.1.1节,Signature的生成方式,见章

36、节4.2.1。按照指定的格式组织好交易内容后,将页面post到指定网关地址,网关处理后,返回相应结果。页面方式生产环境链接是:测试环境链接是:http:/124.74.239.32/payment/main 银行的支付网关页面,必须在新建的弹出窗口中,弹出窗口要求必须屏蔽IE的相关操作菜单,以及各种按钮。注意:大小写敏感。l 接收结果页面/从返回的XML格式报文中解析出PLAIN和SIGNATURE字段%Plain=Signature=接收结果界面中,可以从请求中取得Plain和Signature两个变量,Plain的组织方式见本章5.1.1节,然后通过验签函数验签,参加章节4.5.2。5.2

37、.2 如何编写https指令交易接口商户以https的方式直接连接支付网关的服务地址,并将交易的具体请求信息以post请求提交xml格式到支付网关,具体的交易请求信息直接以流的形式提交。注意:以指令方式提交的交易请在HTTP报文头(head)中加上Content-Type=text/xml。l 商户输入交易名称,参见表72(transName域的不同取值)交易请求明文,参见章节本章5.1.1交易请求明文的签名,参见章节4.2.2按照指定的格式组织好交易内容后,将页面post到指定网关地址,网关处理后,返回相应结果。指令方式生产环境链接是: 测试环境链接是:http:/124.74.239.32

38、/payment/paygate银行的支付网关页面,必须在新建的弹出窗口中,弹出窗口要求必须屏蔽IE的相关操作菜单,以及各种按钮。注意:大小写敏感。l 支付网关返回交易正常返回交易名称 交易请求明文交易请求明文的签名交易出错返回错误码错误信息页面方式和指令方式支持的交易范围略有不同,具体支持信息请参见表2-1。下面介绍具体交易时也会提示支持类型。5.3 交易说明5.3.1 支付交易(IPER)l 注意:该交易只支持页面交易方式。l 商户输入字段,组织方式请按照5.1.1中Plain字段格式进行组织:表53名称说明类型长度备注TranAbbr交易缩写String4标识交易类型,见表72Maste

39、rID企业客户号String10企业客户支付时必须提供,个人客户支付时不需要MercDtTm商户日期时间String14必须提供,商户的交易日期时间yyyyMMddhhMMssTermSsn订单号String12订单号,不能重复OSttDate原交易清算日期String8原交易的清算日期,支付交易不用填值,撤销退货需填OAcqSsn原网关流水String12原交易的网关流水,支付交易不用填值,撤销退货需填MercCode商户号String15开户时获得TermCode终端号String8可以全为0TranAmt交易金额String12元为单位,如:11.01(表示11元1分),11(表示11元

40、)Remark1交易备注1String22交易备注一,该字段将在对帐文件中提供Remark2交易备注2String99交易备注二,该字段将在对帐文件中提供MercUrl支付交易中,接收交易结果的url,如:http:/aaa.bbb.ccc/receive.asp String60如果该项为空,则交易结果会送到商户在柜面签约的时候填写的接收结果的url;否则就会送到该地址中。支付交易选填,撤销退货不需填Ip生成订单的IP地址String50如果该项为空,则不进行IP地址检查。支付交易选填,撤销退货不需填l 客户完成支付后网关返回商户字段:表54名称说明 数据类型长度TranAbbr交易缩写String4见表72AcqSsn网关流水String12要求记录此值,撤销、退货等交易需要该字段MercDtTm商户日期时间String14TermSsn订单号String12RespCode响应码 String200:表示交易成功其余表示失败,具体失败情况描述参见表73(RespCode域的不同取值)TermCode终端号 String8MercCode商户号 St

展开阅读全文
相关资源
猜你喜欢
相关搜索

当前位置:首页 > 建筑/施工/环境 > 项目建议


备案号:宁ICP备20000045号-2

经营许可证:宁B2-20210002

宁公网安备 64010402000987号