threeypay-sdk 1.1.0__tar.gz

threeypay_sdk-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 湖北汇联科技有限公司
+
+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.

threeypay_sdk-1.1.0/PKG-INFO

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: threeypay-sdk
+Version: 1.1.0
+Summary: 3ypay (汇联支付) Python SDK - 统一支付、查询、退款、转账、分账等
+Author-email: 3YPay Team <support@3ypay.com>
+License: MIT
+Project-URL: Homepage, https://gitee.com/threeypay/threeypay-python-sdk
+Project-URL: Source, https://gitee.com/threeypay/threeypay-python-sdk
+Project-URL: Issues, https://gitee.com/threeypay/threeypay-python-sdk/issues
+Project-URL: Documentation, https://doc.3ypay.com/
+Keywords: payment,3ypay,alipay,wechat,unionpay,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: cryptography>=38.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Dynamic: license-file
+
+# 3YPay Python SDK
+
+[![PyPI version](https://badge.fury.io/py/threeypay-sdk.svg)](https://badge.fury.io/py/threeypay-sdk)
+[![Python Version](https://img.shields.io/pypi/pyversions/threeypay-sdk.svg)](https://pypi.org/project/threeypay-sdk/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+### V1.1.0。请务必参照对接文档进行对接
+
+1. **3ypay (汇联支付) Python SDK**，支持统一支付、交易查询、退款、转账、分账等功能。
+2. **具体参数说明**，请查看 [API文档](https://doc.3ypay.com/)。
+3. **请务必对照文档进行配置**，并确保代码正确运行。
+
+## 安装
+
+```bash
+pip install threeypay-sdk
+```
+
+## 快速开始
+
+### 1. 初始化 SDK
+
+```python
+from threeypay import ThreeYPay
+
+# 配置参数
+app_id = "YOUR_APP_ID"                    # 应用 APPID
+private_key = "YOUR_PRIVATE_KEY"          # 商户私钥 (RSA2)
+platform_public_key = "YOUR_PLATFORM_PUBLIC_KEY"  # 平台公钥
+is_sandbox = True                         # 是否使用测试环境
+
+# 初始化 SDK
+pay = ThreeYPay(app_id, private_key, platform_public_key, is_sandbox)
+```
+
+### 2. 支付宝扫码支付
+
+```python
+import time
+
+result = pay.payment().alipay(
+    mch_order_no=f"ORDER_{int(time.time() * 1000)}",
+    order_amount="0.01",
+    subject="测试商品",
+    description="商品描述",
+    notify_url="https://yourdomain.com/notify",
+    client_ip="127.0.0.1",
+    expired_time=int(time.time() * 1000) + 30*60*1000
+)
+
+print(result)
+```
+
+### 3. 交易查询
+
+```python
+result = pay.payment().query_by_pay_order_no("P202603062034302534880")
+print(result)
+```
+
+## 功能模块
+
+- **Payment** - 支付模块（支付宝、微信、银联等）
+- **Transfer** - 转账模块（安全发、直付通）
+- **ProfitSharing** - 分账模块
+- **Account** - 账户管理模块
+- **Merchant** - 商户管理模块
+
+## 文档
+
+完整API文档：https://doc.3ypay.com/
+
+## License
+
+MIT

threeypay_sdk-1.1.0/README.md

@@ -0,0 +1,75 @@
+# 3YPay Python SDK
+
+[![PyPI version](https://badge.fury.io/py/threeypay-sdk.svg)](https://badge.fury.io/py/threeypay-sdk)
+[![Python Version](https://img.shields.io/pypi/pyversions/threeypay-sdk.svg)](https://pypi.org/project/threeypay-sdk/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+### V1.1.0。请务必参照对接文档进行对接
+
+1. **3ypay (汇联支付) Python SDK**，支持统一支付、交易查询、退款、转账、分账等功能。
+2. **具体参数说明**，请查看 [API文档](https://doc.3ypay.com/)。
+3. **请务必对照文档进行配置**，并确保代码正确运行。
+
+## 安装
+
+```bash
+pip install threeypay-sdk
+```
+
+## 快速开始
+
+### 1. 初始化 SDK
+
+```python
+from threeypay import ThreeYPay
+
+# 配置参数
+app_id = "YOUR_APP_ID"                    # 应用 APPID
+private_key = "YOUR_PRIVATE_KEY"          # 商户私钥 (RSA2)
+platform_public_key = "YOUR_PLATFORM_PUBLIC_KEY"  # 平台公钥
+is_sandbox = True                         # 是否使用测试环境
+
+# 初始化 SDK
+pay = ThreeYPay(app_id, private_key, platform_public_key, is_sandbox)
+```
+
+### 2. 支付宝扫码支付
+
+```python
+import time
+
+result = pay.payment().alipay(
+    mch_order_no=f"ORDER_{int(time.time() * 1000)}",
+    order_amount="0.01",
+    subject="测试商品",
+    description="商品描述",
+    notify_url="https://yourdomain.com/notify",
+    client_ip="127.0.0.1",
+    expired_time=int(time.time() * 1000) + 30*60*1000
+)
+
+print(result)
+```
+
+### 3. 交易查询
+
+```python
+result = pay.payment().query_by_pay_order_no("P202603062034302534880")
+print(result)
+```
+
+## 功能模块
+
+- **Payment** - 支付模块（支付宝、微信、银联等）
+- **Transfer** - 转账模块（安全发、直付通）
+- **ProfitSharing** - 分账模块
+- **Account** - 账户管理模块
+- **Merchant** - 商户管理模块
+
+## 文档
+
+完整API文档：https://doc.3ypay.com/
+
+## License
+
+MIT

threeypay_sdk-1.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "threeypay-sdk"
+version = "1.1.0"
+requires-python = ">=3.9"
+description = "3ypay (汇联支付) Python SDK - 统一支付、查询、退款、转账、分账等"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "3YPay Team", email = "support@3ypay.com"}
+]
+keywords = ["payment", "3ypay", "alipay", "wechat", "unionpay", "sdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "requests>=2.28.0",
+    "cryptography>=38.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+]
+
+[project.urls]
+Homepage = "https://gitee.com/threeypay/threeypay-python-sdk"
+Source = "https://gitee.com/threeypay/threeypay-python-sdk"
+Issues = "https://gitee.com/threeypay/threeypay-python-sdk/issues"
+Documentation = "https://doc.3ypay.com/"
+
+[tool.setuptools.packages.find]
+include = ["threeypay*"]

threeypay_sdk-1.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

threeypay_sdk-1.1.0/tests/test_client.py

@@ -0,0 +1,169 @@
+import json
+
+import pytest
+from cryptography.hazmat.primitives import serialization
+from cryptography.hazmat.primitives.asymmetric import rsa
+
+from threeypay.client import Client
+from threeypay.config import Config
+from threeypay.exceptions import HttpException
+from threeypay.utils.signer import Signer
+
+
+def generate_key_pair():
+    private_key = rsa.generate_private_key(public_exponent=65537, key_size=2048)
+    private_pem = private_key.private_bytes(
+        encoding=serialization.Encoding.PEM,
+        format=serialization.PrivateFormat.PKCS8,
+        encryption_algorithm=serialization.NoEncryption(),
+    ).decode("utf-8")
+    public_pem = private_key.public_key().public_bytes(
+        encoding=serialization.Encoding.PEM,
+        format=serialization.PublicFormat.SubjectPublicKeyInfo,
+    ).decode("utf-8")
+    return private_pem, public_pem
+
+
+class FakeResponse:
+    def __init__(self, payload, status_code=200):
+        self.payload = payload
+        self.status_code = status_code
+        self.text = json.dumps(payload, ensure_ascii=False)
+
+    def json(self):
+        return self.payload
+
+
+class BadJsonResponse(FakeResponse):
+    def __init__(self, status_code=500):
+        self.payload = None
+        self.status_code = status_code
+        self.text = "<html>error</html>"
+
+    def json(self):
+        raise ValueError("invalid json")
+
+
+class FakeSession:
+    def __init__(self, response=None, exc=None):
+        self.response = response
+        self.exc = exc
+        self.headers = {}
+        self.calls = []
+
+    def post(self, url, json=None, timeout=None):
+        self.calls.append({"url": url, "json": json, "timeout": timeout})
+        if self.exc is not None:
+            raise self.exc
+        return self.response
+
+
+def build_client(response=None, exc=None, platform_keys=None):
+    merchant_private, merchant_public = generate_key_pair()
+    platform_private, platform_public = platform_keys or generate_key_pair()
+    config = Config("app-1", merchant_private, platform_public, True)
+    config.set_gateway_url("https://unit.test")
+    session = FakeSession(response, exc)
+    return Client(config, session=session), session, merchant_public, platform_private
+
+
+def signed(payload, platform_private):
+    payload = dict(payload)
+    payload["sign"] = Signer.sign(payload, platform_private)
+    return payload
+
+
+def test_envelope_is_signed_and_biz_content_is_compact_json():
+    merchant_private, merchant_public = generate_key_pair()
+    platform_private, platform_public = generate_key_pair()
+    payload = signed({"code": 200, "msg": "ok", "data": {"a": 1}}, platform_private)
+
+    config = Config("app-1", merchant_private, platform_public, True)
+    config.set_gateway_url("https://unit.test")
+    session = FakeSession(FakeResponse(payload))
+
+    client = Client(config, session=session)
+    result = client.post("/demo", {"foo": "bar", "nested": {"x": 1}})
+    parsed = client.parse_response(result)
+
+    assert parsed["data"] == {"a": 1}
+    assert len(session.calls) == 1
+    call = session.calls[0]
+    assert call["url"] == "https://unit.test/demo"
+
+    envelope = call["json"]
+    assert envelope["appId"] == "app-1"
+    assert envelope["signType"] == "RSA2"
+    assert envelope["version"] == "1.0"
+    assert envelope["charset"] == "UTF-8"
+    assert isinstance(envelope["timestamp"], int)
+    assert envelope["timestamp"] > 10**12
+    assert isinstance(envelope["bizContent"], str)
+    assert json.loads(envelope["bizContent"]) == {"foo": "bar", "nested": {"x": 1}}
+    assert "subSn" not in envelope
+    assert Signer.verify(envelope, merchant_public) is True
+
+
+def test_sub_sn_is_included_when_set():
+    client, session, merchant_public, platform_private = build_client(FakeResponse({"code": 200}))
+    session.response = FakeResponse(signed({"code": 200, "msg": "ok"}, platform_private))
+
+    client.set_sub_sn("sub-9")
+    client.post("/demo", {})
+    envelope = session.calls[0]["json"]
+    assert envelope["subSn"] == "sub-9"
+    assert Signer.verify(envelope, merchant_public) is True
+
+
+def test_business_error_is_raised_before_signature_verification():
+    payload = {"code": 500, "msg": "余额不足"}
+    response = FakeResponse(payload)
+    client, _, _, _ = build_client(response)
+
+    with pytest.raises(HttpException) as exc_info:
+        client.parse_response(payload)
+
+    assert "code=500" in str(exc_info.value)
+    assert "余额不足" in str(exc_info.value)
+    assert exc_info.value.code == 500
+
+
+def test_http_error_body_is_preserved():
+    client, _, _, _ = build_client(FakeResponse({"code": 401, "msg": "未授权"}, status_code=401))
+
+    with pytest.raises(HttpException) as exc_info:
+        client.post("/demo", {})
+
+    assert exc_info.value.status_code == 401
+    assert exc_info.value.code == 401
+    assert exc_info.value.response_body == {"code": 401, "msg": "未授权"}
+
+
+def test_non_json_response_raises_with_status_and_text():
+    client, _, _, _ = build_client(BadJsonResponse())
+
+    with pytest.raises(HttpException) as exc_info:
+        client.post("/demo", {})
+
+    assert exc_info.value.status_code == 500
+    assert exc_info.value.response_body == "<html>error</html>"
+
+
+def test_bad_signature_is_rejected():
+    client, _, _, _ = build_client(FakeResponse({"code": 200, "msg": "ok", "sign": "aW52YWxpZA=="}))
+
+    with pytest.raises(HttpException) as exc_info:
+        client.parse_response({"code": 200, "msg": "ok", "sign": "aW52YWxpZA=="})
+
+    assert str(exc_info.value) == "签名验证失败"
+
+
+def test_withdrawal_code_zero_is_success_and_data_string_is_decoded():
+    platform_private, platform_public = generate_key_pair()
+    payload = signed({"code": 0, "msg": "ok", "data": '{"status":"PROCESSING"}'}, platform_private)
+    client, _, _, _ = build_client(FakeResponse(payload), platform_keys=(platform_private, platform_public))
+
+    result = client.parse_response(payload)
+
+    assert client.is_success(payload) is True
+    assert result["data"] == {"status": "PROCESSING"}