基本就是对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
,否则无法使用!
Telegram 搜索@userinfobot
机器人并启用,返回的ID就是TG_BOT_ADMIN_ID
- 订单交易强依赖时间,请确保服务器时间准确性,否则可能导致订单异常!
- 部分功能依赖网络,请确保服务器网络纯洁性,否则可能导致功能异常!
支付订单创建请求
POST /api/v1/order/create-transaction
{
"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" // 支付成功跳转地址
}
{
"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": ""
}
支付成功回调通知
{
"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:支付超时
}
- 本项目仅供个人学习研究使用,任何人或组织在使用过程中请符合当地的法律法规,否则产生的任何后果责任自负。