YKY管理平台开发文档

1、l YKY_管理后台开发文档l 机构管理菜单目录结构：机构管理 机构资料录入 机构资料查询功能实现：机构资料录入：页面录入以下信息，机构编号、机构名称、法人姓名、法人手机号码、地区、经营地址、营业执照号、法人身份证号、常用邮箱、账户姓名、账户号、开户行、联行号、法人身份证正反面照、法人手持身份证半身照、银行卡正反面照、营业执照照片、税务登记证照片、组织机构代码证照片、开户证明、是否OEM机构、机构logo上传；（红色为必填，以下不再表述）代理商编号：固定3位，先从表中获取最大机构号，加1显示，该字段可人为修改；地区：获取地区表省字段，下拉列表显示；联行号：联行号文本框后头跟一个link，选择联

2、行号，点击弹出悬浮窗，根据清算银行，支行进行模糊查询，加载相应联行号，选中某个联行号，点击确定，关闭悬浮窗，对应联行号显示在文本框内，支行名称出现在开户行全程内；所有照片，上传后，统一放在以机构编号新建的文件夹内，上传完毕，页面需显示缩略图；状态：默认0；进件日期：默认系统时间进件用户Id：当前登陆用户Id；最后修改UID：当前登录用户Id; 最后修改时间：默认系统时间；（所有表操作如果有以上两个字段，每次update操作，都需要更新着两个字段，以下不再表述）l 代理商管理菜单目录结构：代理商管理 代理商资料录入 代理商资料审核 代理商资料查询功能实现：代理商资料录入：页面录入以下信息，代理商

3、编号、代理商名称、运营商编号、代理级别、上级代理编号、法人姓名、法人手机号码、地区、经营地址、营业执照号、法人身份证号、常用邮箱、账户姓名、账户号、开户行、联行号、法人身份证正反面照、法人手持身份证半身照、银行卡正反面照、营业执照照片、税务登记证照片、组织机构代码证照片、是否OTO代理、开户证明； 代理商编号：固定3位，先从表中获取最大机构号，加1显示，该字段可人为修改；地区：获取地区表省字段，下拉列表显示；联行号：联行号文本框后头跟一个link，选择联行号，点击弹出悬浮窗，根据清算银行，支行进行模糊查询，加载相应联行号，选中某个联行号，点击确定，关闭悬浮窗，对应联行号显示在文本框内，支行名称

4、出现在开户行全程内；所有照片，上传后，统一放在以代理商编号新建的文件夹内，上传完毕，页面需显示缩略图；OTO代理：可分配一个卡bin，固定6位数字，以9开头；状态：默认0；进件日期：默认系统时间进件用户Id：当前登陆用户Id；代理商资料审核：点击默认显示agentStat =0的代理商列表信息，抬头如下；序号、代理商ID、代理商名称、法人、手机号、所属区域、状态、录入时间、查看详情点击查看详情，进入详情页面，将代理商信息全部显示出来；最下端添加两个功能按钮，一个审核通过，一个审核驳回；审核通过：状态字段agentStat 为2，审核用户Id：当前登陆用户Id；审核通过日期：当期系统日期；跳入分

5、配后台用户界面分配userId，分配费率；审核驳回：agentStat 为1；审核用户Id：当前登陆用户Id；审核通过日期：当期系统日期；当前页面关闭，显示待审核代理商列表；审核通过，配置费率代理商资料查询：查询条件字段为，代理商ID、代理商名称、法人姓名、状态、录入时间、所属地区；查询结果显示字段为：序号、代理商ID、代理商名称、法人、手机号、所属区域、状态、录入时间、查看详情点击查看详情，进入详情页面，将代理商信息全部显示出来；具有相应修改/删除权限的用户，可选中某条记录，点击修改按钮，进入修改页面；点击删除，弹出确认删除对话框；l 商户管理菜单目录结构：商户管理 商户进件申请 商户进件审

6、核 商户清算变更 商户查询 终端查询功能实现：商户进件申请：页面录入以下信息，商户号、代理商编号、地区ID、MCC码、法人姓名、法人手机号码、商户名称、经营地址、经营范围、营业执照号、法人身份证号、常用邮箱、账户姓名、账户号、开户行、联行号、清算标志、法人身份证正反面照、法人手持身份证半身照、银行卡正反面照、营业执照照片、税务登记证照片、组织机构代码证照片、门头照片、内景照片、是否OTO商户、开户证明； 以及终端信息包括：终端号、终端名称（小票名）、联系人姓名、联系人手机号码、地址；一个商户可申请多个终端，最少一个；商户号生成规则：固定15位，3位代理商编号+4位地区码+4位MCC码+4位顺序

7、位终端号生产规则：3位代理商编号+5位顺序位OTO商户，终端可增加最多两名收银员，输入会员卡号；（后期可修改来完善）代理商编号：获取当前登陆用户所属代理商编号，赋给商户号头三位；地区码：获取地区表字段，下拉列表显示，将所选地区4位地区码赋值给商户号第3-7位；MCC码：获取MCC码表字段，下拉列表显示，将所选行业MCC码赋值给商户号第8-12位；选定MCC码的同时，将对应手续费扣率记入商户扣率当做默认推荐扣率保存；联行号：联行号文本框后头跟一个link，选择联行号，点击弹出悬浮窗，根据清算银行，支行进行模糊查询，加载相应联行号，选中某个联行号，点击确定，关闭悬浮窗，对应联行号显示在文本框内，支

8、行名称出现在开户行全程内；所有照片，上传后，统一放在以商户号新建的文件夹内，上传完毕，页面需显示缩略图；OTO商户，需选择积分规则、设置冻结金额、业务员姓名等；状态：默认0；进件日期：默认系统时间进件用户Id：当前登陆用户Id；商户进件审核：点击默认显示merStat =0的代理商列表信息，抬头如下；序号、代理商编号、商户号、商户名称、法人、手机号、所属区域、状态、录入时间、查看详情点击查看详情，进入详情页面，将商户信息全部显示出来；最下端添加两个功能按钮，一个审核通过，一个审核驳回；配置费率：默认显示MCC对应费率，根据签约实际费率进行配置；选择风控规则：获取风控规则表（risk_regul

9、ar_info）信息，下拉列表显示；配置交易类型：复选框显示银行卡功能、会员卡功能、支付宝功能；分配渠道：默认点对点类型，点击选择弹出悬浮窗，加载同地区商户渠道信息，支持模糊查询，查找对应渠道商户终端，选定将主键ID赋值给商户表的chId字段；分配用户：默认商户号作为登陆账号，密码默认1234qwer，角色默认商户；审核通过：状态字段merStat 为2，审核用户Id：当前登陆用户Id；审核通过日期：当期系统日期；审核驳回：merStat 为1；审核用户Id：当前登陆用户Id；审核通过日期：当期系统日期；当前页面关闭，显示待审核商户列表；商户清算变更：查询条件：商户号、终端号；显示信息：该商户

10、清算标志、签约费率、开户行名称、开户行行号、账户姓名、账户号；可对以上信息进行修改；商户查询：查询条件：商户号、终端号、所属区域、录入时间、审核状态、商户名称查询结果显示字段为：序号、商户号、商户名称、法人、手机号、所属区域、商户状态、录入时间、查看详情点击查看详情，进入详情页面，将商户信息全部显示出来；具有相应修改权限的用户，可选中某条记录，点击修改按钮，进入修改页面；修改界面，只能修改基本信息，不包含商户清算信息（签约费率、清算银行、清算账户等）；终端查询：查询条件：终端号、联系人、终端状态查询结果显示字段为：序号、商户号、终端号、小票抬头、联系人、手机号、终端状态、录入时间、查看详情点击

11、查看详情，进入详情页面，将终端信息全部显示出来；具有相应修改权限的用户，可选中某条记录，点击修改按钮，进入修改页面；l 渠道管理菜单目录结构：渠道管理 渠道地址管理 渠道商户管理 渠道费率管理功能实现：渠道地址管理：点击默认显示所有渠道地址信息，字段如下：序号、渠道名称、IP地址、端口、TPDU、HEADER、机构号、渠道状态、渠道密钥、开通日期；根据登陆用户权限，显示功能按钮（新增、修改），点击新增，弹出新增窗口，录入信息如下：渠道名称、IP地址、端口、TPDU、HEADER、机构号、渠道密钥；点击修改，可对以上信息包括渠道状态进行修改；渠道商户管理：查询字段：渠道商户号、渠道终端号、代理商

12、、地区；点击默认显示所有渠道商户信息，字段如下：序号、渠道商户名称、渠道商户号、渠道终端号、渠道批次号、渠道流水号、渠道状态、渠道类型、开通日期、详细信息；点击详细，显示以上信息外加所属地址、所属代理商、地区Id、资金池；根据登陆用户权限，显示功能按钮（新增、修改、批量导入），点击新增，弹出新增窗口，录入信息如下：渠道商户名称、渠道商户号、渠道终端号、终端主密钥、渠道类型、选择渠道费率、选择代理商、选择地区；点击修改，可对以上信息包括渠道状态进行修改；渠道费率管理：点击默认显示所有渠道费率信息，字段如下：序号、费率名称、费率类型、费率点数、封顶金额、录入日期；根据登陆用户权限，显示功能按钮（新

13、增、修改、删除），点击新增，弹出新增窗口，录入信息如下：费率名称、费率类型、费率点数、封顶金额、录入日期；点击修改，可对以上信息进行修改；点击删除，删除相应费率；l 机具管理菜单目录结构：机具管理 机具型号管理 机具入库 机具查询功能实现：机具型号管理：点击默认显示所有机具型号信息，字段如下：序号、品牌名称、型号、类型、备注、录入日期；根据登陆用户权限，显示功能按钮（新增、修改、删除），点击新增，弹出新增窗口，下拉选择品牌名称、型号、类型、备注；点击修改，可对以上信息进行修改；点击删除，删除相应机型；机具入库：录入进货批次信息：进货批次号、下拉选择品牌、下拉选择型号、下拉选择入网类型、数量、进

14、货单价、进货总价；进货批次号生产规则，默认显示8位当前日期+2位顺序位；整理机具SN号，制作txt或者excel文件，txt格式为 批次号，机具SN号 中间以逗号分割，将改文件导入，插入device_info，其余字段给默认值；机具查询：操作表名（device_info）；查询条件：品牌、型号、机具SN号、机具状态、终端号；显示信息如下：品牌、型号、类型、SN号、所属代理商、状态、录入时期、终端号、绑定日期当状态为已绑定时，终端号跟绑定日期有值，且点击终端号，链接至终端详细信息；l 交易管理菜单目录结构：交易管理 当前交易查询 历史交易查询 交易汇总查询功能实现：当前交易查询：查询条件：起始日

15、期、结束日期、交易类型、手机号、会员姓名、交易金额、会员号、交易状态、商户号、终端号、流水号、卡号显示信息：交易日期、交易时间、商户、终端号、流水号、消费类型、卡号、会员姓名、手机号、交易金额、交易状态、应答码、详细点击详细，进入交易详情界面；点击手机号，进入会员详细信息界面；点击商户，进入商户详细信息界面；历史交易查询：查询条件：交易日期、交易类型、手机号、会员姓名、交易金额、会员号、交易状态、商户号、终端号、流水号、卡号此处，先考虑一张历史表，根据实际数据量，来进行分表处理，如果有分表出现，时，查询条件，需先选择过往年份或月份；显示信息：交易日期、交易时间、商户、终端号、流水号、消费类型、

16、卡号、会员姓名、手机号、交易金额、交易状态、消费类型、详细点击详细，进入交易详情界面；点击手机号，进入会员详细信息界面；点击商户，进入商户详细信息界面；交易汇总查询：批处理：每天凌晨1点，对前一天交易数据进行统计汇总，将汇总信息录入汇总表；查询条件：交易日期、交易类型、代理商、商户号、终端号（商户角色登入时）显示信息：序号、汇总日期、代理商、商户号、终端号（商户角色显示）、交易类别、交易笔数、交易金额、交易积分、手续费、结算金额、分润金额；l 差错管理菜单目录结构：差错管理 差错交易查询 调单申请 调单审核功能实现：当前交易查询：查询条件：对账日期、代理商、商户号、终端号、状态显示信息：序号、

17、对账日期、差错类别、交易日期、交易时间、代理商编号、商户号、终端号、流水号、批次号、卡号、交易金额、处理状态、操作（处理完成）；清算人员根据实际处理情况，可对某条不平记录进行状态更改操作；调单申请：录入信息：交易日期、代理商、商户号、终端号、流水号、检索参考号、交易金额、卡号、最晚期限、申请类型、发起方、上传凭证、备注；录入时，自动去匹配交易流水表，更改patchStat；调单审核：查询条件：代理商、商户号、终端号、发起方、发起类型、交易日期、卡号、检索参考号、批处理状态；默认显示，调单申请状态的记录；序号、机构号、商户号、终端号、卡号、交易金额、交易时间、检索参考号、最晚处理期限、发起方、发

18、起类型、调单状态、批处理状态、操作点击操作，进入详情操作页面，显示调单详细信息，可对该条记录进行审核驳回、审核通过待确认、确认通过等操作；l 会员卡管理菜单目录结构：会员卡管理 卡Bin查询 制卡申请 制卡审核 卡库存管理 推广员领卡录入 推广员退卡受理 会员卡查询 批量充值功能实现：卡BIN查询：输入卡bin，查询对应卡bin运营商信息；制卡申请：输入元素：选择卡名称、代理商、选择卡种类、制卡数量、制卡批次、起始卡号、结束卡号、卡有效期、服务码、制卡序号;新增时根据卡机构需要取到卡bin号；须先判断卡bin+卡种类+制卡批次 在表中不存在；需要校验结束卡号 - 起始卡号 = 制卡数量 、 卡

19、有效期需要大于当前日期；服务码固定填500；制卡序号，前11固定为 RY+yyMM+机构Id+批次（ RY141100101 ）后5位为00001 累加；申请状态为 0；制卡审核：更改审核状态，通过后，出现“生成制卡文件”按钮；生成卡号、二磁道、密码等数据，插入card_info表的同时，生成制卡文件；制卡文件生成好后，以zip格式提示下载；卡号生成规则：6位卡bin + 4位卡种类 + 2位批次+ 6位起始卡号 + 1位校验位902001 0001 01 000001 3校验位算法为Luhn 模10“隔位2倍加”的计算公式；二磁道生成规则：；卡号 = 有效期+服务码+补0？ 除去起始位总共3

20、7位；9020010001000000013=15055000000000000？制卡文件格式：制卡序号 | 卡号 | 密码 | 有效期 | 二磁道信息 |RY14110010100001|9020010001000000013|123456|1505|;9020010001000000012=15055000000000000?|插入card_info时，密码跟二磁道信息采用MD5加密，二磁道加密数据去除首尾符号；状态初始值为1未启用；卡库存管理：每天凌晨对前一天卡数据进行统计，将统计数据记录在card_total_info中；显示卡库存表信息：序号、统计日期、卡总数、未启用总数、出库未激活

21、数、激活卡总数、冻结卡总数、挂失卡总数；推广员领卡受理：录入信息：代理商、会员Id（手机号）、数量、卡号前9位、起始卡号、结束卡号；推广员前提是平台会员；领用类别为推广员，状态置为0，领卡日期默认当前；将推广员会员Id赋值给分配卡号段的extMemberId字段；推广员退卡受理输入起始卡号、结束卡号、数量；将该批卡原本设置的推广员Id置为空；会员卡查询：查询条件：选择卡机构、卡号；显示卡号详细信息；会员卡批量充值：输入起始卡号、结束卡号、数量、充值金额；可在未启用状态进行批量充值；l 会员管理菜单目录结构：会员管理 （后台） 会员查询 会员等级设置功能实现：后台功能：会员查询：查询条件：手机号

22、码，会员卡号，会员等级、消费金额区间、积分余额区间、性别等；显示信息：序号、手机号、姓名、卡号、会员等级、会员类型、会员状态，详细信息点击详细，显示会员详细资料；会员等级设置：对该表进行新增、修改、删除的操作；l 营销管理 菜单目录结构：营销管理 活动设置 优惠券设置 功能实现：活动设置：默认显示登陆用户角色的活动列表：显示信息：门店名 | 活动标题 | 起始时间 | 结束时间 | 活动说明工具栏有新增、修改、删除的操作新增输入元素：商户发起：商户号、活动标题、活动说明、选择门店、活动起始时间、活动结束时间、输入优惠信息(操作favour_info)；代理商发起：代理商编号，活动标题、活动说明

23、、活动起始时间、活动结束时间、输入优惠信息(操作favour_info)；一个活动可能包含多条优惠信息；优惠券设置：默认显示该商户优惠券列表：显示信息：优惠券名称 | 券类型 | 有效期 | 面值 | 是否支持前台领取工具栏有新增、修改、删除的操作新增输入元素：商户号、优惠券名称、券类型、数量、面值、有效期、券使用类型、适用门店、使用条件、是否支持前台领取；当券使用类型为所有时，适用门店字段为空，当为部分门店时，需加载所属门店，参与活动的终端号以 | 符号进行间隔保存；当插入coupon_info成功后，根据优惠券数量，插入相应数量记录至sub_coupon_info中个，couponNo的编

24、码规则为，2位年份 + 2位媒质种类+ 商户号末4位+6位顺序位 纸质为01，电子券为02 ，如14 5401 01 000001 总共14位l 清算管理菜单目录结构：交易管理 银联渠道对账 基础费率设置 清算报表下载 提现申请 功能实现：银联渠道对账：导入银联对账文件，解析对账文件，跟数据库流水进行比较，如果平，交易流水对账标志位checkStatus = 2，不平 checkStatus =1，长款情况（渠道有本地无），将该条记录插入对账信息表中，标志为长款情况；短款情况（渠道无本地有），将该条记录插入对账信息表中，标志为短款情况；此处以银联渠道为例，实际根据上游渠道来解析对账文件，流程不变；基础费率设置：待定清算报表下载：输入元素：清算日期，代理商编号，商户号显示信息：序号，代理商编号，商户号，交易笔数，交易金额，手续费，结算金额，账户名，账号，联行号，开户行，明细对账操作后，统计对账平的记录；可对查询信息进行excel导出；点击明细，进入商户交易明细查询；提现申请：默认显示当前待提现申请信息；查询条件：提现日期，类型，角色，状态；显示信息：序号，提现日期，类型，提现角色，提现金额，状态，账户名，开户行，账号，