第一节、项目支付功能实战-微信支付项目功能设计及库表脚本

古城微笑少年丶 2024-02-05 11:35 4阅读 0赞

## 项目需求 ##

项目主体业务为二手车竞拍业务，类似于阿里拍卖与优信拍等拍卖软件。具体竞拍流程如下：

1.  用户注册小程序账号
2.  用户实名信息认证
3.  用户缴纳保证金
4.  参与竞拍

### 保证金业务概念 ###

谈起保证金业务，一般都会和账户系统挂钩，我们首先来说说保证金业务的使用都会涉及哪些场景：保证金系统体系是指在一些交易场景中，为了保证交易的履行和风险控制，而设立的一种资金管理机制。账号体系是指在互联网产品中，为了识别和管理用户，而设立的一种用户信息和资金信息的集合。简单一句话来说，保证金是平台用来约束行为人行为，避免给平台/平台用户造成损失的兜底性资金。

#### 保证金业务的设计流程 ####

通用流程主要分为保证金账户开通流程、保证金缴纳流程、保证金提现流程。  
**保证金账户开通**：保证金账户开通这个比较简单，保证金系统提供账户开通的接口即可，开通节点、开通校验等业务逻辑全由业务侧制定  
**保证金缴纳/充值**：保证金缴纳流程比较简单，与账户充值系统基本流程一致，在这里说下保证金缴纳流程下更底层的一些逻辑，主要包括保证金缴纳规则制定、保证金缴纳规则匹配等。  
**保证金提现：** 保证金充值采取的是订单/交易方式收款，用户提现有2种实现方案，一种是走退款，一种是走代付，两者中代付的方案更灵活，逻辑更简单，退款的方案限制性太多，例如三方退款是有时效限制的，超过一定时间就不能退了，有些劳动者会让他人代付，如果采用退款的话会造成资金错乱等等。保证金提现流程图如下：  
![在这里插入图片描述][89637057464243a093ad291d301ef61b.png]

*  流程：保证金系统体系的流程一般包括以下几个步骤：
    
    1.  用户在参与某种交易前，需要向平台或第三方支付机构缴纳一定比例或金额的保证金，作为交易的担保。
    2.  用户在交易过程中，根据交易的变化情况，可能需要追加或减少保证金，以维持交易的安全性。
    3.  用户在交易结束后，根据交易的结果，可能会获得保证金的返还或扣除，或者部分返还或扣除。
    4.  平台或第三方支付机构在收取、管理和退还保证金的过程中，需要进行严格的风险控制和监督，以防止保证金的挪用、丢失或滥用。
 *  体系：保证金系统体系的体系一般包括以下几个要素：
    
    1.  保证金账户：用于记录用户的保证金的存入、变动和退还的账户，一般是虚拟账户，与用户的实际资金账户相对应。
    2.  保证金规则：用于规定用户需要缴纳的保证金的比例或金额，以及保证金的追加、扣除和返还的条件和方式的规则，一般由平台或第三方支付机构制定，也可能由交易双方协商确定。
    3.  保证金风控：用于监测和控制保证金的风险，包括保证金的充足性、安全性和合规性的风控，一般由平台或第三方支付机构负责，也可能由监管机构或第三方机构参与。
 *  架构：保证金系统体系的架构一般包括以下几个模块：
    
    1.  保证金收付模块：用于实现用户的保证金的存入和退还的功能，一般需要对接银行或第三方支付机构的支付渠道，以实现资金的划拨和结算。
    2.  保证金账务模块：用于实现用户的保证金的变动和查询的功能，一般需要对接平台或第三方支付机构的账户体系，以实现资金的记录和管理。
    3.  保证金规则模块：用于实现用户的保证金的计算和执行的功能，一般需要对接平台或第三方支付机构的业务系统，以实现规则的设定和触发。
    4.  保证金风控模块：用于实现用户的保证金的监测和控制的功能，一般需要对接平台或第三方支付机构的风控系统，以实现风险的评估和预警。

下图为保证金体系架构图  
![在这里插入图片描述][eea221ae74924ecaa8cabc61f37395ff.png]

### 账户体系 ###

账号体系的流程、体系和架构：

*  流程：账号体系的流程一般包括以下几个步骤：
    
    1.  用户在使用某个互联网产品前，需要注册一个账号，作为用户的唯一标识和凭证。
    2.  用户在登录账号后，可以进行各种业务操作，如充值、消费、转账、提现等，以及查看和修改个人信息、账户信息、账务信息等。
    3.  用户在退出账号后，可以保留或删除账号，以及找回或重置账号的密码或其他信息。
 *  体系：账号体系的体系一般包括以下几个要素：
    
    1.  账号信息：用于记录用户的基本信息，如用户名、密码、手机号、邮箱等，以及账号的状态、类型、等级等，一般由用户自行填写或修改，也可能由平台或第三方支付机构验证或授权。
    2.  账户信息：用于记录用户的资金信息，如余额、积分、优惠券等，以及账户的属性、限额、规则等，一般由平台或第三方支付机构生成或管理，也可能由用户自行操作或设置。
    3.  账务信息：用于记录用户的资金变动情况，如充值、消费、转账、提现等，以及账务的流水号、时间、金额、状态等，一般由平台或第三方支付机构记录或处理，也可能由用户自行查询或申诉。
 *  架构：账号体系的架构一般包括以下几个模块：
    
    1.  账号管理模块：用于实现用户的账号的注册、登录、退出、找回、修改等功能，一般需要对接平台或第三方支付机构的用户系统，以实现用户的识别和认证。
    2.  账户管理模块：用于实现用户的账户的充值、消费、转账、提现等功能，一般需要对接平台或第三方支付机构的账户体系，以实现资金的记录和管理。
    3.  账务管理模块：用于实现用户的账务的查询、申诉、核对、对账等功能，一般需要对接平台或第三方支付机构的账务体系，以实现资金的变动和查询。
    4.  账号风控模块：用于实现用户的账号的安全和合规的功能，一般需要对接平台或第三方支付机构的风控系统，以实现账号的监测和控制。

### 保证金系统体系和账号体系的区别和联系： ###

*  区别：保证金系统体系和账号体系的区别主要在于以下几个方面：
    
    1.  目的：保证金系统体系的目的是为了保证交易的履行和风险控制，而账号体系的目的是为了识别和管理用户。
    2.  范围：保证金系统体系的范围是针对一些特定的交易场景，如期货、外汇、P2P等，而账号体系的范围是针对所有的互联网产品。
    3.  形式：保证金系统体系的形式是一种资金管理机制，而账号体系的形式是一种用户信息和资金信息的集合。
    4.  规则：保证金系统体系的规则是由平台或第三方支付机构制定，也可能由交易双方协商确定，而账号体系的规则是由平台或第三方支付机构制定，也可能由用户自行设置。
 *  联系：保证金系统体系和账号体系的联系主要在于以下几个方面：
    
    1.  关联：保证金系统体系和账号体系是相互关联的，因为用户的保证金是存放在用户的账户中，而用户的账户是通过用户的账号来识别和管理的。因此，保证金系统体系和账号体系需要协调和配合，以实现交易的顺利进行和用户的便捷使用。例如，用户在缴纳或退还保证金时，需要通过账号登录账户，然后选择支付渠道和金额，进行资金的划拨和结算。用户在查询或变更保证金时，也需要通过账号登录账户，然后查看或修改保证金账户的信息，进行资金的记录和管理。用户在参与或退出交易时，也需要通过账号登录账户，然后触发或执行保证金规则，进行资金的计算和返还。

## 项目功能逻辑设计 ##

上述我们了解了保证金和账户系统相关的业务概念，下面真正来进入到如何设计保证金这个系统以及支付渠道的选型。

在本项目的保证金缴纳业务中，首先我们要给保证金用户建立一个虚拟的业务账户，这个业务账户的目的就是显示用户账户的总金额、可用余额及冻结金额。为了简便，我们选择对接微信支付、和微信退款。支付则为用户充值，退款即为用户提现。这里提到的保证金虚拟账户不是第三方的资金账户，而是使用数据库创建表来代替账户，也就是在数据库中创建一个表来存储用户的实际资金流转情况。

保证金缴纳后，用户参与竞拍时首先会检查保证金的可用余额是否够用，如果够用，则可参与竞价，出价后会按业务竞拍规则冻结一部分保证金，这时就会产生冻结金额。此时，冻结金额+可用余额=保证金总金额。当用户成交或未中标后冻结的金额会自动解冻，解冻时会扣减冻结的金额并增加可用余额。

### 保证金功能设计 ###

1、用户账户信息的展示，主要包括总金额、可用余额、冻结金额。其中总金额=可用+冻结金额  
2、用户充值：充值主要是调起微信支付的逻辑  
3、用户退款：根据用户支付的订单进行退款，退款可分为两种方式，退订单的金额、部分退款。  
4、保证金使用记录：展示用户使用保证金的记录，包括，冻结、解冻、支付、提现（退款）等记录。  
5、保证金退款进度：展示提交退款申请后的办理进度，用户提交退款申请后，会提交给财务进行审核，审核通过后才会调起微信退款接口进行退款。

### 库表设计 ###

*  保证金用户账户表：USER\_ACCOUNT
 *  保证金使用记录表：USE\_RECORD
 *  保证金支付订单表：ORDER\_INFO
 *  保证金支付流水表：PAYMENT\_RECORD
 *  保证金提现申请单：REFUND\_APPLICATION，用户在app或小程序发起提现申请，交由卖家审核。
 *  保证金退款单表：REFUND\_INFO ，此表主要是在调起微信退款单时生成的退款单信息，微信回调后会更新退款单的状态。
 *  异常信息表：ERROR\_LOG 当业务发生异常时需要将错误的业务类型保存到异常表中，为后续手动异常处理做准备。

#### 用户账户建表sql ####

create table USER_AMOUNT
    (
        ID               varchar(32)          not null comment '唯一ID'
            primary key,
        TOTAL_MONEY      decimal(16, 2)       null comment '保证金总金额',
        AVAIL_MONEY      decimal(16, 2)       null comment '可用余额',
        FROZEN_MONEY     decimal(16, 2)       null comment '冻结金额',
        USER_ID          varchar(32)          null comment '用户id',
        CREATE_BY        varchar(32)          null comment '创建人id',
        CREATE_NAME      varchar(32)          null comment '创建人姓名',
        CREATE_TIME      datetime             null comment '创建时间/报价时间',
        UPDATE_BY        varchar(32)          null comment '修改人',
        UPDATE_NAME      varchar(32)          null comment '修改人姓名',
        UPDATE_TIME      datetime             null comment '修改时间'
    )
        comment '保证金账户表';

#### 保证金使用记录建表sql ####

create table USE_RECORD
    (
        ID               varchar(32)          not null comment '记录id'
            primary key,
        EVENT_STATUS     varchar(32)          null comment '保证金使用状态（0 冻结，1，解冻，2 保证金扣减，3 充值，4 退款）',
        USE_MONEY        decimal(16, 2)       null comment '使用金额/充值金额',
        TOTAL_MONEY      decimal(16, 2)       null comment '保证金总金额',
        AVAIL_MONEY      decimal(16, 2)       null comment '可用余额',
        FROZEN_MONEY     decimal(16, 2)       null comment '冻结金额',
        USER_ID          varchar(32)          null comment '用户id',
        REG_ID           varchar(32)          null comment '报名记录id',
        PAY_TRADE_NO     varchar(50)          null comment '交易单号（充值退款时使用该字段）（充值时代表订单号、退款时代表退款单号）',
        ACTUAL_TIME      datetime             null comment '业务数据插入的实际操作时间。如果保证金使用记录表出现异常，
    处理成功后插入异常时间作为业务操作时间',
        EVENT_DESC       varchar(255)         null comment '备注/充值异常原因/业务操作描述',
        CREATE_BY        varchar(32)          null comment '创建人id',
        CREATE_NAME      varchar(32)          null comment '创建人姓名',
        CREATE_TIME      datetime             null comment '创建时间/报价时间',
        UPDATE_BY        varchar(32)          null comment '修改人',
        UPDATE_NAME      varchar(32)          null comment '修改人姓名',
        UPDATE_TIME      datetime             null comment '修改时间'
    )
        comment '保证金使用记录';

#### 保证金支付订单表 ####

create table ORDER_INFO
    (
        ID               varchar(32)          not null comment '订单ID'
            primary key,
        ORDER_TITLE      varchar(64)          null comment '订单标题/名称',
        ORDER_NO         varchar(50)          null comment '商户订单编号',
        USER_ID          varchar(32)          null comment '用户id',
        TOTAL_FEE        bigint               null comment '订单金额(分)',
        CODE_URL         varchar(50)          null comment '订单二维码连接(Native支付时使用)',
        ORDER_STATUS     varchar(20)          null comment '订单状态(NOTPAY：未支付、SUCCESS：支付成功、CLOSED：超时已关闭、CANCEL：用户已取消)、
                    REFUND_PROCESSING：退款中、退款成功、退款异常)',
        REFUND_FEE       bigint               null comment '当前订单已退金额(分)',
        REFUND_STATUS    varchar(32)          null comment 'REFUND_SUCCESS：已全部退款、
    REFUND_PART：部分退款
    、NO_REFUND：未退款',
        PREPAY_ID        varchar(64)          null comment '预支付交易会话标识。用于后续接口调用中使用，该值有效期为2小时',
        PREPAY_RESPONSE  text                 null comment '支付下单响应数据',
        ERROR_CODE       varchar(20)          null comment '业务错误码',
        ERROR_DESC       varchar(64)          null comment '业务错误描述',
        REMARK           varchar(120)         null comment '备注',
        CREATE_NAME      varchar(32)          null comment '创建人姓名',
        CREATE_BY        varchar(32)          null comment '创建人id',
        UPDATE_BY        varchar(32)          null comment '修改人',
        UPDATE_NAME      varchar(32)          null comment '修改人姓名',
        UPDATE_TIME      datetime             null comment '修改时间',
        TRADE_STATE      varchar(50)          null comment '用户前端支付状态用于判断是否能再次支付默认为未支付(NOTPAY)，成功（SUCCESS）'
    )
        comment '保证金订单信息';

#### 保证金支付流水记录建表sql ####

create table PAYMENT_RECORD
    (
        ID               varchar(32)          not null comment '支付记录id'
            primary key,
        ORDER_NO         varchar(50)          null comment '商户订单编号',
        TRANSACTION_ID   varchar(50)          null comment '支付系统交易编号',
        PAYMENT_TYPE     varchar(20)          null comment '支付类型(微信)',
        TRADE_TYPE       varchar(20)          null comment '交易类型（小程序、H5、native、js，app，公众号）',
        TRADE_STATE      varchar(50)          null comment '交易状态（SUCCESS：支付成功
    REFUND：转入退款
    NOTPAY：未支付
    CLOSED：已关闭
    REVOKED：已撤销（付款码支付）
    USERPAYING：用户支付中（付款码支付）
    PAYERROR：支付失败(其他原因，如银行返回失败)）',
        PAYER_TOTAL      bigint               null comment '支付金额(分)',
        REMARK           varchar(200)         null comment '备注',
        CONTENT          text                 null comment '通知参数',
        CREATE_BY        varchar(32)          null comment '创建人id',
        CREATE_NAME      varchar(32)          null comment '创建人姓名',
        CREATE_TIME      datetime             null comment '创建时间/报价时间',
        UPDATE_BY        varchar(32)          null comment '修改人',
        UPDATE_NAME      varchar(32)          null comment '修改人姓名',
        UPDATE_TIME      datetime             null comment '修改时间'
    )
        comment '保证金支付记录信息';

#### 退款申请单建表sql ####

-- auto-generated definition
    create table REFUND_APPLICATION
    (
        ID                    varchar(32)          not null comment '退款申请单ID'
            primary key,
        REFUND_APPLICATION_NO varchar(50)          null comment '退款申请单编号',
        MONEY                 decimal(16, 2)       null comment '提现金额',
        PHONE                 varchar(32)          null comment '申请人手机号',
        CURRENT_TACHE         varchar(12)          null comment '当前环节（ XJ ：发起申请、JLSH：经理审核、CWSH：财务审核、GD：归档）',
        ACTUAL_REFUND_STATUS  varchar(32)          null comment '实际退款状态（SUCCESS退款成功，ABNORMAL退款失败，NO_REFUND默认值，未退款、CLOSED 退款关闭）',
        AUDIT_STATUS          varchar(6)           null comment '审核状态（DSH：待审核、BTG：审核不通过、TG：审核通过）',
        USER_ID               varchar(32)          null comment '用户id',
        ORDER_NO              varchar(50)          null comment '商户订单号',
        ACTUAL_REFUND_TIME    datetime             null comment '实际退款时间',
        REMARK                varchar(200)         null comment '备注/业务单失败原因/经理审核驳回时记录驳回原因',
        CREATE_NAME           varchar(32)          null comment '创建人姓名',
        CREATE_TIME           datetime             null comment '创建时间/报价时间',
        UPDATE_BY             varchar(32)          null comment '修改人',
        UPDATE_NAME           varchar(32)          null comment '修改人姓名',
        UPDATE_TIME           datetime             null comment '修改时间'
    )
        comment '保证金退款申请单';

#### 退款单记录建表sql ####

-- auto-generated definition
    create table REFUND_INFO
    (
        ID               varchar(32)          not null comment '退款单ID'
            primary key,
        ORDER_NO         varchar(50)          null comment '商户订单编号',
        REFUND_NO        varchar(50)          null comment '商户退款单编号',
        REFUND_ID        varchar(50)          null comment '支付系统退款单号',
        TOTAL_FEE        bigint               null comment '原订单金额(分)',
        REFUND           bigint               null comment '退款金额(分)',
        REASON           varchar(50)          null comment '退款原因',
        REFUND_STATUS    varchar(32)          null comment '退款状态',
        CONTENT_RETURN   text                 null comment '申请退款返回参数',
        CONTENT_NOTIFY   text                 null comment '退款结果通知参数',
        REFUND_TIME      datetime             null comment '退款时间',
        REFUND_APP_ID    varchar(32)          null comment '退款申请单ID',
        CREATE_BY        varchar(32)          null comment '创建人id',
        CREATE_NAME      varchar(32)          null comment '创建人姓名',
        CREATE_TIME      datetime             null comment '创建时间/报价时间',
        UPDATE_BY        varchar(32)          null comment '修改人',
        UPDATE_NAME      varchar(32)          null comment '修改人姓名',
        UPDATE_TIME      datetime             null comment '修改时间'
    )
        comment '保证金退款记录';

#### 异常信息建表sql ####

create table ERROR_LOG
    (
        ID               varchar(32)          not null comment '唯一主键ID'
            primary key,
        USER_ID          varchar(32)          null comment '用户id',
        EVENT_TYPE       varchar(20)          null comment '操作类型：充值（支付）：PAY、提现（退款）：REFUND',
        ERROR_CODE       varchar(20)          null comment '业务错误码(AMOUNT:更新余额，USERECORD：插入保证金记录)',
        ERROR_DESC       varchar(500)         null comment '业务错误描述（更新余额失败、插入保证金使用记录失败）',
        PAY_TRADE_NO     varchar(50)          null comment '关联交易单号',
        REMARK           varchar(120)         null comment '备注',
        CREATE_NAME      varchar(32)          null comment '创建人姓名',
        CREATE_BY        varchar(32)          null comment '创建人id',
        UPDATE_BY        varchar(32)          null comment '修改人',
        UPDATE_NAME      varchar(32)          null comment '修改人姓名',
        UPDATE_TIME      datetime             null comment '修改时间'
    )
        comment '异常信息';

## 总结 ##

本篇文章主要介绍了保证金相关的业务概念、项目需求、保证金系统架构和充值、提现等流程，最后并贴出了功能设计的代码和脚本。下一节，我们将介绍系统架构中的安全架构设计。

[89637057464243a093ad291d301ef61b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/40c6b07f94ef48edbeac874a560e94b6.png
[eea221ae74924ecaa8cabc61f37395ff.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/6297a7771de44467b54f94f6954e5759.png