@alipay/alipay-aipay 1.0.0 → 1.0.2

package/skill/references/integration/modules/code-examples/python/1-/351/200/232/347/224/250/346/216/245/345/217/243//347/273/237/344/270/200/346/224/266/345/215/225/344/272/244/346/230/223/345/205/263/351/227/255/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -0,0 +1,57 @@
+# 统一收单交易关闭接口 - Python 示例
+
+## 请求示例
+
+```python
+import json
+from alipay.aop.api.AlipayClientConfig import AlipayClientConfig
+from alipay.aop.api.DefaultAlipayClient import DefaultAlipayClient
+from alipay.aop.api.request.AlipayTradeCloseRequest import AlipayTradeCloseRequest
+from alipay.aop.api.domain.AlipayTradeCloseModel import AlipayTradeCloseModel
+
+# 初始化SDK（Python 使用 PKCS#1 格式私钥，Java 使用 PKCS#8 格式，请勿混用）
+config = AlipayClientConfig()
+config.server_url = "https://openapi.alipay.com/gateway.do"
+# 沙箱环境: config.server_url = "https://openapi-sandbox.dl.alipaydev.com/gateway.do"
+config.app_id = "<-- 请填写您的AppId，例如：20190xxxxxx -->"
+config.app_private_key = "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->"
+config.alipay_public_key = "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->"
+config.charset = "utf-8"
+config.sign_type = "RSA2"
+client = DefaultAlipayClient(alipay_client_config=config)
+
+request = AlipayTradeCloseRequest()
+model = AlipayTradeCloseModel()
+model.out_trade_no = "MERCHANT_ORDER_NO_PLACEHOLDER"  # 商户订单号，与 trade_no 二选一
+# model.trade_no = "ALIPAY_TRADE_NO_PLACEHOLDER"  # 支付宝交易号，同时传时以 trade_no 为准
+request.biz_model = model
+
+response_content = client.execute(request)
+response = json.loads(response_content)
+result = response.get("alipay_trade_close_response", {})
+
+if result.get("code") == "10000":
+    print("交易关闭成功")
+else:
+    print(f"调用失败: {result.get('sub_code')} - {result.get('sub_msg')}")
+```
+
+## 响应示例
+### 正常示例
+```json
+{
+    "code": "10000",
+    "msg": "Success",
+    "trade_no": "ALIPAY_TRADE_NO_PLACEHOLDER",
+    "out_trade_no": "MERCHANT_ORDER_NO_PLACEHOLDER"
+}
+```
+### 异常示例
+```json
+{
+    "code": "20000",
+    "msg": "Service Currently Unavailable",
+    "sub_code": "isp.unknow-error",
+    "sub_msg": "系统繁忙"
+}
+```

package/skill/references/integration/modules/code-examples/python/1-/351/200/232/347/224/250/346/216/245/345/217/243//347/273/237/344/270/200/346/224/266/345/215/225/344/272/244/346/230/223/346/237/245/350/257/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -0,0 +1,65 @@
+# 统一收单交易查询接口 - Python 示例
+
+## 请求示例
+
+```python
+import json
+from alipay.aop.api.AlipayClientConfig import AlipayClientConfig
+from alipay.aop.api.DefaultAlipayClient import DefaultAlipayClient
+from alipay.aop.api.request.AlipayTradeQueryRequest import AlipayTradeQueryRequest
+from alipay.aop.api.domain.AlipayTradeQueryModel import AlipayTradeQueryModel
+
+# 初始化SDK（Python 使用 PKCS#1 格式私钥，Java 使用 PKCS#8 格式，请勿混用）
+config = AlipayClientConfig()
+config.server_url = "https://openapi.alipay.com/gateway.do"
+# 沙箱环境: config.server_url = "https://openapi-sandbox.dl.alipaydev.com/gateway.do"
+config.app_id = "<-- 请填写您的AppId，例如：20190xxxxxx -->"
+config.app_private_key = "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->"
+config.alipay_public_key = "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->"
+config.charset = "utf-8"
+config.sign_type = "RSA2"
+client = DefaultAlipayClient(alipay_client_config=config)
+
+request = AlipayTradeQueryRequest()
+model = AlipayTradeQueryModel()
+model.out_trade_no = "MERCHANT_ORDER_NO_PLACEHOLDER"  # 商户订单号，与 trade_no 二选一
+# model.trade_no = "ALIPAY_TRADE_NO_PLACEHOLDER"  # 支付宝交易号，同时传时以 trade_no 为准
+request.biz_model = model
+
+response_content = client.execute(request)
+response = json.loads(response_content)
+result = response.get("alipay_trade_query_response", {})
+
+if result.get("code") == "10000":
+    # trade_status: TRADE_SUCCESS/TRADE_FINISHED 表示支付成功，TRADE_CLOSED 表示已关闭
+    print(f"交易状态: {result.get('trade_status')}, 订单金额: {result.get('total_amount')}")
+else:
+    print(f"调用失败: {result.get('sub_code')} - {result.get('sub_msg')}")
+```
+
+## 响应示例
+### 正常示例
+```json
+{
+    "code": "10000",
+    "msg": "Success",
+    "trade_no": "ALIPAY_TRADE_NO_PLACEHOLDER",
+    "out_trade_no": "MERCHANT_ORDER_NO_PLACEHOLDER",
+    "trade_status": "TRADE_SUCCESS",
+    "total_amount": "88.88",
+    "buyer_pay_amount": "8.88",
+    "receipt_amount": "15.25",
+    "buyer_logon_id": "159****5620",
+    "buyer_user_id": "<BUYER_USER_ID>",
+    "send_pay_date": "2014-11-27 15:45:57"
+}
+```
+### 异常示例
+```json
+{
+    "code": "20000",
+    "msg": "Service Currently Unavailable",
+    "sub_code": "isp.unknow-error",
+    "sub_msg": "系统繁忙"
+}
+```

package/skill/references/integration/modules/code-examples/python/1-/351/200/232/347/224/250/346/216/245/345/217/243//347/273/237/344/270/200/346/224/266/345/215/225/344/272/244/346/230/223/351/200/200/346/254/276/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -0,0 +1,63 @@
+# 统一收单交易退款接口 - Python 示例
+
+## 请求示例
+
+```python
+import json
+from alipay.aop.api.AlipayClientConfig import AlipayClientConfig
+from alipay.aop.api.DefaultAlipayClient import DefaultAlipayClient
+from alipay.aop.api.request.AlipayTradeRefundRequest import AlipayTradeRefundRequest
+from alipay.aop.api.domain.AlipayTradeRefundModel import AlipayTradeRefundModel
+
+# 初始化SDK（Python 使用 PKCS#1 格式私钥，Java 使用 PKCS#8 格式，请勿混用）
+config = AlipayClientConfig()
+config.server_url = "https://openapi.alipay.com/gateway.do"
+# 沙箱环境: config.server_url = "https://openapi-sandbox.dl.alipaydev.com/gateway.do"
+config.app_id = "<-- 请填写您的AppId，例如：20190xxxxxx -->"
+config.app_private_key = "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->"
+config.alipay_public_key = "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->"
+config.charset = "utf-8"
+config.sign_type = "RSA2"
+client = DefaultAlipayClient(alipay_client_config=config)
+
+request = AlipayTradeRefundRequest()
+model = AlipayTradeRefundModel()
+model.out_trade_no = "MERCHANT_ORDER_NO_PLACEHOLDER"  # 商户订单号，与 trade_no 二选一
+model.refund_amount = "200.12"            # 退款金额，必填，单位为元
+model.refund_reason = "正常退款"           # 退款原因，选填
+model.out_request_no = "OUT_REQUEST_NO_PLACEHOLDER"        # 退款请求号，同一笔交易多次部分退款时必填且必须不同
+request.biz_model = model
+
+response_content = client.execute(request)
+response = json.loads(response_content)
+result = response.get("alipay_trade_refund_response", {})
+
+if result.get("code") == "10000":
+    # fund_change: Y=发生了资金变化（退款成功），N=未发生资金变化
+    print(f"资金变化: {result.get('fund_change')}, 退款金额: {result.get('refund_fee')}")
+else:
+    print(f"调用失败: {result.get('sub_code')} - {result.get('sub_msg')}")
+```
+
+## 响应示例
+### 正常示例
+```json
+{
+    "code": "10000",
+    "msg": "Success",
+    "trade_no": "ALIPAY_TRADE_NO_PLACEHOLDER",
+    "out_trade_no": "MERCHANT_ORDER_NO_PLACEHOLDER",
+    "buyer_logon_id": "159****5620",
+    "fund_change": "Y",
+    "refund_fee": "88.88"
+}
+```
+### 异常示例
+```json
+{
+    "code": "20000",
+    "msg": "Service Currently Unavailable",
+    "sub_code": "isp.unknow-error",
+    "sub_msg": "系统繁忙"
+}
+```

package/skill/references/integration/modules/code-examples/python/1-/351/200/232/347/224/250/346/216/245/345/217/243//347/273/237/344/270/200/346/224/266/345/215/225/344/272/244/346/230/223/351/200/200/346/254/276/346/237/245/350/257/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -0,0 +1,62 @@
+# 统一收单交易退款查询接口 - Python 示例
+
+## 请求示例
+
+```python
+import json
+from alipay.aop.api.AlipayClientConfig import AlipayClientConfig
+from alipay.aop.api.DefaultAlipayClient import DefaultAlipayClient
+from alipay.aop.api.request.AlipayTradeFastpayRefundQueryRequest import AlipayTradeFastpayRefundQueryRequest
+from alipay.aop.api.domain.AlipayTradeFastpayRefundQueryModel import AlipayTradeFastpayRefundQueryModel
+
+# 初始化SDK（Python 使用 PKCS#1 格式私钥，Java 使用 PKCS#8 格式，请勿混用）
+config = AlipayClientConfig()
+config.server_url = "https://openapi.alipay.com/gateway.do"
+# 沙箱环境: config.server_url = "https://openapi-sandbox.dl.alipaydev.com/gateway.do"
+config.app_id = "<-- 请填写您的AppId，例如：20190xxxxxx -->"
+config.app_private_key = "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->"
+config.alipay_public_key = "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->"
+config.charset = "utf-8"
+config.sign_type = "RSA2"
+client = DefaultAlipayClient(alipay_client_config=config)
+
+request = AlipayTradeFastpayRefundQueryRequest()
+model = AlipayTradeFastpayRefundQueryModel()
+model.out_trade_no = "MERCHANT_ORDER_NO_PLACEHOLDER"  # 商户订单号，与 trade_no 二选一
+model.out_request_no = "OUT_REQUEST_NO_PLACEHOLDER"        # 退款请求号，必填，同一笔交易多次部分退款时用于区分
+request.biz_model = model
+
+response_content = client.execute(request)
+response = json.loads(response_content)
+result = response.get("alipay_trade_fastpay_refund_query_response", {})
+
+if result.get("code") == "10000":
+    # refund_status: REFUND_SUCCESS 表示退款成功，REFUND_PROCESSING 表示退款处理中
+    print(f"退款状态: {result.get('refund_status')}, 退款金额: {result.get('refund_amount')}")
+else:
+    print(f"调用失败: {result.get('sub_code')} - {result.get('sub_msg')}")
+```
+
+## 响应示例
+### 正常示例
+```json
+{
+    "code": "10000",
+    "msg": "Success",
+    "trade_no": "ALIPAY_TRADE_NO_PLACEHOLDER",
+    "out_trade_no": "MERCHANT_ORDER_NO_PLACEHOLDER",
+    "out_request_no": "OUT_REQUEST_NO_PLACEHOLDER",
+    "total_amount": "100.20",
+    "refund_amount": "12.33",
+    "refund_status": "REFUND_SUCCESS"
+}
+```
+### 异常示例
+```json
+{
+    "code": "20000",
+    "msg": "Service Currently Unavailable",
+    "sub_code": "isp.unknow-error",
+    "sub_msg": "系统繁忙"
+}
+```

package/skill/references/integration/modules/code-examples/python/2-/347/275/221/347/253/231/346/224/257/344/273/230//347/273/237/344/270/200/346/224/266/345/215/225/344/270/213/345/215/225/345/271/266/346/224/257/344/273/230/351/241/265/351/235/242/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -0,0 +1,48 @@
+# 统一收单下单并支付页面接口 - Python 示例
+
+## 请求示例
+
+```python
+from alipay.aop.api.AlipayClientConfig import AlipayClientConfig
+from alipay.aop.api.DefaultAlipayClient import DefaultAlipayClient
+from alipay.aop.api.request.AlipayTradePagePayRequest import AlipayTradePagePayRequest
+from alipay.aop.api.domain.AlipayTradePagePayModel import AlipayTradePagePayModel
+
+# 初始化SDK（Python 使用 PKCS#1 格式私钥，Java 使用 PKCS#8 格式，请勿混用）
+config = AlipayClientConfig()
+config.server_url = "https://openapi.alipay.com/gateway.do"
+# 沙箱环境: config.server_url = "https://openapi-sandbox.dl.alipaydev.com/gateway.do"
+config.app_id = "<-- 请填写您的AppId，例如：20190xxxxxx -->"
+config.app_private_key = "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->"
+config.alipay_public_key = "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->"
+config.charset = "utf-8"
+config.sign_type = "RSA2"
+client = DefaultAlipayClient(alipay_client_config=config)
+
+request = AlipayTradePagePayRequest()
+request.notify_url = "https://your-domain.com/notify"  # 异步通知地址，必须传入
+request.return_url = "https://your-domain.com/return"  # 同步跳转地址，必须传入
+
+model = AlipayTradePagePayModel()
+model.out_trade_no = "MERCHANT_ORDER_NO_PLACEHOLDER"             # 商户订单号，必填
+model.total_amount = "88.88"                          # 订单总金额，必填，单位为元
+model.subject = "Iphone6 16G"                         # 订单标题，必填
+model.product_code = "FAST_INSTANT_TRADE_PAY"         # 网站支付固定值，必填
+request.biz_model = model
+
+# ⚠️ 网站支付必须使用 page_execute()，不能使用 execute()
+# ⚠️ 使用 execute() 将无法获取支付表单，是最常见的集成错误
+form_html = client.page_execute(request)
+# page_execute 返回的是 HTML 表单字符串，前端需要渲染并自动提交
+print(form_html)
+```
+
+## 响应示例
+### 正常示例
+```html
+<form name="punchout_form" method="post" action="https://openapi.alipay.com/gateway.do?charset=UTF-8&method=alipay.trade.page.pay&format=json&sign=SIGN_PLACEHOLDER&version=1.0&app_id=20190xxxxxx&sign_type=RSA2&timestamp=2014-07-24+03%3A07%3A50">
+<input type="hidden" name="biz_content" value="{&quot;out_trade_no&quot;:&quot;MERCHANT_ORDER_NO_PLACEHOLDER&quot;,&quot;total_amount&quot;:&quot;88.88&quot;,&quot;subject&quot;:&quot;Iphone6 16G&quot;,&quot;product_code&quot;:&quot;FAST_INSTANT_TRADE_PAY&quot;}">
+<input type="submit" value="立即支付" style="display:none" >
+</form>
+<script>document.forms[0].submit();</script>
+```

package/skill/references/integration/modules/code-examples/python/3-APP/346/224/257/344/273/230/APP/346/224/257/344/273/230/346/216/245/345/217/243/344/273/243/347/240/201/347/244/272/344/276/213.md

@@ -0,0 +1,43 @@
+# APP支付接口 - Python 示例
+
+## 请求示例
+
+```python
+import json
+from alipay.aop.api.AlipayClientConfig import AlipayClientConfig
+from alipay.aop.api.DefaultAlipayClient import DefaultAlipayClient
+from alipay.aop.api.request.AlipayTradeAppPayRequest import AlipayTradeAppPayRequest
+from alipay.aop.api.domain.AlipayTradeAppPayModel import AlipayTradeAppPayModel
+
+# 初始化SDK
+config = AlipayClientConfig()
+config.server_url = "https://openapi.alipay.com/gateway.do"
+config.app_id = "<-- 请填写您的AppId，例如：20190xxxxxx -->"
+config.app_private_key = "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->"
+config.alipay_public_key = "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->"
+config.charset = "utf-8"
+config.sign_type = "RSA2"
+client = DefaultAlipayClient(alipay_client_config=config)
+
+# 构造请求参数以调用接口
+request = AlipayTradeAppPayRequest()
+model = AlipayTradeAppPayModel()
+
+model.out_trade_no = "MERCHANT_ORDER_NO_PLACEHOLDER"
+model.total_amount = "9.00"
+model.subject = "大乐透"
+model.product_code = "QUICK_MSECURITY_PAY"
+
+request.biz_model = model
+# 第三方代调用模式下请设置app_auth_token
+# request.add_other_text_param("app_auth_token", "<-- 请填写应用授权令牌 -->")
+
+order_str = client.sdk_execute(request)
+print(order_str)
+```
+
+## 响应示例
+### 正常示例
+```
+app_id=20190xxxxxx&biz_content=%7B%22time_expire%22%3A%222016-12-31+10%3A05%3A00%22%2C%22extend_params%22%3A%22%22%2C%22query_options%22%3A%22%5B%5C%22hyb_amount%5C%22%2C%5C%22enterprise_pay_info%5C%22%5D%22%2C%22subject%22%3A%22%E5%A4%A7%E4%B9%90%E9%80%8F%22%2C%22product_code%22%3A%22QUICK_MSECURITY_PAY%22%2C%22body%22%3A%22Iphone6+16G%22%2C%22passback_params%22%3A%22merchantBizType%253d3C%2526merchantBizNo%253dMERCHANT_BIZ_NO_PLACEHOLDER%22%2C%22specified_channel%22%3A%22pcredit%22%2C%22goods_detail%22%3A%22%22%2C%22merchant_order_no%22%3A%22MERCHANT_ORDER_NO_PLACEHOLDER%22%2C%22enable_pay_channels%22%3A%22pcredit%2CmoneyFund%2CdebitCardExpress%22%2C%22out_trade_no%22%3A%22MERCHANT_ORDER_NO_PLACEHOLDER%22%2C%22ext_user_info%22%3A%22%22%2C%22total_amount%22%3A%229.00%22%2C%22timeout_express%22%3A%2290m%22%2C%22disable_pay_channels%22%3A%22pcredit%2CmoneyFund%2CdebitCardExpress%22%2C%22agreement_sign_params%22%3A%22%22%7D&charset=UTF-8&format=json&method=alipay.trade.app.pay&sign=SIGN_PLACEHOLDER&sign_type=RSA2&timestamp=2014-07-24+03%3A07%3A50&version=1.0
+```