epusdt 0.2.0__tar.gz

epusdt-0.2.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Yufeifeio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

epusdt-0.2.0/PKG-INFO

@@ -0,0 +1,259 @@
+Metadata-Version: 2.4
+Name: epusdt
+Version: 0.2.0
+Summary: Python SDK for GMWalletApp/epusdt GMPay and EPay integrations
+Author: Yufeifeio
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Yufeifeio/epusdt-python-sdk
+Project-URL: Source, https://github.com/Yufeifeio/epusdt-python-sdk
+Project-URL: Issues, https://github.com/Yufeifeio/epusdt-python-sdk/issues
+Keywords: epusdt,gmpay,epay,payment,crypto,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests<3,>=2.31
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Provides-Extra: qrcode
+Requires-Dist: qrcode[pil]>=7.4; extra == "qrcode"
+Dynamic: license-file
+
+# Epusdt Python SDK
+
+`epusdt` 的 Python SDK，按 `GMWalletApp/epusdt` 当前公开支付接口实现。
+
+当前已覆盖的商户接入能力：
+
+- `POST /payments/gmpay/v1/order/create-transaction`
+- `GET /payments/gmpay/v1/config`
+- `GET /pay/checkout-counter-resp/{trade_id}`
+- `GET /pay/check-status/{trade_id}`
+- `POST /pay/switch-network`
+- `POST /pay/submit-tx-hash/{trade_id}`
+- `GET/POST /payments/epay/v1/order/create-transaction/submit.php`
+- GMPay / EPay 两套回调验签
+
+## 安装
+
+当前版本已经把包名配置为 `epusdt`，但还没有发布到 PyPI。
+
+所以现在可用的安装方式是：
+
+```bash
+pip install git+https://github.com/Yufeifeio/epusdt-python-sdk.git
+```
+
+如果要启用二维码功能：
+
+```bash
+pip install "epusdt[qrcode] @ git+https://github.com/Yufeifeio/epusdt-python-sdk.git"
+```
+
+如果以后发布到 PyPI，就可以直接使用：
+
+```bash
+pip install epusdt
+pip install epusdt[qrcode]
+pip install --upgrade epusdt
+```
+
+本地开发安装：
+
+```bash
+pip install -e .
+```
+
+## 功能说明
+
+- 使用 `pid + secret_key`
+- 主下单入口是 `GMPay v1`
+- 支持创建 `status=4` 占位订单
+- 支持后续 `switch-network`
+- 支持 `submit-tx-hash` 手动补单
+- 支持 `EPay submit.php` 重定向模式
+- 支持 GMPay JSON 回调验签
+- 支持 EPay GET 回调验签
+- 支持二维码生成功能（可选依赖）
+
+## 快速开始
+
+```python
+from epusdt import EpusdtClient
+
+client = EpusdtClient(
+    base_url="https://pay.example.com",
+    pid="1000",
+    secret_key="epusdt_secret_key",
+)
+
+order = client.create_order(
+    order_id="ORD202606240001",
+    amount=100,
+    currency="cny",
+    token="usdt",
+    network="tron",
+    notify_url="https://merchant.example.com/notify",
+    redirect_url="https://merchant.example.com/return",
+    name="VIP",
+)
+
+print(order.trade_id)
+print(order.payment_url)
+```
+
+## 占位订单
+
+如果你要先创建订单，再让用户在收银台选择网络和币种：
+
+```python
+placeholder = client.create_order(
+    order_id="ORD202606240002",
+    amount=88.5,
+    currency="cny",
+    notify_url="https://merchant.example.com/notify",
+)
+
+print(placeholder.status)   # OrderStatus.WAITING_SELECTION
+print(placeholder.trade_id)
+
+selected = client.switch_network(
+    trade_id=placeholder.trade_id,
+    token="USDT",
+    network="solana",
+)
+```
+
+## EPay 兼容模式
+
+构造 `submit.php` 跳转地址：
+
+```python
+url = client.build_epay_redirect_url(
+    out_trade_no="ORD202606240003",
+    money=100,
+    notify_url="https://merchant.example.com/notify",
+    return_url="https://merchant.example.com/return",
+    name="VIP",
+)
+
+print(url)
+```
+
+也可以直接请求网关并拿到它返回的收银台地址：
+
+```python
+redirect = client.create_epay_order(
+    out_trade_no="ORD202606240003",
+    money=100,
+    notify_url="https://merchant.example.com/notify",
+    return_url="https://merchant.example.com/return",
+)
+
+print(redirect.checkout_url)
+```
+
+## 手动提交交易哈希
+
+```python
+result = client.submit_tx_hash(
+    trade_id="20260523171652123456001",
+    block_transaction_id="0xabc123",
+)
+
+print(result.status)
+print(result.block_transaction_id)
+```
+
+## 回调验签
+
+GMPay JSON 回调：
+
+```python
+payload = {
+    "pid": "1000",
+    "trade_id": "20260523171652123456001",
+    "order_id": "ORD202605230001",
+    "amount": 100,
+    "actual_amount": 14.29,
+    "receive_address": "TTestTronAddress001",
+    "token": "USDT",
+    "block_transaction_id": "0xabc123",
+    "status": 2,
+    "signature": "a1b2c3",
+}
+
+callback = client.parse_gmpay_callback(payload)
+print(callback.trade_id)
+```
+
+EPay GET 回调：
+
+```python
+params = {
+    "pid": "1000",
+    "trade_no": "20260523171652123456001",
+    "out_trade_no": "ORD202605230001",
+    "type": "alipay",
+    "name": "VIP",
+    "money": "100.0000",
+    "trade_status": "TRADE_SUCCESS",
+    "sign": "a1b2c3",
+    "sign_type": "MD5",
+}
+
+callback = client.parse_epay_callback(params)
+print(callback.out_trade_no)
+```
+
+## 二维码
+
+安装可选依赖后，可以直接生成二维码：
+
+```python
+order = client.get_checkout("20260523171652123456001")
+
+image = order.generate_qrcode()
+image.save("epusdt-payment.png")
+
+base64_data = order.get_qrcode_base64()
+data_uri = order.get_qrcode_data_uri()
+```
+
+## API 一览
+
+- `create_order(...)`
+- `get_public_config()`
+- `get_checkout(trade_id)`
+- `check_status(trade_id)`
+- `switch_network(trade_id, token, network)`
+- `submit_tx_hash(trade_id, block_transaction_id)`
+- `build_epay_params(...)`
+- `build_epay_redirect_url(...)`
+- `create_epay_order(...)`
+- `verify_gmpay_callback(payload)`
+- `verify_epay_callback(params)`
+- `parse_gmpay_callback(payload)`
+- `parse_epay_callback(params)`
+
+## 开发
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+pip install -U pip build pytest
+pip install -e .
+pytest
+python -m build
+```

epusdt-0.2.0/README.md

@@ -0,0 +1,227 @@
+# Epusdt Python SDK
+
+`epusdt` 的 Python SDK，按 `GMWalletApp/epusdt` 当前公开支付接口实现。
+
+当前已覆盖的商户接入能力：
+
+- `POST /payments/gmpay/v1/order/create-transaction`
+- `GET /payments/gmpay/v1/config`
+- `GET /pay/checkout-counter-resp/{trade_id}`
+- `GET /pay/check-status/{trade_id}`
+- `POST /pay/switch-network`
+- `POST /pay/submit-tx-hash/{trade_id}`
+- `GET/POST /payments/epay/v1/order/create-transaction/submit.php`
+- GMPay / EPay 两套回调验签
+
+## 安装
+
+当前版本已经把包名配置为 `epusdt`，但还没有发布到 PyPI。
+
+所以现在可用的安装方式是：
+
+```bash
+pip install git+https://github.com/Yufeifeio/epusdt-python-sdk.git
+```
+
+如果要启用二维码功能：
+
+```bash
+pip install "epusdt[qrcode] @ git+https://github.com/Yufeifeio/epusdt-python-sdk.git"
+```
+
+如果以后发布到 PyPI，就可以直接使用：
+
+```bash
+pip install epusdt
+pip install epusdt[qrcode]
+pip install --upgrade epusdt
+```
+
+本地开发安装：
+
+```bash
+pip install -e .
+```
+
+## 功能说明
+
+- 使用 `pid + secret_key`
+- 主下单入口是 `GMPay v1`
+- 支持创建 `status=4` 占位订单
+- 支持后续 `switch-network`
+- 支持 `submit-tx-hash` 手动补单
+- 支持 `EPay submit.php` 重定向模式
+- 支持 GMPay JSON 回调验签
+- 支持 EPay GET 回调验签
+- 支持二维码生成功能（可选依赖）
+
+## 快速开始
+
+```python
+from epusdt import EpusdtClient
+
+client = EpusdtClient(
+    base_url="https://pay.example.com",
+    pid="1000",
+    secret_key="epusdt_secret_key",
+)
+
+order = client.create_order(
+    order_id="ORD202606240001",
+    amount=100,
+    currency="cny",
+    token="usdt",
+    network="tron",
+    notify_url="https://merchant.example.com/notify",
+    redirect_url="https://merchant.example.com/return",
+    name="VIP",
+)
+
+print(order.trade_id)
+print(order.payment_url)
+```
+
+## 占位订单
+
+如果你要先创建订单，再让用户在收银台选择网络和币种：
+
+```python
+placeholder = client.create_order(
+    order_id="ORD202606240002",
+    amount=88.5,
+    currency="cny",
+    notify_url="https://merchant.example.com/notify",
+)
+
+print(placeholder.status)   # OrderStatus.WAITING_SELECTION
+print(placeholder.trade_id)
+
+selected = client.switch_network(
+    trade_id=placeholder.trade_id,
+    token="USDT",
+    network="solana",
+)
+```
+
+## EPay 兼容模式
+
+构造 `submit.php` 跳转地址：
+
+```python
+url = client.build_epay_redirect_url(
+    out_trade_no="ORD202606240003",
+    money=100,
+    notify_url="https://merchant.example.com/notify",
+    return_url="https://merchant.example.com/return",
+    name="VIP",
+)
+
+print(url)
+```
+
+也可以直接请求网关并拿到它返回的收银台地址：
+
+```python
+redirect = client.create_epay_order(
+    out_trade_no="ORD202606240003",
+    money=100,
+    notify_url="https://merchant.example.com/notify",
+    return_url="https://merchant.example.com/return",
+)
+
+print(redirect.checkout_url)
+```
+
+## 手动提交交易哈希
+
+```python
+result = client.submit_tx_hash(
+    trade_id="20260523171652123456001",
+    block_transaction_id="0xabc123",
+)
+
+print(result.status)
+print(result.block_transaction_id)
+```
+
+## 回调验签
+
+GMPay JSON 回调：
+
+```python
+payload = {
+    "pid": "1000",
+    "trade_id": "20260523171652123456001",
+    "order_id": "ORD202605230001",
+    "amount": 100,
+    "actual_amount": 14.29,
+    "receive_address": "TTestTronAddress001",
+    "token": "USDT",
+    "block_transaction_id": "0xabc123",
+    "status": 2,
+    "signature": "a1b2c3",
+}
+
+callback = client.parse_gmpay_callback(payload)
+print(callback.trade_id)
+```
+
+EPay GET 回调：
+
+```python
+params = {
+    "pid": "1000",
+    "trade_no": "20260523171652123456001",
+    "out_trade_no": "ORD202605230001",
+    "type": "alipay",
+    "name": "VIP",
+    "money": "100.0000",
+    "trade_status": "TRADE_SUCCESS",
+    "sign": "a1b2c3",
+    "sign_type": "MD5",
+}
+
+callback = client.parse_epay_callback(params)
+print(callback.out_trade_no)
+```
+
+## 二维码
+
+安装可选依赖后，可以直接生成二维码：
+
+```python
+order = client.get_checkout("20260523171652123456001")
+
+image = order.generate_qrcode()
+image.save("epusdt-payment.png")
+
+base64_data = order.get_qrcode_base64()
+data_uri = order.get_qrcode_data_uri()
+```
+
+## API 一览
+
+- `create_order(...)`
+- `get_public_config()`
+- `get_checkout(trade_id)`
+- `check_status(trade_id)`
+- `switch_network(trade_id, token, network)`
+- `submit_tx_hash(trade_id, block_transaction_id)`
+- `build_epay_params(...)`
+- `build_epay_redirect_url(...)`
+- `create_epay_order(...)`
+- `verify_gmpay_callback(payload)`
+- `verify_epay_callback(params)`
+- `parse_gmpay_callback(payload)`
+- `parse_epay_callback(params)`
+
+## 开发
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+pip install -U pip build pytest
+pip install -e .
+pytest
+python -m build
+```

epusdt-0.2.0/epusdt/__init__.py

@@ -0,0 +1,78 @@
+from .client import EpusdtClient
+from .exceptions import (
+    APIError,
+    AuthenticationError,
+    ClientError,
+    EpusdtError,
+    NetworkError,
+    RequestTimeoutError,
+    ServerError,
+    SignatureError,
+    ValidationError,
+)
+from .models import (
+    CheckStatusResponse,
+    CheckoutOrder,
+    CreateOrderResponse,
+    EPayRedirectResponse,
+    EpayCallback,
+    EpayDefaults,
+    GmpayCallback,
+    ManualPaymentResponse,
+    Network,
+    OkpayConfig,
+    OrderStatus,
+    PaymentType,
+    PublicConfig,
+    SiteConfig,
+    SupportedAsset,
+    Token,
+    TradeStatus,
+)
+from .signature import (
+    build_epay_signing_string,
+    build_gmpay_signing_string,
+    generate_epay_signature,
+    generate_gmpay_signature,
+    verify_epay_signature,
+    verify_gmpay_signature,
+)
+
+__all__ = [
+    "APIError",
+    "AuthenticationError",
+    "CheckStatusResponse",
+    "CheckoutOrder",
+    "ClientError",
+    "CreateOrderResponse",
+    "EPayRedirectResponse",
+    "EpayCallback",
+    "EpayDefaults",
+    "EpusdtClient",
+    "EpusdtError",
+    "GmpayCallback",
+    "ManualPaymentResponse",
+    "Network",
+    "NetworkError",
+    "OkpayConfig",
+    "OrderStatus",
+    "PaymentType",
+    "PublicConfig",
+    "RequestTimeoutError",
+    "ServerError",
+    "SignatureError",
+    "SiteConfig",
+    "SupportedAsset",
+    "Token",
+    "TradeStatus",
+    "ValidationError",
+    "build_epay_signing_string",
+    "build_gmpay_signing_string",
+    "generate_epay_signature",
+    "generate_gmpay_signature",
+    "verify_epay_signature",
+    "verify_gmpay_signature",
+]
+
+__version__ = "0.2.0"
+__url__ = "https://github.com/Yufeifeio/epusdt-python-sdk"