《某银行快捷支付接口规范》由会员分享，可在线阅读，更多相关《某银行快捷支付接口规范（38页珍藏版）》请在金锄头文库上搜索。
1、上海银行-快捷支付接口规范(版本号v3.6.6)前言本文档介绍上海银行“快捷支付”的技术标准，此接口标准适应借记卡快捷支付及信用卡快捷支付。其中包括业务处理与系统交互方式、报文的语法与语义、网络连接方式、安全规范等。第1章 文档概述1.1 介绍1.1.1 概述本文档阐述的技术标准，为更加快捷安全的互联网支付结算提供了解决方案。1.1.2 目标读者本文档的主要目标读者是银行与商户的技术实施人员，也可供业务人员参考。1.1.3 最近修订版本号作者内容提要核准人发布日期1.0黄敦迪定义上海银行快捷支付接口规范蔡红林2012-06-12.0黄敦迪删除快捷支付业务概述；调整错误代码；重定义身份鉴权报文头
2、；删除单笔提现接口；删除批量交易明细查询，新增单笔交易明细查询黄敦迪2012-6-133.0黄敦迪增加批量交易明细查询，修改错误代码黄敦迪2013-3-113.1黄敦迪修改身份鉴权、网上支付、单笔退款、批量退款接口，加入了卡代号等2013-3-123.2黄敦迪鉴权需中账户姓名改为必输2013-4-113.3黄敦迪接口实现说明中批量交易查询改为非必须实现的接口。批量交易查询请求报文中加入订单号列表2013-4-193.4彭小波修改身份鉴权接口，CVV2、有效期改为可选字段，增加KoalB64Cert;修改网上支付接口CVV2、有效期改为可选字段，返回报文银行卡改为卡代号， 黄敦迪2013-4-2
3、23.5.1彭小波批量交易查询增加爱业务规则：订单最多支持10笔;查询的多条订单只返回符合条件的记录。2013-4-283.5.2彭小波为单笔退款增加错误代码：40452013-5-23.5.3黄敦迪单笔交易明细查询应答报文中status枚举值调整及定义errorCode的取值；批量交易查询应答报文TradeInfo清单中的signNo改为cardNo2013-5-113.5.4彭小波错误码不再分类别扩展鉴权的证件类别鉴权中增加校验规则，手机号码必须为11位明确单笔订单查询中的交易日期和时间2013-5-173.5.5彭小波调整错误码描述：3006 对应描述改为 卡号不存在或不支持的银行卡30
4、16 对应描述改为 银行账户交易失败批量交易查询的交易状态进行调整：0000 成功；0001失败2013-5-183.5.6彭小波3003的errormessage从“身份证号码不匹配”改为“身份证件号码不匹配”2013-5-213.5.7彭小波针对信用卡的CVV2和有效期，增加对应的错误码：3050和30512013-5-243.5.8彭小波身份鉴权增加业务逻辑：CVV2和有效期需同时输入或同时都不输入2013-5-243.5.9彭小波网上支付去除：CVV2和有效期2013-5-273.6黄敦迪删除二级商户信息同步接口，增加单笔撤消接口2013-6-203.6.1彭小波批量交易查询响应报文中
5、交易信息列表tradeInfoList 签名要求由”Y”变更为”N”2013-6-263.6.2彭小波新增错误码：4046 清算的订单不能做撤销处理2013-6-273.6.3彭小波银行流水号由char(19)统一更改为char(20),修改点：网上支付、单笔退款、单笔撤消2013-6-273.6.4彭小波清算对账中文件格式中银行卡号修正为银行卡代号2013-7-13.6.5彭小波单笔撤消上送报文增加交易金额，同时增加校验：交易金额必须和原订单交易金额一致2013-7-23.6.6彭小波清算对账增加业务规则：信用卡撤消及对应原订单不在清算对账文件内。2013-7-5第2章 报文结构上海银行快捷
6、支付报文规范规定了上海银行与商户之间交换报文的处理规范。2.1 报文结构快捷支付报文统一采用xml格式。所有的快捷支付报文均以Banksh作为根元素，每个Banksh元素中可以包含多个Message元素。Message元素中包含代表具体的业务的元素，比如CSVReq、CSVRes等。每个业务元素由一系列属性元素构成，不同的业务元素中包含的属性元素有所不同。对于涉及到签约状态修改或者资金变动的业务元素，必须要有与之匹配的Signature元素进行数字签名。作为约定，Banksh元素、Message元素与业务元素均是首字母大写的CamelCase形式，所有的属性元素均是首字母小写的CamelCas
7、e形式。 以签约请求报文为例，报文的格式如下： Message id 定义为不重复的随机数，以防止报文重复提交；在下文中出现的具体报文格式描述中，“出现要求”列包含的值的含义如下表所示：含义请求方约束服务方约束RRequired必须包含该域必须校验该域是否存在和内容的合法性CConditional如果条件符合必须包含该域l 当条件满足时，必须校验该域是否存在l 当该域存在时，必须检查其内容的合法性OOptional该域可选当该域存在时，必须检查其内容的合法性2.2 报文分类快捷支付协议中的报文按照交互模式的不同，分为以下几类：n 服务请求类报文服务请求类报文用于请求-应答交互模式，由服务使用者
8、向服务提供者发送。服务请求类报文的命令规范是XXReq，其中XX是报文代表的业务的首字母缩略，Req是Request的缩写。比如对于支付请求报文，命名为CPReq，代表Card Payment Request。n 服务应答类报文服务应答类报文用于请求-应答交互模式，由服务提供者向服务使用者返回。服务应答类报文的命令规范是XXRes，其中XX是报文代表的业务的首字母缩略，Res是Response的缩写。比如对于支付应答报文，命名为CPRes，代表Card Payment Response。n 通知类报文通知类报文用于单向通知交互模式，由通知发送者向通知接收者发送。通知类报文的命令规范是XXNot
9、ify，其中XX是报文代表的业务的首字母缩略。n 通用报文有两种通用报文，一种是Error报文，用于返回处理错误；另一种是NotifyAccept，代表单向通知已被接受。2.3 通用报文2.3.1 错误代码n 银行返回的错误代码说明：错误代码错误描述解释0000无效的根元素根元素无法识别0001未定义的消息域消息不是CSReq、CSRes等；或者消息发送给了一个错误的组件0002必填域缺失0003根据规范，一个或多个域不符合格式要求例如，非数字，或者不是有效的日期格式等等。0004商户标识不正确instId域中的商户标识不正确0005签名无效报文签名校验不通过0006验证证书有效性失败商户证书
10、过期或失效1000文件格式不正确商户批处理业务上传文件不正确1001文件不存在下载文件时，找不到指定的文件1002文件已处理对于不允许重复处理的业务的文件，如果已处理过，就发生此错误1003文件无法解压缩上传的文件无法正确解压缩1004文件摘要不正确文件上传通知报文中的文件摘要不正确2001支付流水重复重复的网上支付流水2002原支付流水不存在申请退货的原支付流水不存在2003查询范围太大查询时间跨度太大2004退款订单日期错误退款订单日期小于原订单日期2005当日撤销必须为全额退款业务要求：当日撤销必须为全额3001真实姓名不正确真实姓名与商户端登记的不一致3002证件类型不正确证件类型与商
11、户端登记的不一致3003身份证件号码不匹配身份证件号码与商户端登记的身份证件号码不匹配3004手机号不匹配3005不支持的银行卡类型3006卡号不存在或不支持的银行卡3007未鉴权的银行卡未做过鉴权的银行卡（卡代号不存在时）3008认证信息不匹配认证信息与商户通过认证的信息不匹配3009银行卡状态不正确银行卡状态不正确3011原支付申请流水不存在支付申请流水不存在（用于退款）3013金额超限支付金额超过每日限额（退款时超出原订单金额也用这个）3014余额不足银行账户中的余额不足以完成支付3015银行交易处理中该笔交易在银行前置系统中状态未知3016银行账户交易失败银行系统的错误返回。3050有
12、效期错误或卡已过期对信用卡有效期的校验，信用卡有效期输错，或信用卡已过有效期3051CVV2错误信用卡CVV2的校验4045未清算的订单不能做退款处理不支持当日退款4001快捷支付渠道关闭没有开通快捷支付业务4002服务没有开通请求的业务没有开通4046清算的订单不能做撤销处理清算的订单不允许做撤销处理9000暂时系统异常通用性错误2.3.2 NotifyAccept报文n 功能用来代表单向通知已被接受。n 消息域下表列举了消息域的定义中文域名对应DTD元素类型出现要求签名要求说明版本号versionchar(7)RN目前版本号：”1.0.1”商户标识instIdchar(15)RY报文发送方的商户标识流水号orderNumchar(30)RY原商户提交的信息流水号交易日期和时间datechar(17)RYYYYYMMDD HH:MM:SS 结果代码errorCodechar(4)RYSUCC表示成功其他均为失败错误描述errorMessagechar(256)ON消息扩展extensionON
