Skip to content

TokenPay v1.2.0

Latest

Choose a tag to compare

@github-actions github-actions released this 25 Sep 07:58

✨ 新功能

  • 后台管理页面:可以查看订单、汇率、币种,也可以手动触发回调。默认关闭,详见 Wiki/admin.md。
  • 新增 HMAC-SHA256 签名(可选):通过 Signature:UseHmacSha256 开启。不开启时仍使用 MD5,兼容旧对接。
  • 任意金额订单:动态地址模式下,订单可以接受任意到账金额,并可用 MinCustomAmount / MaxCustomAmount 限制最低和最高金额。
  • 四个内置支付页主题:v1-cyber-dark、v2-apple-minimal、v3-neo-crypto、v4-swiss-editorial。可在配置项 ThemeName 或 URL 参数中指定。
  • 新增 epay-pro 插件。仓库内其他插件(epay、dujiaoka、v2board、card-system)已支持 HmacSha256。
  • 页面语言可扩展:新增 ExtraLanguages 配置。访客语言没有对应页面时显示英文,不再显示中文。

🛠 优化与修复

  • 波场归集逻辑重写。动态地址同时持有 TRX 和 USDT 时,归集能省手续费。
  • 修复部分情况下签名原文不一致:金额统一以字符串输出,不受服务器区域设置影响,字段名按区分大小写的逐字节顺序排序。
  • 修复订单并发问题、ETH 小数位问题和归集余额问题。
  • 修复查单接口与回调返回的数据不一致(#61)。
  • 降低内存占用,新增依赖运行时的安装包,体积更小。
  • 完善各部署文档和接口文档。

⚠️ 升级注意事项

  1. 回调签名有变化,需要同步更新对接方的插件或验签代码
    • IsDynamicAmount 由 1/0 改为 true/false,参与签名的原文也按 true/false 拼接。
    • 回调新增 SignatureType(MD5 或 HmacSha256)、IsCustomAmount、MinCustomAmount、MaxCustomAmount 字段。
    • 如果验签代码写死了字段列表,或把布尔值按 1/0 处理,升级后验签会失败。建议按照最新文档说明修改,使用仓库插件的用户更新最新插件。
  2. 开启 HmacSha256 前,要先确认所有对接方都已支持,再把 Signature:UseHmacSha256 设为 true。
  3. 配置文件新增以下节点,请参考 appsettings.Example.json 补到自己的配置中:Admin、Signature、ThemeName、ExtraLanguages。
    • 要启用后台,先运行 ./TokenPay --hash-admin-password "强密码" 生成密码哈希,填入 Admin:PasswordHash,再把 Admin:Enabled 设为 true。生产环境请保持 RequireHttps: true。
  4. Docker 部署方式有变:删除了 Dockerfile。docker-compose.yml 改为用官方 aspnet:8.0 镜像挂载 ./publish 目录运行,容器名改为 TokenPay,端口为 8080。请按 Wiki/Docker-RUN.md 重新部署。
  5. 俄语页面已移除:Pay.ru.cshtml 和 OrderExpired.ru.cshtml 已删除。需要俄语时,在 ExtraLanguages 中加入 "ru" 并自己提供对应的页面文件。
  6. 数据库:订单表新增 3 个字段,程序启动时会自动同步。升级前仍建议备份 TokenPay.db。
  7. 如果自定义过 Pay.cshtml 等页面,请对照新版本合并改动,避免与主题和语言回退逻辑冲突。