❗️声明：本 SDK 为 BEpusdt 支付网关的非官方 Python 客户端库，仅供学习研究使用。使用本项目请遵守当地法律法规，任何违法违规使用产生的后果由使用者自行承担。
BEpusdt 支付网关的 Python SDK，让 Python 开发者能够快速集成 USDT/TRX/USDC 加密货币支付功能。
- 🎯 简单易用 - 几行代码即可集成
- 🔐 自动签名 - 内置签名生成和验证
- 🌐 多链支持 - 支持 10+ 区块链网络
- 💰 多币种 - USDT、USDC、TRX、ETH、BNB
- 🔄 自动重试 - 网络错误自动重试，提升成功率
- 📱 二维码生成 - 一键生成收款地址二维码
- 📝 类型提示 - 完整的 IDE 智能提示
- ✅ 生产就绪 - 经过真实环境测试
- 🔄 完全兼容 - 完整支持 BEpusdt API
🔥 主流网络：Tron (TRC20) · Ethereum (ERC20) · BSC (BEP20) · Polygon
⚡ 其他网络：Arbitrum · Solana · Aptos · X-Layer · Plasma
🔥 主流网络：Tron (TRC20) · Ethereum (ERC20) · BSC (BEP20) · Polygon
⚡ 其他网络：Arbitrum · Solana · Aptos · X-Layer · Base
💎 TRX (Tron) · ETH (Ethereum) · BNB (BSC)
pip install bepusdt
# 如需二维码功能
pip install bepusdt[qrcode]from bepusdt import BEpusdtClient, TradeType
# 初始化客户端（支持自动重试）
client = BEpusdtClient(
api_url="https://your-bepusdt-server.com",
api_token="your-api-token",
max_retries=3 # 可选：网络错误自动重试3次
)
# 创建订单
order = client.create_order(
order_id="ORDER_001",
amount=10.0,
notify_url="https://your-domain.com/notify",
trade_type=TradeType.USDT_TRC20
)
print(f"💰 支付金额: {order.actual_amount} USDT")
print(f"📍 收款地址: {order.token}")
print(f"🔗 支付链接: {order.payment_url}")SDK 会自动处理网络错误和服务器临时故障：
from bepusdt.exceptions import ServerError, NetworkError, TimeoutError
try:
order = client.create_order(...)
except ServerError as e:
# 服务器错误 5xx（已自动重试）
print(f"服务器错误: {e}")
except NetworkError as e:
# 网络连接失败（已自动重试）
print(f"网络错误: {e}")
except TimeoutError as e:
# 请求超时（已自动重试）
print(f"超时: {e}")自动重试配置：
client = BEpusdtClient(
api_url="https://your-server.com",
api_token="your-api-token",
max_retries=3, # 最多重试 3 次
retry_delay=1.0 # 初始延迟 1 秒（指数退避）
)order = client.create_order(
order_id="ORDER_001",
amount=10.0,
notify_url="https://your-domain.com/notify",
redirect_url="https://your-domain.com/success",
trade_type=TradeType.USDT_TRC20
)order = client.query_order(trade_id="xxx")
if order.status == OrderStatus.SUCCESS:
print("✅ 支付成功")@app.route('/notify', methods=['POST'])
def notify():
data = request.get_json()
if client.verify_callback(data):
# 处理支付成功
return "ok", 200
return "fail", 400# 创建订单后生成收款地址二维码
order = client.create_order(...)
# 方式1：保存为图片文件
qr = order.generate_qrcode()
qr.save("payment_qr.png")
# 方式2：获取 Base64（用于 API 返回）
qr_base64 = order.get_qrcode_base64()
# 方式3：获取 Data URI（直接用于 HTML img src）
data_uri = order.get_qrcode_data_uri()
# <img src="{data_uri}">- 💬 Telegram: @luoyanglang
- 📝 提交 Issue
- 🔗 BEpusdt 官方群组
- 🏠 BEpusdt 官方
- 📦 PyPI 页面
- 💻 GitHub 仓库
- 📋 更新日志
本项目仅供学习研究使用，使用过程中请遵守当地法律法规，任何违法违规使用产生的后果由使用者自行承担。
Made with ❤️ for BEpusdt community