钱包

获取钱包充值套餐列表

获取钱包充值套餐列表。

URL：/app-api/pay/wallet-recharge-package/list
Method：GET
需要鉴权：是

请求参数

无请求参数。

请求示例

GET /app-api/pay/wallet-recharge-package/list

响应示例

{
    "code": 0,
    "data": [
        {
            "id": 3,
            "name": "充值1000",
            "payPrice": 100000,
            "bonusPrice": 0
        },
        {
            "id": 4,
            "name": "充值1000元送100元",
            "payPrice": 100000,
            "bonusPrice": 10000
        }
    ],
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Long	套餐数据编号
name	String	套餐名称
payPrice	Long	支付金额，单位：分
bonusPrice	Long	赠送金额，单位：分

创建钱包充值记录

发起充值后，调用此接口创建充值记录，然后唤起支付方式。

URL：/app-api/pay/wallet-recharge/create
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
payPrice	Long	必传	支付金额，单位：分
packageId	Long	-	套餐数据编号

请求示例

{
    "payPrice": 100000,
    "packageId": 3
}

响应示例

{
    "code": 0,
    "data": {
        "id": 31,
        "payOrderId": 926
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Long	充值记录数据编号
payOrderId	Long	支付单数据编号，发起支付时使用

获取钱包充值记录分页

URL：/app-api/pay/wallet-recharge/page
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
pageNo	Long	必传	页码
pageSize	Long	必传	页大小
payStatus	Boolean	-	是否已支付

请求示例

{
    "pageNo": 1,
    "pageSize": -1,
    "payStatus": false
}

响应示例

{
    "code": 0,
    "data": {
        "list": [
            {
                "id": 31,
                "totalPrice": 100000,
                "payPrice": 100000,
                "bonusPrice": 0,
                "payChannelCode": null,
                "payChannelName": null,
                "payOrderId": 926,
                "payOrderChannelOrderNo": null,
                "payTime": null,
                "refundStatus": 0
            }
        ],
        "total": 1
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
id	Long	充值记录数据编号
totalPrice	Long	用户实际到账余额
payPrice	Long	实际支付金额
bonusPrice	Long	钱包赠送金额
payChannelCode	String	支付成功的支付渠道
payChannelName	String	支付渠道名
payOrderId	Long	支付单数据编号
payOrderChannelOrderNo	String	支付成功的外部订单号
payTime	Long	订单支付时间
refundStatus	Long	退款状态
no	String	订单号

获取用户钱包信息

进入钱包时调用，展示钱包余额、总收入、总支出。

URL：/app-api/pay/wallet/get
Method：GET
需要鉴权：是

请求参数

无请求参数。

请求示例

GET /app-api/pay/wallet/get

响应示例

{
    "code": 0,
    "data": {
        "balance": 0,
        "totalExpense": 0,
        "totalRecharge": 0
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
balance	Long	余额
totalExpense	Long	累计支出，单位：分
totalRecharge	Long	累计充值，单位：分

获取用户钱包流水分页

URL：/app-api/pay/wallet-transaction/page
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
type	Long	-	类型，1-收入，2-支出
createTime	数组	-	时间范围

请求示例

{
    "type": 1,
    "createTime": [
        1702869343000,
        1734958946000
    ]
}

响应示例

{
    "code": 0,
    "data": {
        "list": [
            {
                "bizType": 5,
                "price": 99900,
                "title": "更新余额",
                "createTime": 1734697696000
            }
        ],
        "total": 3
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
bizType	Long	业务类型
price	Long	交易金额，单位：分
title	String	标题
createTime	Long	创建时间

获取钱包流水统计

根据日期筛选获取钱包流水统计（总收入、总支出）。

URL：/app-api/pay/wallet-transaction/get-summary
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
createTime	数组	-	时间范围

请求示例

{
    "createTime": [
        1702869343000,
        1734958946000
    ]
}

响应示例

{
    "code": 0,
    "data": {
        "totalExpense": -608220,
        "totalIncome": 1109300
    },
    "msg": "成功"
}

响应说明

参数	类型	说明
totalExpense	Long	累计支出，单位：分
totalIncome	Long	累计收入，单位：分

使用说明

进入钱包时：调用 get、page 接口，展示钱包余额、总收入、总支出以及列表（默认全部），此时时间范围为空。
按时间筛选：调用 page 和 get-summary 接口，更新总收入、总支出及列表。
点击全部/收入/支出：调用 page 接口。

校验支付密码

URL：/app-api/pay/wallet/validatePaymentPwd
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
password	String	必传	支付密码（加密后）

请求示例

{ "password": "加密后的密码" }

响应示例

{ "code": 0, "data": true, "msg": "成功" }

响应说明

参数	类型	说明
data	Boolean	`true` 密码正确，`false` 密码错误

更新支付密码

URL：/app-api/pay/wallet/updatePaymentPwd
Method：POST
需要鉴权：是

请求参数

参数	类型	约束	说明
oldPassword	String	必传	原支付密码（加密后）
newPassword	String	必传	新支付密码（加密后）

请求示例

{ "oldPassword": "加密后的原密码", "newPassword": "加密后的新密码" }

响应示例

{ "code": 0, "data": true, "msg": "成功" }

响应说明

参数	类型	说明
data	Boolean	`true` 更新成功，`false` 更新失败

获取钱包充值套餐列表​

请求参数​

请求示例​

响应示例​

响应说明​

创建钱包充值记录​

请求参数​

请求示例​

响应示例​

响应说明​

获取钱包充值记录分页​

请求参数​

请求示例​

响应示例​

响应说明​

获取用户钱包信息​

请求参数​

请求示例​

响应示例​

响应说明​

获取用户钱包流水分页​

请求参数​

请求示例​

响应示例​

响应说明​

获取钱包流水统计​

请求参数​

请求示例​

响应示例​

响应说明​

校验支付密码​

请求参数​

请求示例​

响应示例​

响应说明​

更新支付密码​

请求参数​

请求示例​

响应示例​

响应说明​

获取钱包充值套餐列表

请求参数

请求示例

响应示例

响应说明

创建钱包充值记录

请求参数

请求示例

响应示例

响应说明

获取钱包充值记录分页

请求参数

请求示例

响应示例

响应说明

获取用户钱包信息

请求参数

请求示例

响应示例

响应说明

获取用户钱包流水分页

请求参数

请求示例

响应示例

响应说明

获取钱包流水统计

请求参数

请求示例

响应示例

响应说明

校验支付密码

请求参数

请求示例

响应示例

响应说明

更新支付密码

请求参数

请求示例

响应示例

响应说明