---
# System prepended metadata

title: 国行APP

---

# 国行APP
改善过去需针对不同功能安装特定APP，致使用户需安装多个APP体验不佳问题，设计一款支持多功能模式APP，提供用户可管理个人银行卡、弹性选用各种交易模式并查看报表数据、搜集手机短信或微信简讯…etc，满足用户仅需使用一个APP便可统一管理各项功能的需求，减少阻力，提升用户使用产品舒适度。

## 系统结构
- 系统需求：Android 9或以上版本
- API加解密流程： http://doc.1-pay.co:8480/pages/viewpage.action?pageId=328373

从客户端登入连线至金流管理系统并取得可用线路及检查APP版本更新，金流后台依各项功能执行需求将相关数据转抛至cashpool，客户端与服务端于各项请求过程中，需进行客户端与服务端的安全验证。

START(UPDATED LINK)
## 阶段性实作计划及修订纪录 
- [服务端PRD](https://hackmd.io/@B7_Y-C9pSS63AbqX_9kZlw/rkiPXQzej)

| APP功能项目 | 服务端功能项目 |  修订日期 | 修订人员 | 
| ---------- | ---- |  ---------- | ---- | 
| [API加解密](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E7%B3%BB%E7%BB%9F%E7%BB%93%E6%9E%84) | [API加解密](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E7%B3%BB%E7%BB%9F%E7%BB%93%E6%9E%84)<br>Paymentflow资料转拋Cashpool |  2022.06.17 | Claire |
| [2.会员帐户相关](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#2-%E4%BC%9A%E5%91%98%E5%B8%90%E5%8F%B7%E7%9B%B8%E5%85%B3) | [登入API](http://doc.1-pay.co:8480/pages/viewpage.action?pageId=328348)<br>註冊API<br>忘記密碼API<br>[1-1.新增国行功能模块](https://hackmd.io/IPvfsO3lSeCQojfZuh9WAA?both#1-1-%E6%96%B0%E5%A2%9E%E4%B8%BB%E5%8A%9F%E8%83%BD-%E5%9B%BD%E8%A1%8C)<br>[2-1.新增发送邮箱验证API](https://hackmd.io/IPvfsO3lSeCQojfZuh9WAA?view#2-1-%E6%96%B0%E5%A2%9E%E5%8F%91%E9%80%81%E9%82%AE%E7%AE%B1%E9%AA%8C%E8%AF%81) |  2022.06.28 | Claire |
| [3-1.最新消息](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#3-1-%E6%9C%80%E6%96%B0%E6%B6%88%E6%81%AF)<br>[3-2.功能选单](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#3-2-%E5%8A%9F%E8%83%BD%E6%8C%89%E9%88%95)<br>[4-2.简讯收发设定](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#4-2-%E7%AE%80%E8%AE%AF%E6%94%B6%E5%8F%91%E8%AE%BE%E5%AE%9A) | 国行关联帐号<br>级别层级及费率结构 | 2022.07.18 | Claire |
| [新增银行卡](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#5-2-%E6%96%B0%E5%A2%9E%E9%93%B6%E8%A1%8C%E5%8D%A1)<BR>[扫脸影片](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E6%89%AB%E8%84%B8%E5%BD%B1%E7%89%87) | 新增银行卡API |  2022.07.29 | Claire |
| [修改密码](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#4-4-%E4%BF%AE%E6%94%B9%E5%AF%86%E7%A0%81)<br>[银行卡清单](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#5-1-%E9%93%B6%E8%A1%8C%E5%8D%A1%E6%B8%85%E5%8D%95)<BR>[銀行卡清單(按鈕及狀態對照)](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#5-1-%E9%93%B6%E8%A1%8C%E5%8D%A1%E6%B8%85%E5%8D%95)<br>[编辑银行卡](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#5-3-%E7%B7%A8%E8%BC%AF%E9%93%B6%E8%A1%8C%E5%8D%A1) | 银行卡列表清单API<br>编辑银行卡API<BR>[國行銀行卡代碼](https://hackmd.io/IPvfsO3lSeCQojfZuh9WAA?view#1-2-%E5%9B%BD%E8%A1%8C%E4%B8%93%E5%B1%9E%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BB%A3%E7%A0%81) |  2022.08.09 | Claire |
| [金鼎购币](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#6-1-%E9%87%91%E9%BC%8E%E8%B4%AD%E5%B8%81) | 购买金币流程相关API<br>银行卡资料结构整合<br>[2-2.金宝银行卡管理页面](https://hackmd.io/IPvfsO3lSeCQojfZuh9WAA?view#2-2-%E9%87%91%E5%AE%9D-%E6%96%B0%E5%A2%9E%E5%AD%90%E5%8A%9F%E8%83%BD-%E9%93%B6%E8%A1%8C%E5%8D%A1%E7%AE%A1%E7%90%86) |  2022.08.23 | Claire |
| [订单记录](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#6-1-1-%E8%AE%A2%E5%8D%95%E8%AE%B0%E5%BD%951)<br>[金币记录](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#6-1-2-%E9%87%91%E5%B8%81%E8%AE%B0%E5%BD%951) | 订单记录API<br>金币记录API |  2022.09.04 | Claire |
| [佣金](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#6-1-4-%E4%BD%A3%E9%87%91)<br>实装金鼎助手半自动转帐功能<br>转帐助手整并前置  |  佣金记录API<br>佣金提领API<br>金鼎助手API  | 2022.09.28 | Claire |
| 多域名选线<br>线上更新<br>[设定精灵](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E8%AE%BE%E5%AE%9A%E7%B2%BE%E7%81%B5)  | [更換銀行卡流程](https://hackmd.io/IPvfsO3lSeCQojfZuh9WAA?view#1-3-%E6%9B%B4%E6%8D%A2%E5%8D%A1%E7%89%87%E7%A7%8D%E7%B1%BB%E6%B5%81%E7%A8%8B) |  2022.10.31 | Claire |
| 转帐助手API<br>TrasferHelper界面<br>实装转帐助手全自动转帐功能<br>  | 转帐助手API<br>APP版本部份更新功能界面 |  2022.11.14 | Claire |
| 心跳<br>  |  |  2022 | Claire |
| 上传log   |    |    |    |


## 系统结构
- 系统需求：Android 9或以上版本
- API加解密流程： http://doc.1-pay.co:8480/pages/viewpage.action?pageId=328373

从客户端登入连线至金流管理系统并取得可用线路及检查APP版本更新，金流后台依各项功能执行需求将相关数据转抛至cashpool，客户端与服务端于各项请求过程中，需进行客户端与服务端的安全验证。

## 【APP】
- UI Prototype Flow：http://doc.1-pay.co:8480/display/CNAllInOne/UI+Prototype+Flow
- UI DEMO：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=130%3A2015&scaling=scale-down&page-id=40%3A175&starting-point-node-id=130%3A2015&show-proto-sidebar=1
- API：http://doc.1-pay.co:8480/display/CNAllInOne/Chapter+3+API+v2
## 1. 应用程序相关
### 1-1. 选线机制
- UI：LINK WAIT TO BE COMPELETED
会员使用APP登入时，APP自动检查当前线路并针对可用线路进行连线，

> #### 金流后台操作补充：
> 需于[综合管理>网域管理]针对欲支持此APP的网址，进入修改页面：勾选[金流应用>APP版本管理]对应包名。
> ![](https://i.imgur.com/x01ulTF.jpg)


### 1-2. APP更新流程
当国行APP生命週期(OnCreate）阶段时，需与paymetflow服务端获取国行APP的版本资讯，若是服务端版本较新时，可针对全部或部份会员进行APP线上更新。
- UI
    - [非强制更新](https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=2222%3A20115&scaling=scale-down&page-id=40%3A175&starting-point-node-id=2222%3A20115&show-proto-sidebar=1)
    - [强制更新](https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=2222%3A20710&scaling=scale-down&page-id=40%3A175&starting-point-node-id=2222%3A20710&show-proto-sidebar=1)
- 更新APP流程請見：http://doc.1-pay.co:8480/pages/viewpage.action?pageId=328379
- 线上更新APK存放位置分两处
    - 七牛云：猫狗、适配银行版本
    - paymentflow：国行本体=>以会员帐号控制，针对全部或部份会员进行APP线上更新
- APP更新提示弹框依「是否强制更新」区分为两种弹框
- 更新触发时机点
    - 点击国行icon开启APP进行登入时
    - 点击[综合设定]页面`检查更新`按钮时
    - 点击[银行卡管理]银行卡的`执行`按钮时

> #### 金流后台操作补充：
> 配合此次新增APP，需于[金流应用>APP版本管理]新增上传此APP.apk，「空间名称」使用「jindin-helper-apk」。
> ![](https://i.imgur.com/IHxMtL1.png)

## 2. 会员帐号相关
### 2-1. 登入
- UI：https://ckoi43.axshare.com/#id=it27pq&p=%E7%99%BB%E5%85%A5&g=1
- 登入流程：http://doc.1-pay.co:8480/pages/viewpage.action?pageId=328376
- 规格

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| logo  | 图片 |  --  | 1.显示商标图片<br>2.图片依开发定义 |
| 请输入您的登入帐号  | textbox |  Y  | 1.只可输入英文数字，字母不分大小写<br>2.长度：最多20位 |
| 请输入您的登入密码<br>(8~15位英数混合)  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示" * "<br>4.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击点击眼睛:eye:图示后显示明码 |
| 记住我  | checkbox |  N  | 勾选后，记住最后一次登入帐号，下次登入时自动带入前次登入的帐号 |
| 登入 | button |  --  | 点击后，需检查帐号字段内容是否符合规格<br>&nbsp;&nbsp;- 否：当前页面出现提示弹框"请输入正确帐号"<br>&nbsp;&nbsp;- 是：透过==登入API==进行登入，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至主页<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |
| 免费注册 | button |  --  | 点击后，切换至注册页面 |
| 忘记密码 | button |  --  | 点击后，切换至忘记密码页面 |
| 联络我们 | button |  --  | 点击后，切换至联络我们页面 |
| %版本名称% | 文字显示 |  --  | 手机页面右下角显示当前APP的版本名称 |

### 2-2. 注册
- UI：https://ckoi43.axshare.com/#id=jywm8u&p=%E6%B3%A8%E5%86%8C&g=1
- 规格

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| < 免费注册 | button |  --  | 点击后，切换至登入页面 |
| 请输入您的登入帐号*  | textbox |  Y  | 1.只可输入英文数字，字母不分大小写<br>2.长度：最多20位 |
| 请输入您的登入密码*<br>8~15位英数混合  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示" * "<br>4.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击点击眼睛:eye:图示后显示明码 |
| 请确认输入您的登入密码*  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.需与「密码」字段内容一致<br>4.输入字串显示" * "<br>5.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击点击眼睛:eye:图示后显示明码 |
| 请输入您的昵称*  | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
| 请输入您个人绑定的邮箱*  | textbox |  Y  | 1.输入内容需合乎邮箱格式：只可输入英文字母、正整数0~9、@、.、_、-，字母不分大小写<br>2.长度：最多30位 |
| 请选择您的安全问题*  | 单选式下拉选单 |  Y  | 选单内容(由上至下)：第一只宠物名称、您的出生地、初中的学校名称、初恋发生的年份 |
| 请输入您安全问题的答案*  | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
| 请输入您的邀请码*  | textbox |  Y  | 1.英数混和，字母不分大小写<br>2.长度：固定6位 |
| 一键注册 | button |  --  | 1.点击后，透过==注册API==将注册信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至登入页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |

### 2-3. 忘记密码
- UI：https://ckoi43.axshare.com/#id=gzfum2&p=%E5%BF%98%E8%AE%B0%E5%AF%86%E7%A0%81&g=1

显示「安全问答」、「邮箱验证」两分页，点击对应分页后，切换至对应功能页面。

- 安全问答 规格

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| 请输入您的登入帐号*  | textbox |  Y  | 1.只可输入英文数字，字母不分大小写<br>2.长度：最多20位 |
| 请选择您注册时的安全问题*  | 单选式下拉选单 |  Y  | 选单内容(由上至下)：第一只宠物名称、您的出生地、初中的学校名称、初恋发生的年份 |
| 请输入您安全问题的答案*  | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
| 请输入您的新登入密码*<br>(8~15位英数混合)  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示" * "<br>3.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击眼睛:eye:图示后显示明码 |
| 请确认输入您的新登入密码*  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.需与「新密码」字段内容一致<br>3.输入字串显示" * "<br>4.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击点击眼睛:eye:图示后显示明码 |
| 修改密码 | button |  --  | 1.点击后，透过==修改密码API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至登入页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |
| 返回 | button |  --  | 点击后，切换至登入页面 |

- 邮箱验证 规格

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| 请输入您注册时绑定的邮箱*  | textbox |  Y  | 1.输入内容需合乎邮箱格式：只可输入英文字母、正整数0~9、@、.、_、-，字母不分大小写<br>2.长度：最多30位 |
| 请输入验证码*  | textbox |  Y  | 1.英数混和，字母不分大小写<br>2.长度：固定6位 |
| 发送验证 | button |  --  | 1.点击后，透过==发送邮箱验证API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：当前页面出现提示弹框<br>&nbsp;&nbsp;&nbsp;&nbsp;"邮件已发送成功，<br>&nbsp;&nbsp;&nbsp;&nbsp;请留意您注册绑定的邮箱信件。""<br>=>&nbsp;**只有点击弹框内`关闭`按钮才可关闭弹框切换并停留当前页面**<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |
| 请输入您的新登入密码*<br>(8~15位英数混合)  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示" * "<br>3.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击眼睛:eye:图示后显示明码 |
| 请确认输入您的新登入密码*  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.需与「新密码」字段内容一致<br>4.输入字串显示" * "<br>5.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击点击眼睛:eye:图示后显示明码 |
| 若您忘记帐号、密码及您的安全问答，<br>我们将使用您注册时的绑定邮箱，<br>协助您取回帐号及重置密码。 | 文字显示 |  --  | 页面显示此段文字信息 |
| 修改密码 | button |  --  | 1.点击后，透过==修改密码API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至登入页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |
| 返回 | button |  --  | 点击后，切换至登入页面 |


### 2-4. 联络我们
- UI：https://ckoi43.axshare.com/#id=go77vx&p=%E8%81%94%E7%BB%9C%E6%88%91%E4%BB%AC&g=1
- 规格

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| < | button |  --  | 点击后，切换至登入页面 |
| --  | 文字连结 |  --  | 1.显示==联系资讯API==回传的联系资讯连结<br>2.页面预设显示为空白页面，金流后台有设定联系资讯时才显示联系信息<br>3.若该联系资讯帐号的"url_scheme"有url连结，该联系帐号文字应以该url加入显示连结，点击后可开启该连结(**统一以手机浏览器开启连结)**<br>4.联系信息右侧显示复制图示，点击图示可复制联系信息文字 |
| 返回 | button |  --  | 点击后，切换至登入页面 |

> #### 金流后台操作补充：
> 新增联系资讯，请于[独角兽>联系资料]进行新增。
> ![](https://i.imgur.com/lTOfLfD.png)

## 3. 主页
### 3-1. 最新消息
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=132%3A1015&scaling=scale-down&page-id=40%3A175&starting-point-node-id=132%3A1015&show-proto-sidebar=1
透过==最新消息API==取回最新消息资讯
- 显示最新消息标题
    - 最多显示3笔，字数超过单行可容纳范围直接显示可显示字数即可(避免超框，不需自动换行)
    - 由上至下排序：➊置顶、➋发布时间递减=>有置顶标记且发布时间最新的显示最上方
    - 文字内容可点击，点击后，切换至最新消息页面
- 最新消息页面
    - 显示当前启用的最新消息清单，字数超过单行可容纳范围直接显示可显示字数即可(避免超框，不需自动换行)
        - 显示格式：最新消息 发布时间yyyy-mm-dd 标题
    - 由上至下排序：➊置顶、➋发布时间递减=>有置顶标记且发布时间最新的显示最上方
    - 文字内容可点击，点击后，切换至最新消息内容页面
    - 返回：button，点击后，切换至主页

- 内容页面

    | 栏位   | 格式 |  说明 |
    | ---------- |  :--------: | -------- |
    | -- | 文字显示 | 显示当前最新消息标题，字数超过单行可容纳范围，**需自动换行** |
    | 发布时间： | 文字显示 | 1.显示当前最新消息的发布时间<br>2.时间格式：yyyy-mm-dd hh:mm:ss |
    | -- | 文字显示 | 1.显示当前最新消息内容，**内容样式需支援显示html格式**，字数超过单行可容纳范围，**需自动换行** |
    | 返回 | button |   点击后，切换至最新消息页面 |

> #### 金流后台操作补充：
> 新增最新消息，请于[国行>最新消息]进行新增。
> ![](https://i.imgur.com/xcj4SN4.jpg)

### 3-2. 即时客服
於主頁點擊![](https://i.imgur.com/R48rswi.png)，以**手机浏览器**开启線上客服连结。
    
### 3-3. 功能按鈕

| 栏位   | 格式 |  说明 |
| ---------- |  :--------: | -------- |
| ![](https://i.imgur.com/JmQv9c6.png) | button | 点击后，切换至即时客服页面 |
| ![](https://i.imgur.com/QY35Ppw.png) | button | 点击后，切换至功能选单页面 |
| ![](https://i.imgur.com/0k1H02B.png) | button | 点击后，切换至使用设定页面 |
| ![](https://i.imgur.com/59E3AZ3.png) | button | 点击后，切换至银行卡管理页面 |
| ![](https://i.imgur.com/fVCHnUq.png) | button | 点击后，切换至报表页面(显示内容待补) |
| ![](https://i.imgur.com/6G5Brbh.png) | button |   点击后，切换至新增银行卡页面 |

### 3-4. 佣金

| 栏位   | 格式 |  说明 |
| ---------- | :----: |  -------- |
| 佣金余额：%金额%(结算中佣金：%金额%) | button | 1.显示格式：%当前用户全部卡片种类佣金余额加总%(%结算中佣金%)<br>&nbsp;&nbsp;- 佣金余额：**不包含**结算中佣金<br>&nbsp;&nbsp;- 结算中佣金：当前佣金提领申请记录不等于「提领完成」或「提领失败」金额总和<br>2.固定显示千分号及小数点后4位<br>3.点击后，切换至佣金提领记录页面 |
| 佣金提领 | button | 点击后，切换至[申请提领](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#3-3-1-%E7%94%B3%E8%AF%B7%E6%8F%90%E9%A2%86)页面 |

#### 3-4-1. 申请提领
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1611%3A23261&scaling=scale-down&page-id=40%3A175&starting-point-node-id=1380%3A10085&show-proto-sidebar=1

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :----: | -------- |
| 佣金总余额 | 文字显示 | - |1.显示格式：当前用户全部卡片种类佣金余额加总(**不包含**结算中佣金)<br>2.固定显示千分号及小数点后4位 |
| 请选择银行别* | 单选式下拉 | Y | 选单内容：显示[综合管理>银行别管理]卡国别为「中国卡」的对应银行别清单 |
| 请输入支行名称* | textbox | Y | 1.输入文字符号不限<br>2.长度：最多20位 |
| 请输入卡号* | textbox | Y | 1.只可输入正整数0~9<br>2.长度：最多20位 |
| 请输入户名* | textbox | Y | 1.输入文字符号不限<br>2.长度：最多20位 |
| 请输入提领金额* | textbox | Y | 1.最小值：1<br>2.只可输入正整数0~9及小数点后2位<br>3.长度：最多18位整数+2位小数 |
| 贴心小叮咛：提领金额最少%金额% | 文字显示 | - | 1.%金额%显示server当前回传的金额数值<br>&nbsp;&nbsp;- 数值来源说明，请见国行会员设置[「返点模式>金鼎」及「关联应用>金鼎」对照表](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E5%9B%BD%E8%A1%8C%E4%BC%9A%E5%91%98%E8%AE%BE%E7%BD%AE%E3%80%8C%E8%BF%94%E7%82%B9%E6%A8%A1%E5%BC%8Fgt%E9%87%91%E9%BC%8E%E3%80%8D%E5%8F%8A%E3%80%8C%E5%85%B3%E8%81%94%E5%BA%94%E7%94%A8gt%E9%87%91%E9%BC%8E%E3%80%8D%E5%AF%B9%E7%85%A7%E8%A1%A8)<br>2. %金额%格式：固定显示千分号及小数点后2位 |
| 确认送出 | button | - | 点击后，透过==佣金提领API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 失败：显示API回传errormessage | 

###### ● 国行会员设置「返点模式>金鼎」及「关联应用>金鼎」对照表
![](https://i.imgur.com/pJVhXY4.png)

#### 3-4-2. 佣金提领记录
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1915%3A16588&scaling=scale-down&page-id=40%3A175&starting-point-node-id=48%3A383

| 栏位  | 格式    |  說明   |
|-------|:---------:|----------------------------------------------------------------------------|
| %各卡片种类佣金余额% | button | 1.由左至右，固定显示「鲔鱼堡、金鼎、金宝」及该会员拥有的对应卡片种类银行卡佣金总余额<br>2.佣金总余额：固定显示千分号及小数点后四位<br>3.点击后，自动切换至对应卡片种类佣金记录页面<br>&nbsp;&nbsp;&nbsp;>&nbsp;- <font color="EF2A26">2022-10-03:现阶段仅先实作「金鼎」</font> |
| 佣金余额：%金额%(结算中佣金：%金额%) | button | 1.显示格式：%当前用户全部卡片种类佣金余额加总%(%结算中佣金%)<br>&nbsp;&nbsp;- 佣金余额：**不包含**结算中佣金<br>&nbsp;&nbsp;- 结算中佣金：当前佣金提领申请记录不等于「提领完成」或「提领失败」金额总和<br>2.固定显示千分号及小数点后4位 |
| 申请提领 | button | 点击后，切换至[申请提领](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#3-3-1-%E7%94%B3%E8%AF%B7%E6%8F%90%E9%A2%86)页面 |

- 查詢條件

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| ![](https://i.imgur.com/iM2BxxM.png) | DatePicker | 1.预设显示当日，ex:2022-08-15~2022-08-15<br>2.最多可查询当日(含)回推30日的佣金提领记录 |
| 查询 | button | 点击后，依查询条件设定显示结果列表 |

- 结果列表
    - 列表栏位标题需冻结，只有列表记录可以上下滑动

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| 订单时间     | 文字显示 | 1.显示记录建立时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss<br>3.依此栏位时间递减排序(最新的记录在列表最上方)  |
| 订单编号      | 文字显示 | 1.显示记录编号<br>2.显示格式：固定15位，ex:PR202208040000001<br>3.点击后，切换至提领详情页面 |
| 交易金额 | 文字显示 | 1.显示提领佣金金额<br>2.固定显示千分号及小数点后2位<BR>3.栏内数值固定显示正数 |
| 状态      | 文字显示 | 1.状态内容：等待中、待审批、处理中、审批不通过、提领失败、提领完成<br>&nbsp;&nbsp;- 蓝色：待审批、处理中<br>&nbsp;&nbsp;- 黄色：等待中<br>&nbsp;&nbsp;- 红色：审批不通过、提领失败<br>&nbsp;&nbsp;- 绿色：提领完成 |

- 提领详情
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1611%3A27482&scaling=scale-down&page-id=40%3A175&starting-point-node-id=1380%3A10085&show-proto-sidebar=1


| 栏位   | 格式 | 说明 |
| ---------- | :----: |  -------- |
| 银行别 | 文字显示 | 显示申请提领时选取的银行别名称 |
| 支行 | 文字显示 | 显示申请提领时设定的银行支行名称 |
| 银行卡号 | 文字显示 | 显示申请提领时设定的银行卡号 |
| 户名 | 文字显示| 显示申请提领时设定的银行卡户名 |
| 提领金额 | 文字显示 | 1.显示申请提领时设定的提领金额<br>2.固定显示千分号及小数点后4位 |
| 状态      | 文字显示 | 显示提领当前状态，内容：等待中、待审批、处理中、审批不通过、提领失败、提领完成<br>&nbsp;&nbsp;- 蓝色：待审批、处理中<br>&nbsp;&nbsp;- 黄色：等待中<br>&nbsp;&nbsp;- 红色：审批不通过、提领失败<br>&nbsp;&nbsp;- 绿色：提领完成 |
| 备注 | 文字显示 | 显示server回传的提领审批原因<br>&nbsp;&nbsp;- 状态「待审批」时此栏位显示为空 |


## 4. 综合设定
### 4-1. 功能选单
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=2200%3A13861&scaling=scale-down&page-id=40%3A175&starting-point-node-id=2200%3A13861&show-proto-sidebar=1

| 栏位   | 格式 |  说明 |
| ---------- |  :--------: | -------- |
| ![](https://i.imgur.com/sbx2G8G.png) | 文字显示 | 1.显示当前登入会员暱称首字<br>2.不论中文、大小写字母…任何字元，皆直接取用首字显示<br>ex:昵称"roxy"，圆圈内显示"r"；昵称"罗克西"，圆圈内显示"罗" |
| ![](https://i.imgur.com/q0kBrfG.png) | 文字显示 | 显示当前登入会员登入信息，由上至下：昵称、会员登入帐号、邀请码<br>&nbsp;&nbsp;- 会员登入帐号：前后各2字元固定显示明码，其他字元显示暗码" * "<br>&nbsp;&nbsp;- 邀请码右侧显示![](https://i.imgur.com/eK7n91Z.png)按钮，点击后可复制六码邀请码字串 |
| 联络我们 | button | 点击后，切换至联络我们页面 |
| 修改密码 | button |  点击后，切换至修改密码页面 |
| 注销 | button |  点击后，登出用户，切换至登入页面 |

### 4-2. 綜合设定
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=2230%3A15252&scaling=scale-down&page-id=40%3A175&starting-point-node-id=2230%3A15252&show-proto-sidebar=1
- 取回的SMS回传paymentflow再转抛cashpool，资料将显示于[cashpool>簡訊>訊息]

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| < 综合设定 | button |  --  | 点击后，切换至主页 |
| 连结网址 | textbox |  N  | 1.输入格式及长度依开发定义<br>2.依右侧`测试` `变更`按钮状态影响输入框是否可输入：<br>&nbsp;&nbsp;- `测试`按钮enable，输入框可输入<br>&nbsp;&nbsp;- `变更`按钮enable，输入框不可输入 |
| 测试 | button |  --  | 1.预设disable，若已设定过则记忆前次状态<br>2.点击后，`测试`按钮disable 且 `变更`按钮enable |
| 变更 | button |  --  | 1.预设enable，若已设定过则记忆前次状态<br>2.点击后，`测试`按钮enable 且 `变更`按钮disable |
| 简讯收发设定 | 文字显示 | -- | -- |
| SIM 1* | textbox | Y | 1.只可输入正整数0~9<br>2.长度：11位<br>3.依右侧![](https://i.imgur.com/XtfgVHS.jpg)开关状态影响输入框是否可输入：<br>&nbsp;&nbsp;- ![](https://i.imgur.com/XtfgVHS.jpg)ON，输入框不可输入<br>&nbsp;&nbsp;- ![](https://i.imgur.com/qeFrVXE.jpg)OFF，输入框可输入<BR>4.成功取得系统SIM1的手机号时，则使用SIM1的手机号；无法取得系统SIM1的手机号时，直接使用用户手动输入的手机号 |
| ![](https://i.imgur.com/XtfgVHS.jpg) | switch |  --  | 1.预设disable，若已设定过则记忆前次状态<br>2.需检查「SIM 1」有输入值时，才允许ON<br>&nbsp;&nbsp;- 否则出现提示"请输入您SIM 1的手机号。"(提示样式依开发定义) |
| SIM 2 | textbox | N | 1.只可输入正整数0~9<br>2.长度：11位<br>3.依右侧![](https://i.imgur.com/XtfgVHS.jpg)开关状态影响输入框是否可输入：<br>&nbsp;&nbsp;- ![](https://i.imgur.com/XtfgVHS.jpg)ON，输入框不可输入<br>&nbsp;&nbsp;-  ![](https://i.imgur.com/qeFrVXE.jpg)OFF，输入框可输入 |
| ![](https://i.imgur.com/XtfgVHS.jpg) | switch |  --  | 1.预设disable，若已设定过则记忆前次状态<br>2.需检查「SIM 2」有输入值时，才允许ON<br>&nbsp;&nbsp;-否则出现提示"请输入您SIM 2的手机号。"(提示样式依开发定义) |
| 系统资讯 | 文字显示 |  --  | 显示手机系统版本、品牌、手机型号 |
| %版本名称% | 文字显示 |  --  | 手机页面右下角显示当前APP的版本名称 |
| 检查更新 | button |  --  | 点击后，使用==更新APP API==向Server取得最新版本apk下载连结，依据当前版本是否为最新版本显示不用提示内容(提示样式依开发定义)<br>&nbsp;&nbsp;&nbsp;&nbsp;- 非最新版本：提示"检测到新版本，请火速升级。"<br>&nbsp;&nbsp;&nbsp;&nbsp;- 是最新版本：提示"目前已是最新版本" |
| 设定精灵 | button | -- | 点击后，可自动启用APP所需相关设置，自动设置项目请看[设定精灵](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E8%AE%BE%E5%AE%9A%E7%B2%BE%E7%81%B5) |
| 上传日志 | button |  --  | 点击后，上传log档至七牛云 |

#### 设定精灵
Claire check JIRA
點擊`設定精靈`自動切換至手機輔助功能，讓APP用戶手動啟用輔助功能以便使用自动启用手机设置功能

:::info
- 精灵功能适配手机型号：VIVO V1901A
- 其他型号及厂牌手机因设置界面略有不同，届时若发生未完整自动设置完成，将由APP用户进行人工设置。
:::

- 执行设定精灵需开启的相关内容如下
    - 关闭WIFI自动更新
    - 猫狗权限
        - 开启存储、电话、相机
        - 单项权限设置：开启 自启动、悬浮窗、桌面快捷方式、锁屏显示、后台弹出界面
    - 各银行权限
        - 开启存储、电话、相机
    - 杨枝甘露(简讯收发)权限
        - 开启讯息通知
        - 关闭短信保护设定：关闭验证码安全保护、财务信息保护、锁屏时隐藏验证码
        - 关闭省电模式

### 4-3. 修改密码
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=114%3A809&scaling=scale-down&page-id=40%3A175&starting-point-node-id=114%3A809&show-proto-sidebar=1

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| < 修改密码 | button |  --  | 点击后，切换至主页 |
| 请输入您的旧密码*<br>(8~15位英数混合)  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示" * "<br>3.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击眼睛:eye:图示后显示明码 |
| 请输入您的新密码*  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示" * "<br>4.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击点击眼睛:eye:图示后显示明码 |
| 请确认输入您的新密码*  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.需与「新密码」字段内容一致<br>4.输入字串显示" * "<br>5.栏位最右侧显示眼睛:eye:图示，预设密码显示暗码，点击点击眼睛:eye:图示后显示明码 |
| 修改密码 | button |  --  | 1.点击后，透过==修改密码API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至登入页<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |


## 5. 银行卡管理
#### 页面切换流程概述
- 主页/银行卡管理列表，点击![](https://i.imgur.com/5lnMg1A.png)按
钮→切换至新增银行卡共通页面→点击`下一步`按钮依「请选择卡片种类」选项，切换至对应页面：
    - 金鼎：切换至「新增银行卡(金鼎)」
    - 金宝：切换至「新增银行卡(%鲔鱼堡1/金宝%)」→点击`完成`按钮→切换至「银行卡管理」页面
    - 鲔鱼堡：切换至「新增银行卡(%鲔鱼堡1/金宝%)」→点击`下一步`按钮→切换至「新增银行卡(鲔鱼堡2)」
	        - 点击`完成`按钮→切换至「银行卡管理」页面
            - 点击`录制扫脸`按钮→切换至「扫脸影片」页面→点击`录制视频`按钮→切换至「录制影片」页面→点击`开始录影`→录像秒数跑完后`上传影片`按钮更新为enable→点击`上传影片`按钮切换至「银行卡管理」页面并出现"上传中"提示(APP功能暂不可使用避免用户中断视频上传)→上传成功时提示文字更新为"上传成功"→点击提示弹框`关闭`按钮，关闭弹框停留当前银行卡管理清单页面

:::info
页面标题「新增银行卡(%鲔鱼堡1/金宝%)」及页面功能按钮Tips：
- 卡片种类「金宝」时，页面标题显示「新增银行卡(金宝)，页面按钮显示`完成`
- 卡片种类「鲔鱼堡」时，页面标题显示「新增银行卡(鲔鱼堡)，页面按钮显示`下一步`
:::

### 5-1. 银行卡清单
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=136%3A1613&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1613&show-proto-sidebar=1
- 显示该帐号银行卡清单
    - 由上至下，依银行卡建立时间递减排序
    - 银行卡清单的银行卡信息显示**当前卡片种类对应的状态内容**
        - 举例：银行卡曾设定卡片种类为「金宝」及「金鼎」，当APP用户切换至银行卡清单时，server回传该银行卡当前卡片种类为「金鼎」，故银行卡状态为「待审批」时会显示`验证`按钮

| 栏位   | 格式 | 说明 |
| ---------- | :----: | -------- |
| 请输入银行卡号 | 搜寻框 | 1.选填，只可输入数字<br>2.长度：最多20位<br>3.输入当下即时模糊查询，筛选符合输入内容的银行卡 |
| ![](https://i.imgur.com/6G5Brbh.png) | button |   点击后，切换至新增银行卡页面 |
| ![](https://i.imgur.com/fVCHnUq.png) | button | 点击后，切换至该银行卡报表页面(显示内容待补) |
| (示意图)<br>![](https://i.imgur.com/YYmVxy8.jpg) | 文字显示 | 1.显示格式，由上至下：银行别、银行卡代码、户名、银行卡号<BR>2.卡片种类为「鲔鱼堡」时，因银行卡代码由后台人工设定，未设定时显示为空<br>&nbsp;&nbsp;- 银行卡代码显示格式请见[国行专属银行卡代码](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#1-2-%E5%9B%BD%E8%A1%8C%E4%B8%93%E5%B1%9E%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BB%A3%E7%A0%81) |
| 状态 | 文字显示 | 显示内容：待审批、启用、停用、退回补件<br>&nbsp;&nbsp;- 状态说明请见：[APP显示状态 VS server各卡片种类表](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#APP%E6%98%BE%E7%A4%BA%E7%8A%B6%E6%80%81-VS-server%E5%90%84%E5%8D%A1%E7%89%87%E7%A7%8D%E7%B1%BB%E8%A1%A8) |
| ![](https://i.imgur.com/WwXwYyT.jpg) | switch | 1.卡片种类为「金鼎」且状态为「启用、停用」时，才有此开关<br>2.状态文字为「启用」时，开关为ON![](https://i.imgur.com/OZ0zpxV.jpg)，切换为off![](https://i.imgur.com/UUTfmoO.jpg)时，状态文字更新为「停用」<br>&nbsp;&nbsp;- off→on时，依server回传显示提示内容(提示文字样式可依开发定义，只要不超框即可)<br>目前已知的提示内容有<br>&nbsp;&nbsp;&nbsp;&nbsp;- "请注意!开启后即进入任务自动派发程序*开启期间，请勿私自使用该卡收款或转出，与本APP无关的操作，避免影响系统判断，如因人为任意操作，造成损失需自行承担后果。"<br>&nbsp;&nbsp;&nbsp;&nbsp;- "今日银行卡已达到售币笔数"<br>&nbsp;&nbsp;&nbsp;&nbsp;- "今日银行卡已达到今日售币总额。" | 
| 验证 | button | 1.卡片种类为「金鼎」且状态为「待审批」时，才有此按钮<br>2.点击后，当前页面出现提示弹框<br>"1.确认手机%111 **** 4448%已开通银行帐变短讯通知<br>2.转帐%21%到此帐户<br>3.确认手机收到短讯通知<br>若完成以上步骤，<br>銀行卡未通过认证，请联络客服"<br>&nbsp;&nbsp;- %111****4448%：显示server回传该银行卡当前设定的手机号<br>&nbsp;&nbsp;&nbsp;&nbsp;- 手机号格式固定11位正整数且前三码及后四码显示明码，中间四码显示*<br>&nbsp;&nbsp;- %21%：显示server回传当前该银行卡被分配的验证金额<br>&nbsp;&nbsp;&nbsp;&nbsp;- 金额格式固定2位正整数<br>&nbsp;&nbsp;- 确认按钮：点击后关闭提示框，停留当前银行卡管理清单页面 | 
| ![](https://i.imgur.com/9tBl6cl.jpg) | button | 点击后，切换至编辑银行卡页面 |
| 执行/停止 | button | 1.预设文字「执行」，点击后，该卡按钮文字更新为「停止」<br>2.银行卡状态为「启用」时`执行`按钮才会enable<br>2.`执行`按钮点击后，开始运行该银行卡当前server设定的卡片种类模式<br>3.`停止`按钮点击后，出现提示"停止中…请稍候"，待该银行卡当前任务流程执行完成后终止运行，自动关闭提示并停留当前银行卡管理清单页面，且该银行卡`停止`按钮文字更新为「执行」 |
| ![](https://i.imgur.com/XzxpQ0C.jpg) | BackToTop | 点击后，返回银行卡清单顶部 |

#### APP显示状态 VS server各卡片种类表
![](https://i.imgur.com/hSBxJWv.png)


### 5-2. 新增银行卡
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=130%3A2926&scaling=scale-down&page-id=40%3A175&starting-point-node-id=130%3A2926&show-proto-sidebar=1

#### 银行卡信息共通页面
- UI：figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/界面?node-id=130%3A2926&scaling=scale-down&page-id=40%3A175&starting-point-node-id=130%3A2926

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :----: | -------- |
| 请选择卡片种类* | 单选式下拉 | Y | 选单内容：依==取得银行别API==回传清单进行显示<br>&nbsp;&nbsp;*注：现阶段已知内容为：金鼎、金宝、鲔鱼堡(清单显示逻辑请见下方金流后台操作补充情境范例)  |
| 请选择银行别* | 单选式下拉 | Y | 选单内容：依「卡片种类」显示[综合管理>银行别管理]对应银行别清单(清单显示逻辑请见下方金流后台操作补充情境范例) |
| 请输入支行名称* | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
| 请输入卡号* | textbox |  Y  | 1.只可输入正整数0~9<br>2.长度：最多20位 |
| 请输入户名* | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
| 请输入手机号* | textbox |  Y  | 1.只可输入正整数0~9<br>2.长度：最多20位 |
| 请输入网路银行登入帐号* | textbox |  Y  | 1.只可输入英文数字，字母大小写不限<br>2.长度：最多20位 |
| 请输入网路银行登入密码* | textbox |  Y  | 1.只可输入英文数字，字母区分大小写<br>2.长度：最多20位 |
| 下一步 | button | -- | 点击后，检查页面栏位内容是否符合限制<br>&nbsp;&nbsp;- 否：显示对应栏位错误提示，ex:"请输入支行名称"、"请输入手机号"…etc(提示内容及样式依开发定义)<br>&nbsp;&nbsp;- 是：依「卡片种类」切换对应页面，请见[页面切换流程概述](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%A1%B5%E9%9D%A2%E5%88%87%E6%8D%A2%E6%B5%81%E7%A8%8B%E6%A6%82%E8%BF%B0) |

> 金流后台操作补充：
> 国行APP上显示的「卡片种类」及对应的「银行别」清单，请于[金流后台>综合管理>银行别管理>新增/修改]页面中进行设定。
> ![](https://i.imgur.com/Jr0Xjn7.png)
> 1. 依该银行别对应的应用程式勾选为「金鼎、金宝、鲔鱼堡」显示于APP「卡片类型」显示对应的「银行别」选单内容
> . APP用户使用APP时，APP卡片类型依用户选项，对应显示有支援该应用程式的银行别清单
> 
> - 范例(银行别及其「应用程式」设定如下表)
> 
> | 银行别 | 应用程式 |
> | -------- | -------- | 
> | 行动石嘴山     | 金宝、鲔鱼堡     |
> | 行动中国     | 金鼎     |
> | 行动兴业    | 金鼎、金宝、鲔鱼堡    |
> | 行动光大    | 金鼎、鲔鱼堡    |
> 
>  【情境说明】
> 1. server会提供国行APP的银行别清单为「行动石嘴山、行动中国、行动兴业、行动光大」
> 2. APP依卡片类型选项对应显示银行别：
>     - 卡片类型「金鼎」时，银行别选单显示「行动中国、行动兴业、行动光大」
>    - 卡片类型「金宝」时，银行别选单显示「行动石嘴山、行动兴业」
>    - 卡片类型「鲔鱼堡」时，银行别选单显示「行动石嘴山、行动兴业、行动光大」


#### 新增银行卡-鲔鱼堡1/金宝
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=755%3A17628&scaling=scale-down&page-id=40%3A175&starting-point-node-id=130%3A2926
- [银行卡信息共通页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BF%A1%E6%81%AF%E5%85%B1%E9%80%9A%E9%A1%B5%E9%9D%A2)「卡片种类」选取「金宝」或「鲔鱼堡」时，点击`下一步`按钮后，切换此页面

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :----: | -------- |
| 请选择开户省份* | 单选式下拉 | Y | 选单内容：显示server回传的省份清单 |
| 请选择开户城市* | 单选式下拉 | Y | 1.选单内容与「开户省份」连动<br>2.选单内容：依选取的省份显示server回传的城市清单 |
| 请输入身份证号码* | textbox |  Y  | 1.只可输入数字和字母X(不分大小写)=>因为部份中国身份证末码会有"X"<br>2.长度：最多20位 |
| 请选择居住地省份* | 单选式下拉 | Y | 选单内容：显示固定的省份清单 |
| 请选择居住地城市* | 单选式下拉 | Y |  1.选单内容与「居住省份」连动<br>2.选单内容：依选取的省份显示对应的城市清单 |
| %额外栏位名称% | textbox | Y | 1.当选取的银行别于[金流后台>综合管理>银行别管理>新增/修改]页面中有设定额外栏位时才透过==银行别API==取得并显示<br>2.%额外栏位名称%：依选取的银行别配置显示栏位名称<br>3.输入文字符号不限<br>长度：最多20位 |
| 下一步 | button | -- | 1.「卡片种类」选取「鲔鱼堡」时，此按钮文字显示"下一步"<BR>2.点击后，检查页面栏位内容是否符合限制<br>&nbsp;&nbsp;- 否：显示对应栏位错误提示，ex:"请输入手机银行登入帐号"…etc(提示内容及样式依开发定义)<br>&nbsp;&nbsp;- 是：切换至「新增银行卡(银行卡-鲔鱼堡2)」页面 |
| 完成 | button | -- | 1.「卡片种类」选取「金宝」时，此按钮文字显示"完成"<BR>2.点击后，透过==新增银行卡API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至银行卡清单页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |

> 金流后台操作补充：
> 新增银行别对应额外栏位，请于[金流后台>综合管理>银行别管理>新增/修改]页面中进行设定。
> - 每间银行别最多可设定三组额外栏位
> - 额外栏位勾选启用并设定栏位名称及输入框内显示的提示浮水印文字
> - 启用的额外栏位固定为必填项目
> ![](https://i.imgur.com/OLtKKEv.png)


#### 新增银行卡-鲔鱼堡2
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=130%3A2928&scaling=scale-down&page-id=40%3A175&starting-point-node-id=130%3A2926
- [银行卡信息共通页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BF%A1%E6%81%AF%E5%85%B1%E9%80%9A%E9%A1%B5%E9%9D%A2)「卡片种类」选取「鲔鱼堡」并于[银行卡-鲔鱼堡1/金宝页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1-%E9%B2%94%E9%B1%BC%E5%A0%A11%E9%87%91%E5%AE%9D)点击`下一步`按钮后，切换此页面

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :----: | -------- |
| 请输入支付密码 | textbox | N | 1.只可输入数字<br>2.长度：固定6位 |
| 请输入查询密码 | textbox | N | 1.只可输入数字<br>2.长度：固定6位 |
| 是否使用密码器* | 单选式下拉 | Y | 选单内容：否、是 |
| 请输入手机银行登入帐号* | textbox |  Y  | 1.只可输入数字<br>2.长度：最多20位 |
| 请输入手机银行登入密码* | textbox |  Y  | 1.只可输入英文数字，字母区分大小写<br>2.长度：最多20位 |
| 其他信息 | textbox | N | 1.输入文字符号不限<br>2.长度：最多20位 |
| 录制扫脸 | button | -- | 点击后，透过==新增银行卡API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至录制扫脸页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |
| 完成 | button | -- | 点击后，透过==新增银行卡API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至银行卡清单页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |

#### 新增银行卡-金鼎
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=130%3A2929&scaling=scale-down&page-id=40%3A175&starting-point-node-id=130%3A2926
- [银行卡信息共通页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BF%A1%E6%81%AF%E5%85%B1%E9%80%9A%E9%A1%B5%E9%9D%A2)「卡片种类」选取「金鼎」时，点击`下一步`按钮后，切换此页面

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :----: | -------- |
| 每日收款限额* | textbox |  Y  | 1.最小值：1<br>2.只可输入正整数0~9及小数点后2位<br>3.长度：最多18位整数+2位小数 |
| 最大收款金额* | textbox |  Y  | 1.最小值：1<br>2.只可输入正整数0~9及小数点后2位<br>3.长度：最多18位整数+2位小数 |
| 每日收款笔数* | textbox |  Y  | 1.最小值：1<br>2.只可输入正整数0~9<br>2.长度：最多3位 |
| 售币区间 | 2个textbox |  Y  | 1.，最小值：1<br>2.只可输入正整数0~9及小数点后2位<br>3.长度：最多18位整数+2位小数<br>4.左侧textbox内的值不可大于等于右侧textbox内的值 |
| 完成 | button | -- | 点击后，透过==新增银行卡API==将信息传至server，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至银行卡管理清单页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |

#### 扫脸影片
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=130%3A3393&scaling=scale-down&page-id=40%3A175&starting-point-node-id=130%3A3393&show-proto-sidebar=1
- [银行卡-鲔鱼堡2页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1-%E9%B2%94%E9%B1%BC%E5%A0%A12)点击`录制扫脸`按钮后，切换此页面
- 显示栏位：正面、左摆头、右摆头、上摆头、下摆头、张嘴、眨眼、微笑
    - 全部都是选填
- 依上传状态显示文字
    - 预设：尚未上传
    - 上传成功后：上传成功
- 功能按钮(相关功能请参见[鲔鱼堡>扫脸录制影片页面])
    - 录制视频
        - 点击后，切换至录制影片页面
        - 录制后影片解析度<br>width:1920；height:1080
        - 影片不压缩
    - 上传档案
        - 点击后，开启系统档案上传功能
        - 档案大小：最多20MB
    - 返回
        - 点击后，切换银行卡管理清单页面
- 录制影片页面
    - 页面标题
        - < 录制影片：点击后，返回扫脸影片页面
            - 录制过程，此按钮不可点击
    - 页面
        - 预设显示倒数秒数5
        - 预设显示文字「请把人脸移入框内」
        - 预设圆框内显示手机前镜头当前拍摄的影像画面
    - 功能按钮
        - 开始录影：点击后，调用手机前镜头开始录制人脸影片
            - 录制过程，页面上方秒数显示倒数
        - 上传影片(录制过程此按钮disable)：点击后，切换至银行卡清单页面并出现提示"上传中"，透过==上传影片API==将信息传至server，依server回传结果
            - 成功：提示"上传中"更新为"上传成功"
                - 关闭按钮：点击后，关闭当前提示，停留银行卡管理清单页面 
            - 失败：显示API回传errormessage

### 5-3. 編輯银行卡
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=198%3A3240&scaling=scale-down&page-id=40%3A175&starting-point-node-id=198%3A3240&show-proto-sidebar=1

#### 编辑银行卡入口页面
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=198%3A3240&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1613&show-proto-sidebar=1

| 栏位   | 格式 | 说明 |
| ---------- | :----: | -------- |
| (示意图)<br>![](https://i.imgur.com/YYmVxy8.jpg) | 文字显示 | 显示格式，由上至下：银行别、银行卡代码、户名、银行卡号、状态 |
| 编辑银行卡信息 | button | 1.点击后，切換至编辑银行卡内容頁面<br>2.银行卡于后台更改卡片种类后，切换至该银行卡当前卡片种类对应的编辑银行卡页面<br>&nbsp;&nbsp;ex:原为金鼎卡于后台已切换卡片种类为金宝卡，则点击此按钮，切换至「编辑银行卡(金宝)」页面未填写的栏位内容显示为空 |
| 登录扫脸 | button | 1.点击后，切換至[扫脸影片](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E6%89%AB%E8%84%B8%E5%BD%B1%E7%89%87)頁面<br>2.只有卡片种类为「鲔鱼堡」才会显示此按钮 |

#### 编辑银行卡信息>银行卡信息共通页面
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=840%3A5526&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1613&show-proto-sidebar=1
- **银行卡状态为「启用」或「待审批」时，页面内容只可查看不可更改(全部栏位均disable)**
- 栏位内容预设显示前次设定
- 规格说明
    - 银行别：固定不可修改
    - 其余栏位同[新增银行卡>银行卡信息共通页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1-%E8%BF%9C%E7%A8%8B%E6%89%98%E7%AE%A11)

#### 编辑银行卡-鲔鱼堡1/金宝
- **银行卡状态为「启用」或「待审批」时，页面内容只可查看不可更改(全部栏位均disable)**
- 栏位内容预设显示前次设定
- 栏位规格说明同[新增银行卡-鲔鱼堡1/金宝](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1-%E8%BF%9C%E7%A8%8B%E6%89%98%E7%AE%A11)

#### 编辑银行卡-鲔鱼堡2
- **银行卡状态为「启用」或「待审批」时，页面内容只可查看不可更改(全部栏位均disable)**
- 栏位内容预设显示前次设定
- 栏位规格说明同[新增银行卡-鲔鱼堡2]([https:/](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1-%E8%BF%9C%E7%A8%8B%E6%89%98%E7%AE%A12)/)

#### 编辑银行卡-金鼎
- **银行卡状态为「启用」或「待审批」时，页面内容只可查看不可更改(全部栏位均disable)**
- 栏位内容预设显示前次设定
- 栏位规格说明同[新增银行卡-金鼎](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E9%93%B6%E8%A1%8C%E5%8D%A1-%E6%9C%AC%E6%9C%BA%E5%B7%A5%E4%BD%9C)

#### 登录扫脸>扫脸影片
- 栏位内容预设显示前次设定(上传成功过的项目显示"上传成功"文字)
- 栏位规格说明同[新增银行卡>扫脸影片]

## 6. 模式功能
### 6-1. 金鼎购币
#### 6-1-1. 购币流程
#### 购币金额页面
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=136%3A1611&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: |  :----:  | -------- |
| 银行卡代码：%银行卡代码(户名)% | 文字顯示 | -- |  %银行卡代码(户名)%：顯示該次购币選取的銀行卡代码及对应银行卡的户名 |
| 请输入购币金额 | textbox |  Y  | 1.最小值：1<br>2.只可输入正整数0~9及小数点后2位<br>3.长度：最多18位整数+2位小数 | 
| 建议金额区间：%金额%~%金额% | 文字显示 | --| %金额%：显示server当前回传的金额数值<br>(此金额是由server端取得当前全部使用者曾进行买分的最小及最大金额，纯粹用以显示给用户了解目前曾有哪些购币金额区间) |
| 人工转帐 | button | -- | 点击后，检查页面栏位内容是否符合限制<br>&nbsp;&nbsp;- 否：显示对应栏位错误提示，ex:"请输入购币金额"…etc<br>&nbsp;&nbsp;- 是：切换至购币清单页面 |
| 助手转帐 | button | -- | 点击后，检查页面栏位内容是否符合限制<br>&nbsp;&nbsp;- 否：显示对应栏位错误提示，ex:"请输入购币金额"…etc<br>&nbsp;&nbsp;- 是：切换至购币清单页面 |

#### 购币清单页面
- UI： https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=136%3A1610&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1
- 界面上半部显示同[购币金额页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E6%8A%A2%E5%8D%95%E9%87%91%E9%A2%9D%E9%A1%B5%E9%9D%A2)，另举相异处说明如下

| 栏位   | 格式 |  说明 |
| ---------- |  :----: | -------- |
| 取消购币 | button | 点击后，结束购币，切换至购币金额页面 |
| (示意图)<br>![](https://i.imgur.com/OKt30Cd.jpg) | button | 1.显示server当前回传的订单金额清单<br>2.点击后，显示server回传结果<br>&nbsp;&nbsp;- 成功：切换至确认接单页面<br>&nbsp;&nbsp; - 失败：显示API回传errormessage |

#### 购币确认页面
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=136%3A1609&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1
- 界面上半部显示同[购币金额页面](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E6%8A%A2%E5%8D%95%E9%87%91%E9%A2%9D%E9%A1%B5%E9%9D%A2)，另举相异处说明如下

| 栏位   | 格式 |  说明 |
| ---------- |  :----: | -------- |
| 已配对金额：%订单金额% | 文字显示 |  1.%订单金额%：显示当前选取的订单金额<br>2.格式：显示千分号及小数点后2位 |
| 剩余时间：%时间倒数% | 文字显示 |  1.%时间倒数%：显示server当前回传的时间倒数<br>2.格式：hh:mm:ss |
| 确认接单 | button | 点击后，显示server回传结果<br>&nbsp;&nbsp;- 成功：依购币金额页面选用按钮入口切换至对应确认页面<br>&nbsp;&nbsp;&nbsp;&nbsp; -人工转帐：切换至「金鼎购币(人工转帐)页面<br>&nbsp;&nbsp;&nbsp;&nbsp; -助手转帐：切换至「金鼎购币(助手转帐)页面 <br>&nbsp;&nbsp;- 失败：显示API回传errormessage |
| 重新配对 | button | 点击后，结束购币，切换至购币金额页面 |

#### 金鼎购币(人工转帐)
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=136%3A1608&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1

| 栏位  | 格式    |  必填    |  說明                                                                       |
|-------|:---------:|:--------:|----------------------------------------------------------------------------|
| 银行卡代码：%银行卡代码(户名)% | 文字显示 | -- |  %银行卡代码(户名)%：顯示該次购币選取的銀行卡代码及对应银行卡的户名 |
| 订单信息  | 文字显示 | -- | -- |
| 收款银行 | 文字显示  | -- | 显示server回传的收款银行别名称 |
| 收款卡号  | 文字显示  | -- |  1.显示server回传的收款帐号<br>2.右侧显示复制图示，点击图示可复制收款卡号 |
| 收款户名 | 文字显示  | -- | 1.显示server回传的收款户名<br>2.右侧显示复制图示，点击图示可复制收款户名 |
| 收款金额  | 文字显示  | -- | 1.显示server回传的收款金额<br>2.右侧显示复制图示，点击图示可复制收款金额<br>3.金额格式：显示千分号及小数点后2位 |
| 缴款期限  | 文字显示  | -- | 1.显示server回传的最后缴款截止日期时间<br>2.时间格式：YYYY-MM-DD hh:mm:ss |
| 时间倒数  | 动态显示时间倒数 | -- | 1.动态显示至缴款期限前的倒数剩余时间<br>2.倒数时间格式：hh:mm:ss |
| 上传回单*<br>(支援格式：.jpg、.png，文件不可超过20MB) | button  | Y | 1.点击后，开启档案上传功能<br>2.支持格式：.jpg、.png，单一档案最多20MB<br>2.上传成功后于上传回单按钮右侧显示上传的「文件名称.副档名」 |
| 上传明细*<br>(支援格式：.jpg、.png，文件不可超过20MB) | button  | Y | 1.点击后，开启档案上传功能<br>2.支持格式：.jpg、.png，单一档案最多20MB<br>2.上传成功后于上传回单按钮右侧显示上传的「文件名称.副档名」 |
| 确认送出 | button |  --  | 1.点击后，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至购币结果页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage |
| 取消订单 | button |  --  | 点击后，切换至购币金额页面 |

#### 金鼎购币(助手转帐)
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=136%3A1607&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1

| 栏位  | 格式    |  說明                   |
|-------|:---------:|----------------------------------------------------------------------------|
| 银行卡代码：%银行卡代码(户名)% | 文字显示 |  %银行卡代码(户名)%：显示该次购币选取的银行卡代码及对应银行卡的户名 |
| 收款金额  | 文字显示  |  1.显示server回传的收款金额<br>2.金额格式：显示千分号及小数点后2位 |
| 转帐协助 | button |   点击后，切换至银行APP |
| 取消订单 | button |   点击后，切换至购币金额页面 |

#### 购币结果页面
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=198%3A3311&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1

| 栏位  | 格式    |  說明      |
|-------|:---------:|----------------------------------------------------------------------------|
| 银行卡代码：%银行卡代码(户名)% | 文字显示 |   %银行卡代码(户名)%：显示该次购币选取的银行卡代码及对应银行卡的户名 |
| 您已完成购币审核提交，<br>请至购币记录中查询订单状态<br><br>*若迟迟未审核通过，请联系客服 | 文字显示 |   %银行卡代码(户名)%：显示該次购币選取的銀行卡代码及对应银行卡的户名 |
| 订单记录 | button | 点击后，切换至订单记录页面 |
| 原卡继续抢 | button | 点击后，切换至当前银行卡的购币金额页面 |
| 返回 | button | 点击后，切换至银行卡管理清单页面 |

#### 6-1-2. 订单记录
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1287%3A11999&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1
- 查询条件

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| ![](https://i.imgur.com/iM2BxxM.png) | DatePicker | 1.预设显示当日，ex:2022-08-15~2022-08-15<br>2.最多可查询当日(含)回推30日的购币记录 |
| ![](https://i.imgur.com/5uHC2fV.png)  | 单选式下拉 | 1.预设选取「购币」<br>2.选单内容：购币、售币 |
| 查询 | button | 点击后，依查询条件设定显示结果列表 |

- 结果列表
    - 列表经由[金鼎购币>购币结果]订单记录按钮入口切换至此，列表需自动预查当日购币记录
    - 列表栏位标题需冻结，只有列表记录可以上下滑动


| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| 金币余额      | 文字显示 | 1.显示格式：当前用户金币总额(当前用户结算中金币金额)<br>&nbsp;&nbsp;- 金币总额**不包含**结算中金币<br>2.固定显示千分号及小数点后2位 |
| 订单时间     | 文字显示 | 1.显示订单的建立时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss<br>3.依此栏位时间递减排序(最新的记录在列表最上方)  |
| 订单编号      | 文字连结 | 1.显示订单编号<br>2.显示格式：固定15位，ex:WD202208040000001<br>3.点击后，依该订单记录类别切换至购币/售币详情页面 |
| 交易金额 | 文字显示 | 1.显示订单实际抢到的订单金额<br>2.固定显示千分号及小数点后2位 |
| 状态      | 文字显示 | 1.状态内容<br>&nbsp;&nbsp;- 购币：已分配、付款中、待审批、已到帐未审批、付款完成、取消、退回补件<br>&nbsp;&nbsp;&nbsp;&nbsp;- 蓝色：已分配、付款中<br>&nbsp;&nbsp;&nbsp;&nbsp;- 黄色：待审批、已到帐未审批<br>&nbsp;&nbsp;&nbsp;&nbsp;- 红色：取消、退回补件 <br>&nbsp;&nbsp;&nbsp;&nbsp;- 绿色：付款完成<br>&nbsp;&nbsp;- 售币：查核中、人工确认、取消、逾时取消、已到帐<br>&nbsp;&nbsp;&nbsp;&nbsp;- 蓝色：查核中<br>&nbsp;&nbsp;&nbsp;&nbsp;- 黄色：人工确认<br>&nbsp;&nbsp;&nbsp;&nbsp;- 红色：取消、逾时取消<br>&nbsp;&nbsp;&nbsp;&nbsp;- 绿色：已到帐 |


- 购币详情
    - UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=980%3A8511&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1

| 栏位  | 格式    |  必填    |  說明                                                                       |
|-------|:---------:|:--------:|----------------------------------------------------------------------------|
| 订单编号      | 文字显示 | -- | 1.显示订单编号<br>2.显示格式：固定15位，ex:WD202208040000001 |
| 出款银行卡代码：%银行卡代码(户名)% | 文字显示 | -- |  %银行卡代码(户名)%：显示该次购币选取的银行卡代码及对应银行卡的户名 |
| 申请金额 | 文字显示 | -- | 1.显示server回传该笔记录会员进行购币当下提交的购币金额<br>2.金额格式：显示千分号及小数点后2位 |
| 交易金额  | 文字显示  | -- | 1.显示server回传的实际收款金额<br>2.金额格式：显示千分号及小数点后2位 |
| 收款银行 | 文字显示  | -- | 显示server回传的收款银行别名称 |
| 收款支行 | 文字显示  | -- | 显示server回传的收款银行支行名称 |
| 收款卡号  | 文字显示  | | 显示server回传的收款帐号 |
| 收款户名 | 文字显示  | -- | 显示server回传的收款户名 |
| 建立时间     | 文字显示 | -- | 1.显示订单的建立时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss  |
| 更新时间     | 文字显示 | -- | 1.显示订单的更新时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss  |
| 审批详情 | -- | -- | -- |
| 审批时间     | 文字显示 | -- | 1.显示server回传的最新一次订单被审批的时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss<br>3.订单状态为「已分配、付款中」时，此栏内显示为空(因后台尚未进入审批流程)  |
| 审批状态 | 文字显示 | -- | 1.显示内容：购币成功、购币失败、退回补件<br>2.订单状态为「已分配、付款中」时，此栏内显示为空(因后台尚未进入审批流程) |
| 审批理由 | 文字显示 | -- | 1.显示server回传的最新一次订单被审批的审批文字内容<br>2.订单状态为「已分配、付款中」时，此栏内显示为空(因后台尚未进入审批流程) |
| 上传回单*<br>(支援格式：.jpg、.png，文件不可超过20MB) | button  | Y | 1.订单状态为「付款中、退回补件」时才显示此栏位<br>2.点击后，开启档案上传功能<br>2.支持格式：.jpg、.png，单一档案最多20MB<br>2.上传成功后于上传回单按钮右侧显示上传的「文件名称.副档名」 |
| 上传明细*<br>(支援格式：.jpg、.png，文件不可超过20MB) | button  | Y | 1.订单状态为「付款中、退回补件」时才显示此栏位<br>2.点击后，开启档案上传功能<br>2.支持格式：.jpg、.png，单一档案最多20MB<br>2.上传成功后于上传回单按钮右侧显示上传的「文件名称.副档名」 |
| 确认送出 | button |  --  | 1.订单状态为「付款中、退回补件」时才显示此按钮<br>2.点击后，依server回传结果<br>&nbsp;&nbsp;- 成功：切换至订单记录页面<br>&nbsp;&nbsp;- 失败：显示API回传errormessage<br>*server需检查订单状态是否已更新为「待审核、已到帐待审核」，若是，不可提交成功，需回传error，关闭errorMsg后，需自动刷新页面 |
| 返回 | button |  --  | 点击后，切换至订单记录页面 |


- 售币详情
    - UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1287%3A14147&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1611&show-proto-sidebar=1

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| 订单编号      | 文字显示 |  1.显示订单编号<br>2.显示格式：固定15位，ex:DP202208040000001 |
| 收款银行卡代码：%银行卡代码(户名)% | 文字显示 |   %银行卡代码(户名)%：显示该次购币选取的银行卡代码及对应银行卡的户名 |
| 申请金额 | 文字显示 |  1.显示server回传该笔记录会员进行购币当下提交的购币金额<br>2.金额格式：显示千分号及小数点后2位 |
| 交易金额  | 文字显示  |  1.显示server回传的实际收款金额<br>2.金额格式：显示千分号及小数点后2位 |
| 订单状态 | 文字显示 |  显示内容：查核中、人工确认、取消、逾时取消、已到帐<br>&nbsp;&nbsp;- 蓝色：查核中<br>&nbsp;&nbsp;- 黄色：人工确认<br>&nbsp;&nbsp;- 红色：取消、逾时取消<br>&nbsp;&nbsp;- 绿色：已到帐 |
| 建立时间     | 文字显示 |  1.显示订单的建立时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss  |
| 更新时间     | 文字显示 | 1.显示订单的更新时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss  |
| 返回 | button |   点击后，切换至订单记录页面 |

#### 6-1-3. 金币记录
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1611%3A27165&scaling=scale-down&page-id=40%3A175&starting-point-node-id=1611%3A27165&show-proto-sidebar=1
- 查询条件

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| ![](https://i.imgur.com/iM2BxxM.png) | DatePicker | 1.预设显示当日，ex:2022-08-15~2022-08-15<br>2.最多可查询当日(含)回推30日的购币记录 |
| 查询 | button | 点击后，依查询条件设定显示结果列表 |

- 结果列表
    - 列表栏位标题需冻结，只有列表记录可以上下滑动


| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| 金币余额      | 文字显示 | 1.显示格式：当前用户金币总额(当前用户结算中金币金额)<br>&nbsp;&nbsp;- 金币总额**不包含**结算中金币<br>2.固定显示千分号及小数点后2位 |
| 订单时间     | 文字显示 | 1.显示订单的建立时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss<br>3.依此栏位时间递减排序(最新的记录在列表最上方)  |
| 订单编号      | 文字连结 | 1.显示订单编号<br>2.显示格式：固定15位，ex:CO202208040000001<br>3.点击后，切换至金币详情页面 |
| 交易金额 | 文字显示 | 1.显示金币金额<br>2.固定显示千分号及小数点后2位<BR>3.依「类型」栏内数值正负数说明：<BR>&nbsp;&nbsp;- 售出金币、金币转佣金：固定为负<BR>&nbsp;&nbsp;- 购买金币、佣金转入：固定为正<BR>&nbsp;&nbsp;- 帐务异动：依后台操作帐务异动为负或为正 |
| 交易后金额 | 文字显示 | 1.显示新增该记录时计算的金币余额(会包含结算中金币)<br>2.固定显示千分号及小数点后2位 | 
| 类型      | 文字显示 | 1.类型内容：售出金币、购买金币、佣金转入、帐务异动、金币转佣金<br>&nbsp;&nbsp;- 蓝色：购买金币<br>&nbsp;&nbsp;- 黄色：佣金转入、帐务异动<br>&nbsp;&nbsp;- 红色：金币转佣金 <br>&nbsp;&nbsp;- 绿色：售出金币 |


- 金币详情
    - UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1306%3A8619&scaling=scale-down&page-id=40%3A175&starting-point-node-id=1611%3A27165&show-proto-sidebar=1

| 栏位  | 格式    |    說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| 订单编号      | 文字显示 | 1.显示订单编号<br>2.显示格式：固定15位，ex:DP202208040000001 |
| 交易金额  | 文字显示  |  1.显示该记录的金币金额<br>2.金额格式：显示千分号及小数点后2位 |
| 交易后金额 | 文字显示 | 1.显示该记录当下计算的金币余额(会包含结算中金币)<br>2.固定显示千分号及小数点后2位 |
| 建立时间     | 文字显示 |  1.显示订单的建立时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss  |
| 类型 | 文字显示 | 1.类型内容：售出金币、购买金币、佣金转入、帐务异动、金币转佣金<br>&nbsp;&nbsp;- 蓝色：购买金币<br>&nbsp;&nbsp;- 黄色：佣金转入、帐务异动<br>&nbsp;&nbsp;- 红色：金币转佣金 <br>&nbsp;&nbsp;- 绿色：售出金币 |
| 备注 | 文字显示 | 显示该记录异动时后台填入的异动事由<br>&nbsp;&nbsp;- 类型为「购买金币、售出金币」时，此栏位内显示为空 |
| 返回 | button |  点击后，切换至金币记录页面 |

#### 6-1-4. 金鼎佣金
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=1911%3A13507&scaling=scale-down&page-id=40%3A175&starting-point-node-id=48%3A383

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| 金鼎佣金余额：%金额%      | 文字显示 | 1.显示格式：当前用户金鼎卡产生的佣金余额<br>&nbsp;&nbsp;- 金鼎佣金余额**不包含**结算中佣金<br>2.固定显示千分号及小数点后4位 |
| 申请提领 | button | 点击后，切换至[申请提领](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#3-4-1-%E7%94%B3%E8%AF%B7%E6%8F%90%E9%A2%86)页面 |

- 查詢條件

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| ![](https://i.imgur.com/iM2BxxM.png) | DatePicker | 1.预设显示当日，ex:2022-08-15~2022-08-15<br>2.最多可查询当日(含)回推30日的佣金记录 |
| 银行卡代码:%银行卡代码% | 单选式下拉 | 1.选单内容：全部、会员当前卡片种类为「金鼎」的银行卡代码<br>2.预设选项依进入此页面入口不同：<br>&nbsp;&nbsp;- 由[银行卡管理>![](https://i.imgur.com/wEMOlaQ.png)]进入，预设选取该图示对应的银行卡代码<br>&nbsp;&nbsp;- 由[佣金提领记录](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#3-4-2-%E4%BD%A3%E9%87%91%E6%8F%90%E9%A2%86%E8%AE%B0%E5%BD%95)各卡片种类佣金余额「金鼎」按钮进入，预设选项为「全部」 |
| 查询 | button | 点击后，依查询条件设定显示结果列表 |

- 结果列表
    - 列表栏位标题需冻结，只有列表记录可以上下滑动


| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| 订单时间     | 文字显示 | 1.显示记录建立时间<br>2.显示格式：YYYY-MM-DD hh:mm:ss<br>3.依此栏位时间递减排序(最新的记录在列表最上方)  |
| 订单编号      | 文字显示 | 1.显示记录编号<br>2.显示格式：固定15位，ex:PU202208040000001 |
| 交易金额 | 文字显示 | 1.显示佣金金额<br>2.固定显示千分号及小数点后4位<BR>3.依「类型」栏内数值正负数说明：<BR>&nbsp;&nbsp;- 佣金转金币：固定为负<BR>&nbsp;&nbsp;- 下级返佣、购买金币、售出金币、金币转入：固定为正<BR>&nbsp;&nbsp;- 帐务异动：依后台操作帐务异动为负或为正 |
| 交易后金额 | 文字显示 | 1.显示新增该记录时计算的佣金余额(会包含结算中佣金)<br>2.固定显示千分号及小数点后4位 | 
| 类型      | 文字显示 | 1.类型内容：售出金币、购买金币、金币转入、帐务异动、佣金转金币、下级返佣<br>&nbsp;&nbsp;- 蓝色：购买金币<br>&nbsp;&nbsp;- 黄色：金币转入、帐务异动<br>&nbsp;&nbsp;- 红色：佣金转金币 <br>&nbsp;&nbsp;- 绿色：下级返佣、售出金币 |

### 6-2. 转帐助手
点击[银行卡管理]已设定支援TransferHelper的银行卡`执行`按钮，自动切换至[TransferHelper]页面，首次登入银行帐号成功后，即可点击`一键连线`按钮使用全自动转帐功能。
- UI：https://www.figma.com/proto/nLSyhiKI3LDDWBaZl4FyCE/%E7%95%8C%E9%9D%A2?node-id=2390%3A30042&scaling=scale-down&page-id=40%3A175&starting-point-node-id=136%3A1613&show-proto-sidebar=1
tag

| 栏位  | 格式    |  說明                                                                       |
|-------|:---------:|----------------------------------------------------------------------------|
| < TransferHelper   | button | 1.点击后，切换至银行卡管理<br>2.点击`一键连线`按钮，开始执行全自动转帐流程时，此按钮disable  |
| 猫狗银行      | 文字显示 | 依据会员当前点击`执行`按钮的银行卡所属银行自动显示该银行名称 |
| 首次登入 | button | 1.点击后，自动切换至该猫狗银行对应的虚拟银行页面，提供会员可进行登入<br>2.点击`一键连线`按钮，开始执行全自动转帐流程时，此按钮disable<BR>3.切换至虚拟银行后显示国行浮动ICON，提供会员可以在登入银行成功后，点击切换至国行界面 |







### 6-3. 金寶模式



## 【服务端-Paymentflow】
- [APP端PRD](https://hackmd.io/@B7_Y-C9pSS63AbqX_9kZlw/ryDdvSXF5)
## 1. 金流管理后台
### 1-1. 新增主功能 国行
子功能：会员管理、参数配置
#### ① 权限组别管理 https://ckoi43.axshare.com/#id=5gfmou&p=%E6%AC%8A%E9%99%90&g=1
- 新增「国行」主功能名称及对应子功能权限

| 子功能名称 | 权限勾选框设定项 |
| -------- | -------- | 
| 参数配置     | 修改：勾选后，可查看并修改参数配置页面设定    | 
| 会员管理     | - 列表：勾选后，可查看会员管理列表及详情页面<BR>- 新增：可使用新增功能跳转至新增页面新增帐号<BR>- 修改：可使用修改功能跳转至修改页面修改帐号<BR>- 检视银行卡资料：会员管理修改页面显示银行卡资料区块<BR>&nbsp;&nbsp;&nbsp;&nbsp;*注：需要有[国行>会员管理>修改]权限此功能才生效<BR>- 修改银行卡资料：会员管理修改页面显示银行卡资料区块且操作栏位内显示`修改`按钮，点击`修改`按钮可跳转至对应卡片种类银行卡修改页面<BR>&nbsp;&nbsp;&nbsp;&nbsp;*注1：需要有[国行>会员管理>检视银行卡资料]权限此功能才生效<BR>&nbsp;&nbsp;&nbsp;&nbsp;*注2：勾选此权限视同拥有[银行卡管理>银行卡：修改]、[金鼎>银行卡管理：修改]、[金宝>银行卡管理：列表]权限<BR>- 更换卡片种类：会员管理修改页面显示`更换卡片种类`按钮并可使用更换卡片种类功能<BR>&nbsp;&nbsp;&nbsp;&nbsp;*注：需要有[国行>会员管理>检视银行卡资料]权限此功能才生效 |

> 有「参数配置-修改」、「会员管理-列表权限」
>  ● 可在导览列看到「国行」主功能名称
>  ● 可在导览列看到对应子功能按钮


#### ② 参数配置(页面排版依开发定义)

| 栏位   | 格式 | 必填 | 说明 |
| ---------- | :----: | :--------: | -------- |
| Email主旨设定*  | textbox |  Y  | 1.预设「重置密码」<br>2.输入文字符号不限<br>3.长度：最多20位 |
| 送出 | button |  --  | 点击后，储存页面设定资料 |
    
#### ③ 会员管理
- 列表 https://ckoi43.axshare.com/#id=xi15mf&p=%E5%88%97%E8%A1%A8&g=1
    - 查询条件

    | 栏位   | 格式 |  说明 |
    | ---------- |  :--------: | -------- |
    | 卡商编号  | textbox | 模糊查询 |
    | 会员帐号  | textbox | 模糊查询 |
    | 昵称  | textbox | 模糊查询 |
    | 关联应用  | 单选式下拉选单 | 选单内容：显示当前[金流应用>应用程式管理]状态为启用的[应用程式名称] |
    | 状态 | 单选式下拉选单 | 1.预设显示「请选择」<br>2.选单内容：审批中、启用、停用 |
    | 级别 | 单选式下拉选单 | 1.预设显示「请选择」<br>2.选单内容：Lv.0、Lv.1、Lv.2、Lv.3、Lv.4、Lv.5、Lv.6、Lv.7、Lv.8、Lv.9 |
    | 查询 | button | 点击后，依查询条件显示对应筛选结果列表 |

    - 结果列表

    | 栏位   | 格式 |  说明 |
    | ---------- | :--------: | -------- |
    | 卡商编号  | 文字显示 | 显示卡商编号 |
    | 会员帐号  | 文字显示 | 显示登入帐号 |
    | 级别  | 文字显示 | 显示该帐号级别 |
    | 上级会员  | 文字显示 | 显示该帐号上级会员，级别為「Lv.0」時，上级会员栏位内容显示为空 |
    | 昵称 | 文字显示 | 显示昵称 | 
    | 状态 | 文字显示 | 显示状态 | 
    | 关联应用:帐号 | 文字连结 | 1.显示格式：%应用程式名称：帐号%<br>2.%帐号%为文字连结：可关联到对应应用程式帐号时才显示连结，否则为纯文字显示<br>&nbsp;&nbsp;- 点击帐号文字连结，跳转至对应帐号页面，ex:点击*金鼎：16718210001*  跳转至[金鼎>会员管理]查询条件「会员帐号」自动带入该帐号并显示筛选结果列表<br>&nbsp;&nbsp;- 特别补充：「鲔鱼堡、独角兽」登入帐号无会员帐号查询页面，故只需直接跳转至对应会员管理页面即可，ex：点击*鲔鱼堡：aaa777* 跳转至[金流应用>多层级银商管理]所属代理的[跑分APP-列表] |
    | 建立时间 | 文字显示 | 1.显示该帐号资料的建立时间<br>2.显示格式：yyyy-mm-dd hh:mm:ss | 
    | 最后登入时间 | 文字显示 | 1.显示该帐号于客户端最后一次登入时间<br>2.显示格式：yyyy-mm-dd hh:mm:ss | 
    | 操作 | 按钮 | 显示`修改`及`详情`按钮<br>&nbsp;&nbsp;- 修改：点击后跳转至修改页面<br>&nbsp;&nbsp;- 详情：点击后跳转至详情页面 |

- 新增 https://ckoi43.axshare.com/#id=pwmkcs&p=%E6%96%B0%E5%A2%9E&g=1

    | 栏位   | 格式 | 必填 | 说明 |
    | ---------- | :----: | :--------: | -------- |
    | 会员帐号*  | textbox |  Y  | 1.只可输入英文数字，字母不分大小写<br>2.长度：最多20位<br>3.**不可重覆** |
    | 登入密码*  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示"●" |
    | 昵称*  | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
    | 绑定邮箱*  | textbox |  Y  | 1.输入内容需合乎邮箱格式：只可输入英文字母、正整数0~9、@、.、_、-<br>2.长度：最多30位 |
    | 安全问题*  | 单选式下拉选单 |  Y  | 选单内容：第一只宠物名称、您的出生地、初中的学校名称、初恋发生的年份 |
    | 安全问题答案*  | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
    | 上级邀请码*  | 文字顯示 |  N  | 1.只可输入英数混和字串，字母不分大小写<br>2.未输入时，该会员级别为「Lv.0」，有输入时，依输入的邀请码所属会员级别直属下一级定义此会员级别<br>3.长度：6位 <br>4.每日00:00:00自动更新 |
    | 更新  | button |  --  | 点击后，立即更新邀请码 |
    | 状态*  | radiobox |  Y  | 1.预设选取「审批中」<br>2.选项：审批中、启用、停用 |
    | 关联应用  | ![](https://i.imgur.com/kWgmxVA.jpg)![](https://i.imgur.com/KriGYrA.jpg)按鈕<br>单选式下拉选单<br>textbox |  N  | 1.预设显示![](https://i.imgur.com/kWgmxVA.jpg)按钮，点击后动态显示单选式下拉选单、textbox、![](https://i.imgur.com/KriGYrA.jpg)按钮<br>&nbsp;&nbsp;- **动态显示的单选选单、输入框内容为必填**<br>2.选单内容：显示当前[金流应用>应用程式管理]状态为启用的[应用程式名称]<br>3.输入框：只可输入英文数字，字母不分大小写，长度：最多30位<br>4.<font color="#FF0000">选单选项+输入框内容组合**不可重覆**</font> |
    | 返点模式 | 文字显示 |  --  | 显示`金鼎`、`鲔鱼堡` 按钮 |
    | 金鼎 | button |  --  | 1.点击后，此按钮消失，且下方显示「金鼎费率」设定区块及![](https://i.imgur.com/KriGYrA.jpg)按鈕<br>2.设置逻辑同[金鼎>会员管理>修改>会员费率]<br>3.只要四个checkbox其一有勾选或「佣金提领最低金额>0」，即表示有设置国行的金鼎费率<br>![](https://i.imgur.com/KriGYrA.jpg)按鈕点击后，「金鼎费率」区块消失且重新显示`金鼎`按钮 |
    | 鲔鱼堡 | button |  --  | 1.点击后，此按钮消失，且下方显示「鲔鱼堡费率」设定区块![](https://i.imgur.com/KriGYrA.jpg)按鈕<br>2.设置逻辑同[金流应用>多层级银商管理>修改>会员费率]<br>3.只要四个checkbox其一有勾选，即表示有设置国行的鲔鱼堡费率<br>![](https://i.imgur.com/KriGYrA.jpg)按鈕点击后，「鲔鱼堡费率」区块消失且重新显示`鲔鱼堡`按钮 |
    | 送出 | button |  --  | 点击后<br>1.检查此会员是否关联金鼎或鲔鱼堡帐号且有设定对应的返点模式<br>&nbsp;&nbsp;- 是：旧有帐号相应费率设定失效，对应旧帐号页面([金鼎>会员管理>修改>会员费率]或[金流应用>多层级银商管理>修改>会员费率]设定项均disable，并以红字显示提示「(此帐号已关联至国行帐号%国行会员帐号%，请至国行查看费率)」<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- %国行会员帐号%：显示文字连结，点击后，跳转至该帐号的国行会员管理修改页面<br>2.检查各设定是否符合输入规范<br>&nbsp;&nbsp;- 是：检查操作者是否已設定卡商編號<br>&nbsp;&nbsp;- 否：显示对应提示讯息，ex：登入帐号为必填…etc(文字内容依开发定义)<br>&nbsp;&nbsp;- 是：pop-up提示讯息<br><br>````请确认填入的卡商编号为%卡商编号%````<br>````*确认送出后卡商编号将无法修改。````<br><br>&nbsp;&nbsp;&nbsp;&nbsp;- %卡商编号%：显示后台操作者当前设定的卡商编号内容<br>&nbsp;&nbsp;&nbsp;&nbsp;- 点击弹框`关闭`按钮，关闭弹框停留当前修改页面<br>&nbsp;&nbsp;&nbsp;&nbsp;- 点击弹框`送出`按钮，储存页面设定资料并跳转至会员管理列表<br>&nbsp;&nbsp;- 否：显示对应提示讯息，ex：登入帐号为必填…etc(文字内容依开发定义) |
    | 取消 | button |  --  | 点击后，跳转至会员管理列表 |

- 修改 https://ckoi43.axshare.com/#id=u27usv&p=%E4%BF%AE%E6%94%B9&g=1
    - 页面内容除「登入密码」显示为空，其他栏位内容预设显示前次设定
    
    | 栏位   | 格式 | 必填 | 说明 |
    | ---------- | :----: | :--------: | -------- |
    | 卡商编号*  | textbox |  --  | 1.可输入英文及正整数0~9，字母需自动转大写<br>2.长度：最多7位<br>3.若已设定过此栏位内容，之后就只可查看不可修改 |
    | 登入帐号*  | 文字显示 |  --  | 不可修改 |
    | 级别*  | 文字显示 |  --  | 不可修改 |
    | 上级会员*  | 文字显示 |  --  | 不可修改，级别為「Lv.0」時，上级会员栏位内容显示为空 |
    | 登入密码*  | textbox |  Y  | 1.英数混和，字母區分大小写<br>2.长度：8~15位<br>3.输入字串显示"●" |
    | 昵称*  | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
    | 绑定邮箱*  | textbox |  Y  | 1.输入内容需合乎邮箱格式：只可输入英文字母、正整数0~9、@、.、_、-<br>2.长度：最多30位 |
    | 安全问题  | 单选式下拉选单 |  Y  | 选单内容：第一只宠物名称、您的出生地、初中的学校名称、初恋发生的年份 |
    | 安全问题答案  | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
    | 邀请码  | 文字顯示 |  Y  | 1.系统随机自动生成英数混和字串，字母不分大小写<br>2.长度：6位 <br>3.每日00:00:00自动更新<br>4.级别为「Lv.9」的会员，此栏位内容显示为空 |
    | 更新  | button |  --  | 点击后，立即更新邀请码<br>级别为「Lv.9」的会员，不显示此按钮 |
    | 状态  | radiobox |  Y  | 选项：审批中、启用、停用 |
    | 关联应用  | ![](https://i.imgur.com/kWgmxVA.jpg)![](https://i.imgur.com/KriGYrA.jpg)按鈕<br>单选式下拉选单<br>textbox |  N  | 1.预设显示![](https://i.imgur.com/kWgmxVA.jpg)按钮，点击后动态显示单选式下拉选单、textbox、![](https://i.imgur.com/KriGYrA.jpg)按钮<br>&nbsp;&nbsp;- 动态显示的单选选单、输入框内容为必填<br>2.选单内容：显示当前[金流应用>应用程式管理]状态为启用的[应用程式名称]<br>3.输入框：只可输入英文数字，字母不分大小写，长度：最多30位<br>4.<font color="#FF0000">选单选项+输入框内容组合不可重覆</font> |
    | 返点模式 | 文字显示 |  --  | 显示`金鼎`、`鲔鱼堡` 按钮 |
    | 金鼎 | button |  --  | 1.点击后，此按钮消失，且下方显示「金鼎费率」设定区块及![](https://i.imgur.com/KriGYrA.jpg)按鈕<br>2.设置逻辑同[金鼎>会员管理>修改>会员费率]<br>3.只要四个checkbox其一有勾选或「佣金提领最低金额>0」，即表示有设置国行的金鼎费率<br>![](https://i.imgur.com/KriGYrA.jpg)按鈕点击后，「金鼎费率」区块消失且重新显示`金鼎`按钮 |
    | 鲔鱼堡 | button |  --  | 1.点击后，此按钮消失，且下方显示「鲔鱼堡费率」设定区块![](https://i.imgur.com/KriGYrA.jpg)按鈕<br>2.设置逻辑同[金流应用>多层级银商管理>修改>会员费率]<br>3.只要四个checkbox其一有勾选，即表示有设置国行的鲔鱼堡费率<br>![](https://i.imgur.com/KriGYrA.jpg)按鈕点击后，「鲔鱼堡费率」区块消失且重新显示`鲔鱼堡`按钮 |
    | 送出 | button |  --  | 点击后<br>1.检查此会员是否关联金鼎或鲔鱼堡帐号且有设定对应的返点模式<br>&nbsp;&nbsp;- 是：旧有帐号相应费率设定失效，对应旧帐号页面([金鼎>会员管理>修改>会员费率]或[金流应用>多层级银商管理>修改>会员费率]设定项均disable，并以红字显示提示「(此帐号已关联至国行帐号%国行会员帐号%，请至国行查看费率)」<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- %国行会员帐号%：显示文字连结，点击后，跳转至该帐号的[国行>会员管理]修改页面<br>2.检查各设定是否符合输入规范<br>&nbsp;&nbsp;- 是：当前页面出现提示弹框"请确认填入的卡商编号为%卡商编号%，*确认送出后卡商编号将无法修改。"<br>&nbsp;&nbsp;&nbsp;&nbsp;- %卡商编号%：显示当前「卡商编号」栏位输入的内容<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- 关闭：点击后，关闭弹框，停留当前会员管理修改页面<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- 送出：储存页面设定资料并跳转至会员管理列表<br>&nbsp;&nbsp;- 否：显示对应提示讯息，ex：登入帐号为必填…etc(文字内容依开发定义) |
    | 取消 | button |  --  | 点击后，跳转至会员管理列表 |


    - 银行卡资料
        - 需有[国行>会员管理>检视银行卡资料]权限才会显示此区块
        - 显示会员全部的银行卡列表清单(来源如下)
            - [银行卡管理>银行卡]：payment_flow_db.app_bankcard & bankcard
            - [金鼎>银行卡管理]：jindin_db.bankcard
            - [金宝>银行卡管理]：ginbao_db.bankcard
        - 统计会员当前各卡片种类的张数
            - 卡片种类固定显示「金鼎、金宝、鲔鱼堡」，没有该卡片种类显示0
    
    | 栏位   | 格式 |  说明 |
    | ---------- |  :--------: | -------- |
    | 银行卡代码  | 文字显示 | 1.显示银行卡代码<br>2.若未设定值显示为空<br>3.显示格式请见[国行专属银行卡代码](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#1-2-%E5%9B%BD%E8%A1%8C%E4%B8%93%E5%B1%9E%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BB%A3%E7%A0%81) |
    | 银行 | 文字显示 | 显示银行卡的银行别名称 |
    | 户名  | 文字显示 | 显示银行卡的户名 |
    | 银行卡号  | 文字显示 | 显示银行卡的银行卡号 |
    | 状态  | 文字显示 | 1.显示银行卡当前状态<br>2.显示内容依该银行卡卡片种类显示对应状态(不会有固定显示特定状态的意思) |
    | 关联手机  | 文字显示 | 显示银行卡的手机号 |
    | 建立时间 | 文字显示 | 1.显示银行卡建立时间<BR>2.显示格式：YYYY-MM-DD hh:mm:ss |
    | 卡片种类 | 文字显示 | 显示银行卡当前卡片种类 |
    | 操作 | button | 1.依各模块权限显示`修改`按钮<br>2.依银行卡当前卡片种类的银行卡状态显示`更换卡片种类`按钮<br>&nbsp;&nbsp;- 金鼎：停用<br>&nbsp;&nbsp;- 金宝：停用<br>&nbsp;&nbsp;- 鲔鱼堡：冻结、冻结退回、已退卡<br>3.点击`更换卡片种类`按钮后，当前页面开启更换卡片种类弹框 |

    - 更换卡片种类弹框

    | 栏位   | 格式 | 必填 | 说明 |
    | ---------- |  :--------:  |  :--------: | -------- |
    | 请问确定修改卡片种类?<br>*修改后需待用户补齐资料重新审批启用。 | 文字显示 | -- | -- |
    | %卡片种类选单% | radiobox | Y | 1.预设选取当前点击的银行卡卡片种类<br>&nbsp;&nbsp;- 若银行卡对应的卡片种类在[金流应用>应用程式管理]状态已被停用，预设选取项目依开发定义<br>2.选单内容：[金流应用>应用程式管理]状态为启用的应用程式名称 |
    | 送出 | button | -- | 1.未变更卡片种类选项时，此按钮disable<br>2.点击后<br>- 检查银行卡状态是否还是「停用」<br>&nbsp;&nbsp;- 否：当前页面出现提示弹框"银行卡状态已改变，不允许变更卡片状态"<br>&nbsp;&nbsp;- 是：检查银行卡的银行别是否支援变更后的卡片种类([综合管理>银行别管理>应用程式]有勾选欲变更的卡片种类)<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;- 有：关闭提示弹框，储存设定(流程请见[更换卡片种类流程](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#1-3-%E6%9B%B4%E6%8D%A2%E5%8D%A1%E7%89%87%E7%A7%8D%E7%B1%BB%E6%B5%81%E7%A8%8B)，刷新会员管理修改页面，显示修改资料后的页面 |
    
- 详情 https://ckoi43.axshare.com/#id=ceq2sh&p=%E8%AF%A6%E6%83%85&g=1
    - 页面内容同「修改页面」但只可查看不可提交修改，相异处如下
        - 邀请码右侧不显示`更新`按钮
        - 关联应用不显示![](https://i.imgur.com/kWgmxVA.jpg)![](https://i.imgur.com/KriGYrA.jpg)按鈕
        - 返点模式不显示`金鼎`、`鲔鱼堡`、![](https://i.imgur.com/KriGYrA.jpg)按鈕
            - 若无设定返点模式，此区块显示为空 
        - 页面不显示「送出」按钮
        - 需有[国行>会员管理>检视银行卡资料]权限才会显示「银行卡资料」区块
            - 固定不顯示操作欄位及功能按鈕

### 1-2. 国行专属银行卡代码
经由国行APP新增的银行卡，除卡片种类「鲔鱼堡」维持银行卡代码由人工于金流后台设定填入外，卡片种类「金鼎、金宝」在新增银行卡时，均由系统自动生成该卡片种类中的唯一银行卡代码(同一卡片种类中银行卡代码为唯一值，不同卡片种类的同一张银行卡的银行卡代码会相同=>对应Cashpool银行卡代码为唯一值)。
- ex：KO0022-行动邮政储汇-00006
- 格式：KO%卡商编号%-%银行别名称%-00001
    - KO：国行专属前缀，固定大写字母
    - %卡商编号%：[国行>会员管理]设定的「卡商编号」
    - %银行别名称%：[综合管理>银行别管理]的[银行别]名称
    - %00001%：依银行别生成固定5位数流水号
    - 分隔符号"-"：%卡商编号%与%银行别名称%及5位数流水以符号"-"区隔

### 1-3. 更换卡片种类流程
- 流程图连结：https://app.diagrams.net/#G1vFdFSbHuW3mAC3NINi3d34r2Lg2pcG9n
    - 金宝卡→金鼎卡
        - 金鼎卡以下两栏位NOT NULL，由金宝切换为金鼎自动insert时，预设填入0
            - `daily_max_amount` decimal(20,2) NOT NULL COMMENT '收款日限额',
            - `per_max_amount` decimal(20,2) NOT NULL COMMENT '最大收款金额', 


### 1-4. 金宝 新增子功能 银行卡管理
金宝主功能下新增子功能「银行卡管理」及对应权限
#### 1-4-1. 权限组别管理 https://ckoi43.axshare.com/#id=vuctk6&p=%E9%8A%80%E8%A1%8C%E5%8D%A1%E6%AC%8A%E9%99%90&g=1

| 子功能名称 | 权限勾选框设定项 |
| -------- | -------- | 
| 银行卡管理 | - 列表：勾选后，可查看银行卡管理列表页面<BR>- 修改：可使用修改功能跳转至修改页面修改银行卡内容 |

#### 1-4-2. 银行卡管理 
- 列表 https://ckoi43.axshare.com/#id=c7sbrc&p=%E9%93%B6%E8%A1%8C%E5%8D%A1%E5%88%97%E8%A1%A8&g=1
    - 查询条件

    | 栏位   | 格式 |  说明 |
    | ---------- |  :--------: | -------- |
    | 银行卡代码  | textbox | 模糊查询 |
    | 银行 | 单选式下拉选单 | 选单内容：显示当前[综合管理>银行别管理]卡国别为「中国」的[银行别]名称 |
    | 所属会员  | textbox | 1.查询银行卡归属会员帐号<br>2.模糊查询 |
    | 户名  | textbox | 模糊查询 |
    | 银行卡号  | textbox | 模糊查询 |
    | 关联手机  | textbox | 模糊查询 |
    | 状态 | 单选式下拉选单 | 1.预设显示「请选择」<br>2.选单内容：待审批、启用、停用、退回补件、关闭(隐藏) |
    | 查询 | button | 点击后，依查询条件显示对应筛选结果列表 |
    
    - 结果列表

    | 栏位   | 格式 |  说明 |
    | ---------- |  :--------: | -------- |
    | 所属会员  | 文字连结 | 1.显示银行卡归属会员帐号<br>2.点击文字连结后，自动跳转至该会员帐号修改页面 |
    | 银行卡代码  | 文字显示 | 1.显示系统自动生成的银行卡代码<br>2.同一卡片种类中，此代码为唯一值<br>3.银行卡代码显示格式请见[国行专属银行卡代码](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#1-2-%E5%9B%BD%E8%A1%8C%E4%B8%93%E5%B1%9E%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BB%A3%E7%A0%81) |
    | 银行 | 文字显示 | 显示银行卡的银行别名称 |
    | 户名  | 文字显示 | 显示银行卡的户名 |
    | 银行卡号  | 文字显示 | 显示银行卡的银行卡号 |
    | 关联手机  | 文字显示 | 显示银行卡的手机号 |
    | 状态 | 文字显示 | 1.显示银行卡当前状态<BR>2.显示内容：待审批、启用、停用、退回补件、关闭(隐藏) |
    | 建立时间 | 文字显示 | 1.显示新增该银行卡的时间<BR>2.格式：yyyy-mm-dd hh:mm:ss |
    | 更新时间 | 文字显示 | 1.显示编辑该银行卡最新的更新时间<BR>2.格式：yyyy-mm-dd hh:mm:ss |
    | 操作 | button | 显示`修改`按钮<br>&nbsp;&nbsp;- 修改：点击后跳转至修改页面 |

- 修改 https://ckoi43.axshare.com/#id=byr6hr&p=%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BF%AE%E6%94%B9&g=1
    - 页面内容栏位内容预设显示前次设定

    | 栏位   | 格式 | 必填 | 说明 |
    | ---------- | :----: | :----: | -------- |
    | 所属会员  | 文字显示 | -- | 1.显示银行卡归属会员帐号<br>2.只可查看不可修改 |
    | 银行卡代码  | 文字显示 | -- | 1.显示系统自动生成的银行卡代码，显示格式请见[国行专属银行卡代码](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#1-2-%E5%9B%BD%E8%A1%8C%E4%B8%93%E5%B1%9E%E9%93%B6%E8%A1%8C%E5%8D%A1%E4%BB%A3%E7%A0%81)<br>2.只可查看不可修改 |
    | 银行 | 文字显示 | -- | 1.显示银行卡的银行别名称<br>2.只可查看不可修改 |
    | 支行* | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
    | 开户地区(省)* | 单选式下拉 | Y | 1.选单内容：显示DB记录的省份清单<br>2.此栏位选项更改后，会影响「开户地区(市)」栏位选单 |
    | 开户地区(市)* | 单选式下拉 | Y | 1.选单内容与「开户地区(省)」连动<br>2.选单内容：依选取的省份显示DB记录的城市清单 |
    | 居住地区(省)* | 单选式下拉 | Y | 1.选单内容：显示DB记录的省份清单<br>2.此栏位选项更改后，会影响「居住地区(市)」栏位选单 |
    | 居住地区(市)* | 单选式下拉 | Y | 1.选单内容与「居住地区(省)」连动<br>2.选单内容：依选取的省份显示DB记录的城市清单 |
    | 户名* | textbox |  Y  | 1.输入文字符号不限<br>2.长度：最多20位 |
    | 银行卡号* | textbox |  Y  | 1.只可输入正整数0~9<br>2.长度：最多20位 |
    | 身份证号* | textbox |  Y  | 1.只可输入数字和字母X(不分大小写)=>因为部份中国身份证末码会有"X"<br>2.长度：最多20位 |
    | 关联手机* | textbox |  Y  | 1.只可输入正整数0~9<br>2.长度：最多20位 |
    | 网路银行登入帐号* | textbox |  Y  | 1.只可输入英文数字，字母大小写不限<br>2.长度：最多20位 |
    | 网银/微信银行登入密码* | textbox |  Y  | 1.只可输入英文数字，字母区分大小写<br>2.长度：最多20位 |
    | 状态 | radiobox | Y | 1.预设：待审批<br>2.选单内容：待审批、启用、停用、退回补件、关闭(隐藏)<br>3.状态由「待审批」变更为其他状态提交成功后，「待审批」disable<br>4.状态由任一状态更新为「关闭(隐藏)」提交成功后，银行卡状态disable=>此状态形同删除银行卡，表示银行卡不再使用也不可再更改状态<br>&nbsp;&nbsp;- **状态「关闭(隐藏)」的银行卡不回传APP显示** |
    | 银行别备注 | 文字显示 | -- | 此区块有资料时才显示(没资料此区域不显示) |
    | %额外栏位% | textbox | Y | 1.%额外栏位名称%：显示银行卡的银行别于[综合管理>银行别管理>新增/修改]页面配置栏位名称<br>2.栏位内容输入文字符号不限<br>3.长度：最多20位 |
    | 送出 | button |  --  | 点击后，<br>1.检查各设定是否符合输入规范<br>&nbsp;&nbsp;- 是：储存页面设定资料并跳转至会员管理列表<br>&nbsp;&nbsp;- 否：显示对应提示讯息，ex：登入帐号为必填…etc(文字内容依开发定义)<br>2.检查状态为「关闭(隐藏)」时，于当前页面出现提示弹框"银行卡关闭后将不可使用，请问确定关闭?"<br>&nbsp;&nbsp;- 关闭：点击后，关闭弹框停留当前修改页面<br>&nbsp;&nbsp;- 送出：点击后，储存页面设定资料并跳转至[金宝>银行卡管理]列表 |

### 1-4. 金流应用 APP版本管理 新增特定会员更新
TO BE COMPELET

## 2. API
### 2-1. 新增发送邮箱验证
收到APP的验证请求后，应先比对APP提供的email是否与该会员记录的注册邮箱相同
- 是：经由邮箱验证API发送邮箱验证连结至该邮箱→用户于时效内点击连结→使用用户新设定密码更新密码
- 否：返回errormessage「输入邮箱与注册邮箱不符」

邮箱验证文件参照(实作方式依开发为主)
https://docs.edgegallery.org/zh_CN/latest/Projects/User%20Management/User_Features.html

- 邮箱验证Email示意(邮件内容排版依开发定义)
```
主旨：重置密码
亲爱的用户，您好，
您的登入帐号：quanna444
邮箱验证码：AJB3ID
请于30分钟内尽速，完成邮箱验证。

如果您没有进行过重置密码的操作，请尽速联系客服。
TG:@claire777 
Skype:123123@yytk.cc7
```
① 主旨：显示[金流应用>APP设定>Email主旨设定]的设定内容
② 验证连结时效：依**mail发送建立时间起算30分钟**(此时间配置建议设置于.env，保留可调整此时效的弹性)
&nbsp;&nbsp;&nbsp;&nbsp;● 会员于此30分钟后才进行邮箱验证，该验证码失效
③ 验证碼：显示6位英数混和验证码
④ 联系资讯
&nbsp;&nbsp;&nbsp;&nbsp;● [国行>联系资料]有设定联系资讯时才显示已存在的联系信息
&nbsp;&nbsp;&nbsp;&nbsp;● 联系记录的「url scheme」有设定值时，该联系资讯显示文字连结(以该url超连结)
&nbsp;&nbsp;&nbsp;&nbsp;● 联系项目有多个时，建议每个联系项目换行显示

### API Error Message
* http://doc.1-pay.co:8480/pages/viewpage.action?pageId=328850

## 【服务端-Cashpool】
-  依[更换卡片种类流程](https://hackmd.io/5pW79QijTla0H0_naiRfDA?both#%E6%9B%B4%E6%8D%A2%E5%8D%A1%E7%89%87%E7%A7%8D%E7%B1%BB%E6%B5%81%E7%A8%8B)，Paymentflow的银行卡进行卡片种类切换后，会在对应的卡片种类银行卡资料表进行资料新增或修改，但对应在Cashpool的银行卡仍会是同一张银行卡并使用国行专转的银行卡代码进行卡片识别。

- [编辑银行卡>执行模式]栏内设定回应paymentflow，藉以提供识银行卡当前执行模式

END