BEpusdt (Better Easy Payment Usdt)

tether

🪧 介绍

基本就是对Epusdt重新造了一次轮子，移除一些非必要依赖(Redis MySQL)，同时加入一些新特性，让个人USDT.TRC20 收款更好用、部署更便捷！

🎉 新特性

🌟 目前支持收款类型：trx usdt.trc20 usdt.bep20(币安) usdt.erc20(以太) usdt.polygon usdt.xlayer(OKX)

✅ 完全兼容 Epusdt，插件可无缝替换
✅ 实时同步 USDT 汇率，支持自定义浮动
✅ 无MySQL Redis依赖，支持Docker部署
✅ 支持非订单交易监控，钱包余额变动通知
✅ 支持自定义 USDT 支付精度与递增颗粒度
✅ 底层区块扫描，无第三方 API，秒级响应
✅ 支持波场能量代理与能量回收监控通知
✅ 原生支持易支付对接，无三方插件依赖
✅ 支持创建订单时自定义超时钱包地址
✅ 完整支持等待支付支付超时回调
✅ 支持事件WebHook 方便多方协同

🚀 安装部署

🖼 功能截图

screenshot

🤔 常见问题

如何获取参数 TG_BOT_ADMIN_ID

Telegram 搜索加入群@BEpusdtChat，随后发送命令/info，返回的ID就是TG_BOT_ADMIN_ID

⚠️ 特别注意

订单交易强依赖时间，请确保服务器时间准确性，否则可能导致订单异常！
部分功能依赖网络，请确保服务器网络纯洁性，否则可能导致功能异常！

📚 接口文档

创建订单

请求地址

http
POST /api/v1/order/create-transaction

请求数据

json
{
  "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",  // 可根据实际情况传入收款地址，亦可留空
  "trade_type": "usdt.trc20",  // usdt.trc20(默认) tron.trx 可选列表 https://github.com/v03413/bepusdt/blob/16d8df2cc5acc3d41c1c014ecb5370bd97f7e955/app/model/orders.go#L25:L30
  "order_id": "787240927112940881",   // 商户订单编号
  "amount": 28.88,   // 请求支付金额，CNY
  "signature":"123456abcd", // 签名
  "notify_url": "https://example.com/callback",   // 回调地址
  "redirect_url": "https://example.com/callback", // 支付成功跳转地址
  "timeout": 1200, // 超时时间(秒) 最低60；留空则取配置文件 expire_time，还是没有取默认600
  "rate": 7.4 // 强制指定汇率，留空则取配置汇率；支持多种写法，如：7.4表示固定7.4、～1.02表示最新汇率上浮2%、～0.97表示最新汇率下浮3%、+0.3表示最新加0.3、-0.2表示最新减0.2
}

响应内容

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": ""
}

取消订单

商户端系统可以通过此接口取消订单，取消后，系统将不再监控此订单，同时释放对应金额占用。

请求地址

http
POST /api/v1/order/cancel-transaction

请求数据

json
{
  "trade_id": "0TJV0br98YbNTQe7nQ",   // 交易ID
  "signature":"123456abcd" // 签名内容
}

响应内容

json
{
  "data": {
    "trade_id": "0TJV0br98YbNTQe7nQ"
  },
  "message": "success",
  "request_id": "",
  "status_code": 200
}

回调通知

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:支付超时
}

🙏 感谢

https://github.com/assimon/epusdt

📢 声明

本项目仅供个人学习研究使用，任何人或组织在使用过程中请符合当地的法律法规，否则产生的任何后果责任自负。

目录

BEpusdt (Better Easy Payment Usdt)

🪧 介绍

🎉 新特性

🚀 安装部署

🖼 功能截图

🤔 常见问题

如何获取参数 TG_BOT_ADMIN_ID

⚠️ 特别注意

📚 接口文档

请求地址

请求数据

响应内容

请求地址

请求数据

响应内容

🙏 感谢

📢 声明