银行普通支付快捷支付银企直连对接操作基础手册.docx

银行一般支付、快捷支付、B2B、银企直连对接操作手册一、 一般支付1. 一般网银支付整体步骤时序图图1-1 网银支付整体步骤时序图（可另存下来或放大看）2. 代码结构图图1-2 一般支付代码结构图3. 对接银行开发步骤1） 首先应该有框架代码，IPaymentService、PaymentServiceImpl、IBankPaymentService、AbstractBankPaymentServiceImpl；2） 新建maven项目，命名为ccb，建立package com.rrtx.payment.ccb.service及com.rrtx.payment.ccb.service.impl；3） 在com.rrtx.payment.ccb.service下编写ICcbPaymentService接口，扩展自IBankPaymentService接口；4） 在package com.rrtx.payment.ccb.service.impl下创建CcbPaymentServiceImpl，继承AbstractBankPaymentServiceImpl并实现刚定义ICcbPaymentService接口，按提醒添加须实现方法，添加完后以下图：5） 在CcbPaymentServiceImpl中添加com.rrtx.payment.service.IPaymentService.Bank对象属性bank，并复写父类init方法，在init方法中对bank对象相关属性初始化，此属性关键封装了本银行服务相关信息，比如显示图标、银行编号、在平台代码、简称等，该部分可能需要读取配置文件config.properties，该文件约定放在src/main/resources/目录下，文件里通常还包含了提交银行接口地址、在银行开立商户号、证书、密钥、返回通知本系统url等信息：6） 在prePayment方法里写逻辑，将我们平台PaymentInput转换成建设银行对应报文格式，部分字段可能需要依据PaymentInput中字段去数据库查询；7） 在afterPayment方法中，依据建行接口文档将银行返回Map解析出我们平台数据PaymentOutput对象返回；8） 假如要使用模拟银行，我们通常在shopDemo中simBank目录下放置模拟银行应答jsp，里面模拟银行返回信息，然后将上面提到提交银行接口url改成该jsp请求url。

9） 至此银行一般支付对接工作基础完成二、 快捷支付1. 代码结构图图2-1 快捷支付代码结构图2. 交互步骤描述用户操作步骤：1） 选择支付方法“快捷支付”，从支持快捷支付银行列表中选择银行；2） 输入银行卡、银行预留号等等信息，阅读并勾选签约协议，提交信息；3） 提醒支付成功；系统前后端交互步骤：1） 用户在支付方法页面选择快捷支付选项卡后，页面向后台请求系统支持快捷支付银行列表并展示银行快捷支付图标；2） 用户选择银行后点击下一步，进入快捷支付页面，该页面首先提议请求判定目前用户是否已签约该银行快捷支付；3） 假如没有则显示签约录入表单，用户输入签约所需全部信息，并点击发送短信验证码，用户收到短信验证码后输入并一起提交表单，后台将该用户提交信息发送至银行鉴权接口，鉴权返回成功后系统验证用户提交短信验证码和支付密码等信息；验证经过后系统调用银行签约接口签约，完成后前端转入步骤4）；4） 假如已签约则提醒输入号等关键支付信息，提交到后台，后台发送短信验证码后，前端弹出验证码输入框，再次提交到后台验证，后台验证正确后发送银行快捷支付接口，成功后返回到前端，提醒支付结果；3. 对接快捷支付开发步骤开发步骤和一般网银支付基础一样，不过我们有几项约定：1） 快捷银行项目和银行简称我们全部以quick结尾，比如中信银行快捷支付项目名叫citicquick；2） 因为不一样银行快捷支付接口功效统一性不高，所以相对网银支付我们加了一层适配器来屏蔽接口方法，银行服务中只需实现我们本银行有接口。

3） 因为对快捷支付来说，我们平台输出数据和网银支付不一样，所以我们封装快捷支付QuickBank和网银支付Bank类中属性也不一样；三、 B2B银行对接1. 代码结构图图3-1 B2B银行对接代码结构图2. 和一般支付及快捷支付异同B2B银行对接开发相对以上两种方法来说全部要简单，关键区分在以下多个方面：1） 全部功效全部是一次调用接口完成，没有复杂前后端交互；2） 类图和快捷支付结构完全一样，因为不一样银行接口功效统一度很低，所以我们也是用了Adapter来屏蔽多种多样接口方法，每个银行服务中只须实现本行提供功效方法即可；3） 和快捷支付相同，我们约定B2B银行服务简称全部以B2B结尾，比如农业银行服务简称为ABCB2B四、 银企直连因为银企直连几乎和B2B银行对接完全一样，所以这里不再反复描述不一样之处只在于代码结构五、 收单系统对接银行1. 收单业务和银行交互步骤图5-1 业务逻辑和银行服务交互步骤图2. 银行对接开发步骤因为收单银行服务和银企直连和B2B银行类似全部是一步交互返回数据，所以对接时参考B2B银行即可；。