混合支付设计文档v11

京东世纪贸易有限公司-信息部设计说明书文件编号作者崔岩文档版本1.0最后修改日期2013-6-5文档版本1.1最后修改日期2013-6-9混合支付项目设计说明书编写人：崔岩编写时间：2013-06-05确认时间：修订控制页编号文档版本修订章节修订原因修订日期修订人1初始化1.0第一版本2013-6-5崔岩21.11、2.2POP网关申请退款流程修改2、新增POP网关ERP订单退款汇总表3、退款信息管理新增ERP订单退款汇总信息查询混合支付设计一审讨论结果2013-6-9崔岩目录1 系统总体设计 31.1 系统依赖 31.2 下单退款业务流程 41.2.1 下单流程 41.2.2 退款流程 51.3 整体设计 61.4 业务系统的调整 61.5 核心状态图 71.5.1 POP网关退款状态 72 子系统设计 72.1 彩票系统 72.1.1 下单 72.1.2 向POP网关申请退款 72.1.3 退款回调及反查 82.2 POP网关 82.2.1 向财务申请退款 82.2.2 退款回调及反查 102.2.3 退款信息管理 103 数据库设计ER图 114 系统部署图 115 权限配置 116 尚未解决的问题 11系统总体设计系统依赖下单退款业务流程下单流程退款流程整体设计核心状态图POP网关退款状态开发工作彩票系统数字彩前端开发竞技彩前台开发数字彩后台下单逻辑修改下单公共逻辑竞技彩后台下单逻辑修改在线支付及ERP确认消息回调及反查work修改竞技彩查询待退款订单work数字彩查询待退款订单work向财务申请退款work网关退款回调/反查workPOP网关虚拟通用申请退款接口财务退款回调接口虚拟通用退款状态查询接口虚拟通用退款完成通知work退款信息管理通知业务系统任务修改业务系统提交到POP网关，退款状态为1，POP网关向财务系统发起退款情趣，财务系统接收到退款请求，退款状态变为2，等待财务系统处理完成，将通知业务系统退款结果，退款成功状态变成3，退款失败状态变成4。子系统设计彩票系统下单概述彩票系统下单新增【余额+在线】、【优惠券+在线】、【余额+优惠券】、【余额+优惠券+在线】四种混合支付方式。 选择代购、追号、套餐、合买购买方式的下单时，都应把余额、积分、优惠券、在线支付存储到对应的字段中。 支付回调及反查彩票原系统进行支付成功比对时取的是支付总金额，由于增加混合支付后，有可能用户在线支付的金额小于支付总金额，需要对此进行修改。向POP网关申请退款概述申请混合支付退款work在查询需要退款的订单时，需要把混合支付对应的支付方式的支付金额插入到退款表中，调用POP网关退款接口进行退款操作。 申请退款所需参数：订单金额，应退货款，在线支付金额，京券总额，订单类型，订单号，业务唯一标识,订单使用积分，东券面额（备用）流程图流程详解退款信息查询work查询出订单表中需要退款的数据（出票失败、过期支付、用户撤单、系统撤单、参与失败等），将退款信息插入退款表；申请退款work扫描退款表可退款的数调用POP网关退款接口，POP网关退款接口接收到请求后插入退款数据到POP网关退款表并返回true。退款结果反查概述POP网关在处理完成订单退款状态后将通知业务系统，业务系统也可以通过反查POP网关接口的方式来获取退款相关信息。流程图流程详解通过订单ID查询POP网关接口，如果明确返回退款成功或失败，则根据退款结果更新退款状态，否则轮询查询POP网关接口。POP网关申请退款概述POP网关接收业务系统的退款请求并处理；查询退款记录work扫描退款表中需要退款的记录，插入需退款的支付金额到退款明细表，申请退款work扫描退款明细表向财务申请退款，等待财务处理成功后回调POP网关接口进行后续处理。流程图流程详解1、接收业务系统退款请求 POP网关接收业务系统退款请求，判断ERP订单退款汇总表中是否存在该退款记录，如果存在则判断退款总金额是否超过订单总金额，如果超过了，则通知业务系统退款申请接收失败并注明失败原因，否则插入退款信息到退款表，并更新ERP订单退款汇总信息；如果ERP订单退款汇总表中不存在该退款记录，则插入该记录到退款订单表及退款汇总表，通知业务系统退款申请接收成功。2、向财务系统申请退款退款work查询退款表中退款状态为待退款（REFUND_STATUS=1）的退款记录，根据退款算法（先退券折成的积分，再退余额，再退在线）计算出各个支付方式应退金额、更新退款状态为退款信息表该订单的退款状态为处理中（REFUND_STATUS=2），并修改该记录的各支付方式的退款金额，插入退款明细各支付方式的退款金额。 申请退款work扫描退款明细表向财务申请退款，如果财务系统接收成功，POP网关更新退款明细表中该记录的退款状态为处理中（REFUND_STATUS=2），等待财务系统回调POP网关。3、财务系统回调POP网关财务系统处理完成后，回调POP网关的接口，程序判断是否存在退款中的明细，如果存在则跳出，否则判断该订单的退款明细是否全部退款失败，如果全部退款失败则更新退款状态为4并更新退款失败原因，否则判断该退款订单的退款明细是否全部退款成功；如果是全部退款成功则更新ERP订单退款汇总表该记录的已退款金额、各支付方式已退金额、更新退款状态为（REFUND_STATUS=3），并插入退款成功消息到任务表，用于通知业务系统退款结果；如果是部分退款成功则邮件报警，人工线下处理。退款结果回调概述 POP网关的通知work通过扫描任务表中的退款完成消息来通知业务系统退款结果。流程图 流程详解高频率通知work：查询退款状态为已退款成功或退款失败（REFUND_STATUS=3或REFUND_STATUS=4）、未通知业务系统、失败次数小于等于5的订单。低频率通知work：查询退款状态为已退款成功或退款失败（REFUND_STATUS=3或REFUND_STATUS=4）、未通知业务系统、失败次数>5&&<11的订单。退款信息管理概述可以通过该功能进行各业务类型的ERP订单退款汇总信息、退款信息、退款明细等信息的查询，并可以对通知失败次数已达伐值的订单进行重复操作通知。 数据库设计ER图POP网关ERP订单退款汇总表预退款金额=已退款金额+正在向财务申请退款的金额字段名字段CODE字段类型备注退款编号REFUND_IDNUMBER主键业务类型BUSINESS_TYPEVARCHAR彩票：36订单编号ORDER_IDNUMBERERP订单编号订单总金额TOTAL_FEENUMBERERP订单总金额预退款的总金额PRE_REFUND_FEENUMBER单位：分实际已退款总金额REFUND_FEENUMBER订单应退金额单位：分积分TOTAL_SCORE_FEENUMBER单位：分积分预退款金额PRE_REFUND_SCORE_FEENUMBER单位：分实际已退积分REFUND_SCORE_FEENUMBER单位：分余额TOTAL_BALANCE_FEENUMBER单位：分预退款余额PRE_REFUND_BALANCE_FEENUMBER单位：分实际已退余额REFUND_BALANCE_FEENUMBER单位：分优惠券（京券）TOTAL_J_COUPON_FEENUMBER单位：分优惠券（京券）预退款金额PRE_REFUND_J_COUPON_FEENUMBER单位：分实际已退优惠券（京券）REFUND_J_COUPON_FEENUMBER单位：分优惠券（东券）TOTAL_D_COUPON_FEENUMBER单位：分优惠券（东券）预退款金额PRE_REFUND_D_COUPON_FEENUMBER单位：分实际已退优惠券（东券）REFUND_D_COUPON_FEENUMBER单位：分在线支付TOTAL_ONLINE_PAY_FEENUMBER单位：分在线支付预退款金额PRE_REFUND_ONLINE_PAY_FEENUMBER单位：分实际已退在线支付REFUND_ONLINE_PAY_FEENUMBER单位：分创建时间CREATEDDATE修改时间MODIFIEDDATE有效状态YNVARCHAR1有效;0无效POP网关退款表字段名字段CODE字段类型备注退款编号REFUND_IDNUMBER主键业务类型BUSINESS_TYPEVARCHAR彩票：36订单编号ORDER_IDNUMBERERP订单编号退款唯一标识UUIDVARCHAR业务类型-退款唯一标识（每笔退款记录不可重复）订单退款金额REFUND_FEENUMBER订单应退金额积分TOTAL_SCORE_FEENUMBER单位：分余额TOTAL_BALANCE_FEENUMBER单位：分优惠券（京券）TOTAL_J_COUPON_FEENUMBER单位：分优惠券（东券）TOTAL_D_COUPON_FEENUMBER单位：分在线支付TOTAL_ONLINE_PAY_FEENUMBER单位：分退款状态REFUND_STATUSVARCHAR1未退款;2退款中;3退款成功;4退款失败;退款备注REFUND_REMARKVARCHAR创建时间CREATEDDATE修改时间MODIFIEDDATE有效状态YNVARCHAR1有效;0无效POP网关退款明细表退款编号REFUND_IDNUMBER业务类型BUSINESS_TYPEVARCHAR彩票：36订单编号ORDER_IDNUMBERERP订单编号退款金额REFUND_FEENUMBER单位：分退款类型R