钱包接口
获取钱包配置
URL: GET /wallet/get_config
Query: 无
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| usdt_recharge_fee_rate | int | USDT充值手续费千分比, 10就是10/1000=0.01 |
| bankcard_recharge_fee_rate | int | 银行卡充值手续费千分比 |
| public_recharge_fee_rate | int | 对公充值手续费千分比 |
| offline_recharge_fee_rate | int | 线下充值手续费千分比 |
| recharge_fee_max | number | 充值手续费上限, 单位元 |
获取钱包
URL: GET /wallet/detail
Query: 无
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 钱包id |
| balance | number | 余额，单位元 |
充值
URL: POST /wallet/recharge
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| order_type | number | 是 | 订单类型, 1USDT, 2BankCard, 3对公转账, 4线下充值 |
| amount | number | 是 | 充值金额，所有金额都是整数且精确到分，如1850，表示18.5元 |
| vouchers | list<string> | 否 | 凭证列表 |
| remark | string | 否 | 备注 |
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 订单id |
| order_no | string | 订单号 |
获取充值订单列表
URL: GET /wallet/recharge_order?page=1
Query:
| 字段 | 必填 | 说明 |
|---|---|---|
| page | 否 | 页码，从1开始 |
| size | 否 | 每页大小 |
| search | 否 | 搜索关键词 |
| status | 否 | 订单状态, 0待审核, 1充值成功, 2充值被拒绝, 3充值取消, 4充值失败 |
| order_type | 否 | 订单类型, 1USDT, 2BankCard, 3对公转账 |
| start_date | 否 | 筛选开始日期, 格式2025-04-21 |
| end_date | 否 | 筛选结束日期, 格式2025-04-21 |
输出: list<RechargeOrder>
RechargeOrder
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 订单id |
| order_no | string | 订单号 |
| order_type | number | 订单类型, 1USDT, 2BankCard, 3对公转账 |
| amount | number | 充值金额, 单位元 |
| procedure_fee | number | 手续费, 单位元 |
| status | number | 订单状态, 0待审核, 1充值成功, 2充值被拒绝, 3充值取消, 4充值失败 |
| remark | string | 订单备注 |
| vouchers | list<string> | 凭证列表 |
| created_at | string | 创建时间 |
| updated_at | string | 更新时间 |
| audit_by_id | string | 审核人id |
| audit_by_username | string | 审核人 |
| audit_at | string | 审核时间 |
| audit_remark | string | 审核备注 |
更新充值凭证
URL: POST /wallet/recharge_order/{order_id}/update_vouchers
输入:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| vouchers | list<string> | 是 | 凭证URL列表 |
输出: 无
获取余额明细列表
URL: GET /wallet/record?page=1
Query:
| 字段 | 必填 | 说明 |
|---|---|---|
| page | 否 | 页码，从1开始 |
| size | 否 | 每页大小 |
| search | 否 | 搜索关键词 |
| record_type | 否 | 交易类型 |
| start_date | 否 | 筛选开始日期, 格式2025-04-21 |
| end_date | 否 | 筛选结束日期, 格式2025-04-21 |
输出: list<WalletRecord>
WalletRecord
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 明细id |
| record_type | number | 交易类型, 1充值, 2储值卡转出, 3额度卡预算转出, 4员工卡预算转出, 5子帐户转出, 6主帐户转出 101开卡, 102划转至储值卡, 103划转至额度卡预算, 104划转至员工卡预算, 105划转至子帐户, 106划转至主帐户 |
| record_type_str | string | 交易类型描述 |
| amount | number | 变动金额, 单位元 |
| balance | number | 变动后余额, 单位元 |
| remark | string | 备注 |
| created_at | string | 创建时间 |
| serial_number | string | 流水编号 |
| payer | string | 支出方 |
| receiver | string | 收入方 |
| detail | string | 交易内容 |
| operator | string | 操作人 |