Bepusdt (Better Easy Payment Usdt)
🪧 介绍
基本就是对Epusdt重新造了一次轮子，移除一些非必要依赖(Redis MySQL)，同时加入一些新特性，让个人USDT.TRC20
收款更好用、部署更便捷！
🎉 新特性
- ✅ 具备
Epusdt的所有特性，插件兼容无缝替换 - ✅ USDT汇率实时同步交易所，且支持在以此基础上波动
- ✅ 不依赖
MySQL Redis环境，支持Docker部署 - ✅ 支持非订单交易监控通知，钱包余额变动及时通知
- ✅ 机器人支持查询当前实时汇率，计算实际浮动汇率
- ✅ 机器人支持任意地址查询 USDT、TRX余额等信息
- ✅ 订单收款成功和余额变动通知 支持指定群组推送
- ✅ 支持可自定义USDT支付数额的精度，递增颗粒度
- ✅ 底层直接采用区块扫描，不依赖三方API，秒级响应
- ✅ 支持【TRX】收款， TRX余额变动监控通知
- ✅ 支持钱包地址 能量代理和能量回收 监控通知
- ⭕️ 待实现：支持等待支付和支付超时 订单状态回调
- ⭕️ 待实现：原生支持易支付对接，不依赖额外插件
🛠 参数配置
Bepusdt 所有参数都是以传递环境变量的方式进行配置，大部分参数含默认值，少量配置即可直接使用！
参数列表
| 参数名称 | 默认值 | 用法说明 |
|---|---|---|
| EXPIRE_TIME | 600 |
订单有效期，单位秒 |
| USDT_RATE | 6.4 | USDT汇率，默认留空则获取Okx交易所的汇率(每分钟同步一次)，支持多种写法，如：7.4 表示固定7.4、～1.02表示最新汇率上浮2%、～0.97表示最新汇率下浮3%、+0.3表示最新加0.3、-0.2表示最新减0.2，以此类推；如参数错误则使用固定值6.4 |
| USDT_ATOM | 0.01 |
0.01表示支付数额保留两位小数，相同金额时递增颗粒度为0.01，依次类推，如无特殊需求不建议修改。 |
| TRX_RATE | 0.95 | 同 USDT_RATE |
| TRX_ATOM | 0.01 |
同 USDT_ATOM |
| AUTH_TOKEN | 123234 |
认证Token，对接会用到这个参数 |
| LISTEN | :8080 |
服务器HTTP监听地址 |
| TRADE_IS_CONFIRMED | 0 |
是否需要网络确认，禁用可以提高回调速度，启用则可以防止交易失败 |
| APP_URI | 空 | 应用访问地址，留空则系统自动获取，前端收银台会用到，建议设置，例如：https://token-pay.example.com |
| WALLET_ADDRESS | 空 | 启动时需要添加的钱包地址，多个请用半角符逗号,分开；当然，同样也支持通过机器人添加。 |
| TG_BOT_TOKEN | 无 | Telegram Bot Token，必须设置，否则无法使用 |
| TG_BOT_ADMIN_ID | 无 | Telegram Bot 管理员ID，必须设置，否则无法使用 |
| TG_BOT_GROUP_ID | 无 | Telegram 群组ID，设置之后机器人会将交易消息会推送到此群 |
| PAYMENT_AMOUNT_RANGE | 0.01,99999 |
支付监控的允许数额范围(闭区间)，设置合理数值可避免一些诱导式诈骗交易提醒 |
| TRON_GRPC_NODE | 18.141.79.38:50051 |
Tron区块网络的GRPC节点，可选列表：https://developers.tron.network/docs/networks#public-node |
Ps：所以综上所述，必须设置的参数有TG_BOT_TOKEN TG_BOT_ADMIN_ID，否则无法使用！
🚀 安装部署
🤔 常见问题
如何获取参数 TG_BOT_ADMIN_ID
Telegram 搜索@userinfobot机器人并启用，返回的ID就是TG_BOT_ADMIN_ID
⚠️ 特别注意
- 订单交易强依赖时间，请确保服务器时间准确性，否则可能导致订单异常！
- 部分功能依赖网络，请确保服务器网络纯洁性，否则可能导致功能异常！
📚 接口文档
支付订单创建请求
### 请求地址 ```http POST /api/v1/order/create-transaction ``` ### 请求数据 ```json { "trade_type": "usdt.trc20", // usdt.trc20(默认) 或 tron.trx "order_id": "787240927112940881", // 商户订单编号 "amount": 28.88, // 请求支付金额，CNY "signature":"123456abcd", // 签名 "notify_url": "https://example.com/callback", // 回调地址 "redirect_url": "https://example.com/callback" // 支付成功跳转地址 } ``` ### 响应内容 ```json { "status_code": 200, "message": "success", "data": { "trade_id": "b3d2477c-d945-41da-96b7-f925bbd1b415", // 本地交易ID "order_id": "787240927112940881", // 商户订单编号 "amount": "28.88", // 请求支付金额，CNY "actual_amount": "10", // 实际支付数额 usdt or trx "token": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", // 收款地址 "expiration_time": 1200, // 订单有效期，秒 "payment_url": "https://example.com//pay/checkout-counter/b3d2477c-d945-41da-96b7-f925bbd1b415" // 收银台地址 }, "request_id": "" } ```支付成功回调通知
```json { "trade_id": "b3d2477c-d945-41da-96b7-f925bbd1b415", "order_id": "787240927112940881", "amount": 28.88, "actual_amount": 10, "token": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "block_transaction_id": "12ef6267b42e43959795cf31808d0cc72b3d0a48953ed19c61d4b6665a341d10", "signature": "123456abcd", "status": 2 // 1:等待支付 2:支付成功 3:支付超时 } ```🙏 感谢
📢 声明
- 本项目仅供个人学习研究使用，任何人或组织在使用过程中请符合当地的法律法规，否则产生的任何后果责任自负。
🌟 Stargazers over time
