fix: apply quota point conversion
This commit is contained in:
1 parent
2553e482a9
commit
ad66ae5f10
12 files changed
+205
-25
No files matched your search
@@ -70,7 +70,7 @@ sign = HMAC-SHA256(merchant_secret, content).hex()
|
||||
|
||||
## 支付成功业务回调
|
||||
|
||||
支付页只轮询本平台订单状态,不直接修改业务数据。支付宝、微信等渠道经服务端查单或验签通知确认实付成功后,服务端先按订单绑定的用户 ID 原子增加 PostgreSQL `users.quota`;只有积分入账成功,订单才会变为 `paid` 并返回充值成功。业务入账使用独立的唯一订单流水表 `multipay_recharge_credits`,重复通知和重复轮询不会重复增加积分。
|
||||
支付页只轮询本平台订单状态,不直接修改业务数据。支付宝、微信等渠道经服务端查单或验签通知确认实付成功后,服务端先按订单绑定的用户 ID 原子增加 PostgreSQL `users.quota`;换算比例固定为 `1 积分 = 5000 quota`,页面积分按 `Math.ceil(quota / 5000)` 显示。只有积分入账成功,订单才会变为 `paid` 并返回充值成功。业务入账使用独立的唯一订单流水表 `multipay_recharge_credits`,重复通知和重复轮询不会重复增加积分。
|
||||
|
||||
平台向 `notify_url` 发送 JSON:
|
||||
|
||||
@@ -103,7 +103,7 @@ sign = HMAC-SHA256(merchant_secret, content).hex()
|
||||
|
||||
- 后台“用户管理”用于创建和停用本地用户,并查看积分余额、成功充值次数和累计金额。
|
||||
- 后台“充值套餐”可配置套餐名称、显示金额、到账积分、启用状态和展示顺序。
|
||||
- 支付渠道确认成功后,服务端将套餐积分增加到 PostgreSQL `users.quota`;入账成功后才向支付页返回成功。
|
||||
- 支付渠道确认成功后,服务端按“套餐积分 × 5000”增加 PostgreSQL `users.quota`;入账成功后才向支付页返回成功。
|
||||
- 每个支付订单只允许生成一条业务入账流水;支付平台重复通知和页面重复轮询不会重复增加积分。
|
||||
- 收银台默认展示该用户最近六个月的成功充值记录。
|
||||
- 初始演示用户为 `demo-user`,仅用于本地验收,正式使用时请创建业务用户并停用演示用户。
|
||||
@@ -112,10 +112,18 @@ sign = HMAC-SHA256(merchant_secret, content).hex()
|
||||
|
||||
- 充值记录中的已支付订单可以由管理员发起原路全额退款。
|
||||
- 管理员可选择是否回退积分;默认回退该订单充值时到账的积分,也可以填写其他非负整数。
|
||||
- 支付渠道确认退款后,服务端按订单绑定的用户 ID 从 PostgreSQL `users.quota` 扣减积分,网页不会直接操作业务数据库。
|
||||
- 支付渠道确认退款后,服务端按“回退积分 × 5000”从订单用户的 PostgreSQL `users.quota` 扣减额度,网页不会直接操作业务数据库。
|
||||
- 退款请求号与积分回退流水均按订单保持唯一;重复点击、网络重试或渠道重复响应不会重复退款、重复扣减积分。
|
||||
- 微信退款处于处理中时,可在充值记录中点击“查询退款”继续确认状态。
|
||||
|
||||
历史版本曾按 `1 积分 = 1 quota` 写入流水。升级后在 PostgreSQL 可连接时执行一次:
|
||||
|
||||
```powershell
|
||||
bun run migrate:quota-scale
|
||||
```
|
||||
|
||||
脚本只修复能够通过本地订单明确验证的旧比例流水;已经符合 5000 倍比例的数据会跳过,其他不一致会停止并回滚。
|
||||
|
||||
## 官方支付配置
|
||||
|
||||
### 支付宝
|
||||
|
||||
Reference in new issue
Block a user