pixelarraythirdparty 1.3.6__tar.gz → 1.3.8__tar.gz

{pixelarraythirdparty-1.3.6 → pixelarraythirdparty-1.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelarraythirdparty
-Version: 1.3.6
+Version: 1.3.8
 Summary: PixelArray 第三方微服务客户端
 Author-email: Lu qi <qi.lu@pixelarrayai.com>
 License-Expression: MIT
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Requires-Python: >=3.8

{pixelarraythirdparty-1.3.6 → pixelarraythirdparty-1.3.8}/pixelarraythirdparty/__init__.py

@@ -24,7 +24,7 @@ from .support_chat.support_chat import (
 from .custom_events.custom_events import CustomEventsManagerAsync
 from .project_dashboard.project_dashboard import ProjectDashboardManagerAsync
 
-__version__ = "1.3.6"
+__version__ = "1.3.8"
 __author__ = "Lu qi"
 __email__ = "qi.lu@pixelarrayai.com"
 

{pixelarraythirdparty-1.3.6 → pixelarraythirdparty-1.3.8}/pixelarraythirdparty/order/order.py

@@ -1,3 +1,34 @@
+"""
+订单与支付客户端。
+
+商户业务回调（callback_url）
+--------------------------------
+创建订单时传入 ``callback_url``（http/https）后，支付成功或退款成功时，
+本服务会向该地址 **POST** ``Content-Type: application/json``，Body 结构如下。
+
+公共字段（两种事件均包含）::
+
+    event (str): "order.paid" 或 "order.refunded"
+    out_trade_no (str): 商户订单号
+    payment_status (str): "PAID" 或 "REFUNDED"
+    payment_channel (str): "WECHAT" | "ALIPAY" | "PAYPAL"
+    product_id (str|None): 产品 ID
+    amount (float|None): 订单金额（元）
+    total_fee (int|None): 订单金额（分）
+    transaction_id (str|None): 渠道交易号
+    timestamp (str): 回调发送时刻，ISO 8601 UTC
+
+支付成功（event="order.paid"）额外字段::
+
+    paid_at (str|None): 支付时间
+
+退款成功（event="order.refunded"）额外字段::
+
+    refunded_at (str|None): 退款时间
+
+幂等：同一状态重复通知不会重复回调。失败时服务端最多重试 2 次（间隔 1 秒）。
+业务方接口应返回 HTTP 2xx 表示接收成功。
+"""
 from pixelarraythirdparty.client import AsyncClient
 
 
@@ -8,6 +39,8 @@ class OrderManagerAsync(AsyncClient):
         body: str = None,
         remark: str = None,
         payment_channel: str = "WECHAT",
+        amount_yuan: float = None,
+        callback_url: str = None,
     ):
         """
         description:
@@ -17,6 +50,10 @@ class OrderManagerAsync(AsyncClient):
             body(str): 商品描述
             remark(str): 订单备注
             payment_channel(str): 支付渠道，可选值："WECHAT"（微信支付）、"ALIPAY"（支付宝支付）
+            amount_yuan(float, optional): 订单金额（元），可变金额产品必填
+            callback_url(str, optional): 支付/退款结果业务回调地址（http/https）。
+                支付/退款成功后服务端 POST JSON 至该地址，Body 字段见本模块顶部
+                「商户业务回调（callback_url）」说明。
         return:
             data(dict): 订单信息
                 - id(int): 订单ID
@@ -28,6 +65,7 @@ class OrderManagerAsync(AsyncClient):
                 - total_fee(int): 订单金额（分），用于支付接口
                 - body(str): 商品描述
                 - remark(str): 订单备注
+                - callback_url(str, optional): 商户业务回调地址
                 - created_at(str): 订单创建时间
                 - updated_at(str): 订单更新时间
             success(bool): 操作是否成功
@@ -38,6 +76,10 @@ class OrderManagerAsync(AsyncClient):
             "remark": remark,
             "payment_channel": payment_channel,
         }
+        if amount_yuan is not None:
+            data["amount_yuan"] = amount_yuan
+        if callback_url is not None:
+            data["callback_url"] = callback_url
         data, success = await self._request("POST", "/api/orders/create", json=data)
         if not success:
             return data, False
@@ -49,6 +91,8 @@ class OrderManagerAsync(AsyncClient):
         body: str = None,
         remark: str = None,
         payment_channel: str = "WECHAT",
+        amount_yuan: float = None,
+        callback_url: str = None,
     ):
         """
         description:
@@ -59,6 +103,9 @@ class OrderManagerAsync(AsyncClient):
             body(str): 商品描述
             remark(str): 订单备注
             payment_channel(str): 支付渠道，可选值："WECHAT"、"ALIPAY"、"PAYPAL"
+            amount_yuan(float, optional): 订单金额（元），可变金额产品必填
+            callback_url(str, optional): 支付/退款结果业务回调地址（http/https）。
+                回调 POST Body 结构见本模块顶部「商户业务回调（callback_url）」说明。
         return:
             data(dict): 返回数据
                 - order(dict): 订单信息（字段同 create_order 返回）
@@ -71,6 +118,10 @@ class OrderManagerAsync(AsyncClient):
             "remark": remark,
             "payment_channel": payment_channel,
         }
+        if amount_yuan is not None:
+            data["amount_yuan"] = amount_yuan
+        if callback_url is not None:
+            data["callback_url"] = callback_url
         data, success = await self._request("POST", "/api/orders/create_v2", json=data)
         if not success:
             return data, False

{pixelarraythirdparty-1.3.6 → pixelarraythirdparty-1.3.8}/pixelarraythirdparty/project/project.py

@@ -69,7 +69,7 @@ class ProjectManagerAsync(AsyncClient):
             project_id(int): 项目ID
             name(str): 新项目名称
         return:
-            data(dict): 更新后的项目信息（含 id、name、bound_domains、created_at）
+            data(dict): 更新后的项目信息（含 id、name、created_at）
             success(bool): 操作是否成功
         """
         data = {"name": name}

{pixelarraythirdparty-1.3.6 → pixelarraythirdparty-1.3.8}/pixelarraythirdparty.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelarraythirdparty
-Version: 1.3.6
+Version: 1.3.8
 Summary: PixelArray 第三方微服务客户端
 Author-email: Lu qi <qi.lu@pixelarrayai.com>
 License-Expression: MIT
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Requires-Python: >=3.8

{pixelarraythirdparty-1.3.6 → pixelarraythirdparty-1.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pixelarraythirdparty"
-version = "1.3.6"
+version = "1.3.8"
 authors = [
     {name = "Lu qi", email = "qi.lu@pixelarrayai.com"},
 ]
@@ -23,6 +23,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: Utilities",
 ]