@alipay/alipay-aipay 0.1.1-beta.1

package/skill/references/integration/modules/code-examples/nodejs/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,57 @@
+# 统一收单交易查询接口 - Node.js 示例
+
+## 请求示例
+
+```javascript
+const { AlipaySdk } = require("alipay-sdk");
+
+const alipaySdk = new AlipaySdk({
+  appId: "<-- 请填写您的AppId，例如：20190xxxxxx -->",
+  privateKey: "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->", // Node.js 使用 PKCS#1 格式私钥
+  alipayPublicKey: "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->",
+  gateway: "https://openapi.alipay.com/gateway.do",
+  signType: "RSA2",
+  // 第三方代调用模式下请设置 appAuthToken
+  // appAuthToken: "<-- 请填写应用授权令牌 -->",
+});
+
+const result = await alipaySdk.exec("alipay.trade.query", {
+  bizContent: {
+    out_trade_no: "MERCHANT_ORDER_NO_PLACEHOLDER",
+  },
+});
+
+if (result.code === "10000") {
+  console.log("调用成功");
+} else {
+  console.log("调用失败");
+}
+```
+
+## 响应示例
+### 正常示例
+```json
+{
+    "code": "10000",
+    "msg": "Success",
+    "trade_no": "ALIPAY_TRADE_NO_PLACEHOLDER",
+    "out_trade_no": "MERCHANT_ORDER_NO_PLACEHOLDER",
+    "buyer_logon_id": "159****5620",
+    "trade_status": "TRADE_SUCCESS",
+    "total_amount": "88.88",
+    "buyer_pay_amount": "8.88",
+    "receipt_amount": "15.25",
+    "invoice_amount": "12.11",
+    "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/nodejs/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,55 @@
+# 统一收单交易退款接口 - Node.js 示例
+
+## 请求示例
+
+```javascript
+const { AlipaySdk } = require("alipay-sdk");
+
+const alipaySdk = new AlipaySdk({
+  appId: "<-- 请填写您的AppId，例如：20190xxxxxx -->",
+  privateKey: "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->", // Node.js 使用 PKCS#1 格式私钥
+  alipayPublicKey: "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->",
+  gateway: "https://openapi.alipay.com/gateway.do",
+  signType: "RSA2",
+  // 第三方代调用模式下请设置 appAuthToken
+  // appAuthToken: "<-- 请填写应用授权令牌 -->",
+});
+
+const result = await alipaySdk.exec("alipay.trade.refund", {
+  bizContent: {
+    out_trade_no: "MERCHANT_ORDER_NO_PLACEHOLDER",  // 商户订单号，与 trade_no 二选一
+    refund_amount: "200.12",             // 退款金额，必填，单位为元
+    refund_reason: "正常退款",            // 退款原因，选填
+    out_request_no: "OUT_REQUEST_NO_PLACEHOLDER",         // 退款请求号，同一笔交易多次部分退款时必填且必须不同
+  },
+});
+
+if (result.code === "10000") {
+  console.log("调用成功");
+} else {
+  console.log("调用失败");
+}
+```
+
+## 响应示例
+### 正常示例
+```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/nodejs/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,54 @@
+# 统一收单交易退款查询接口 - Node.js 示例
+
+## 请求示例
+
+```javascript
+const { AlipaySdk } = require("alipay-sdk");
+
+const alipaySdk = new AlipaySdk({
+  appId: "<-- 请填写您的AppId，例如：20190xxxxxx -->",
+  privateKey: "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->", // Node.js 使用 PKCS#1 格式私钥
+  alipayPublicKey: "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->",
+  gateway: "https://openapi.alipay.com/gateway.do",
+  signType: "RSA2",
+  // 第三方代调用模式下请设置 appAuthToken
+  // appAuthToken: "<-- 请填写应用授权令牌 -->",
+});
+
+const result = await alipaySdk.exec("alipay.trade.fastpay.refund.query", {
+  bizContent: {
+    out_trade_no: "MERCHANT_ORDER_NO_PLACEHOLDER",   // 商户订单号，与 trade_no 二选一
+    out_request_no: "OUT_REQUEST_NO_PLACEHOLDER",          // 退款请求号，必填，同一笔交易多次部分退款时用于区分
+  },
+});
+
+if (result.code === "10000") {
+  console.log("调用成功");
+} else {
+  console.log("调用失败");
+}
+```
+
+## 响应示例
+### 正常示例
+```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/nodejs/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,77 @@
+# 统一收单下单并支付页面接口 - Node.js 示例
+
+## 请求示例
+
+```javascript
+const { AlipaySdk } = require("alipay-sdk");
+
+const alipaySdk = new AlipaySdk({
+  appId: "<-- 请填写您的AppId，例如：20190xxxxxx -->",
+  privateKey: "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->", // Node.js 使用 PKCS#1 格式私钥
+  alipayPublicKey: "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->",
+  gateway: "https://openapi.alipay.com/gateway.do",
+  signType: "RSA2",
+  // 第三方代调用模式下请设置 appAuthToken
+  // appAuthToken: "<-- 请填写应用授权令牌 -->",
+});
+
+// ⚠️ 网站支付必须使用 pageExec() 方法，不能使用 exec()
+// ⚠️ pageExec() 第二个参数必须传 'POST'
+// ⚠️ notifyUrl 和 returnUrl 必须传入，否则可能导致验签失败
+const result = alipaySdk.pageExec(
+  "alipay.trade.page.pay",
+  "POST",
+  {
+    notifyUrl: "https://your-domain.com/notify", // 异步通知地址，必须传入
+    returnUrl: "https://your-domain.com/return", // 同步跳转地址，必须传入
+    bizContent: {
+      out_trade_no: "MERCHANT_ORDER_NO_PLACEHOLDER",         // 商户订单号，必填
+      total_amount: "88.88",                      // 订单总金额，必填，单位为元，精确到小数点后两位
+      subject: "Iphone6 16G",                     // 订单标题，必填
+      product_code: "FAST_INSTANT_TRADE_PAY",     // 网站支付固定值，必填
+    },
+  }
+);
+
+// pageExec 返回的是 HTML 表单字符串，前端需要渲染并自动提交
+// ⚠️ 禁止用 URL 直接跳转，否则页面只会显示参数而无法跳转支付宝
+console.log(result);
+```
+
+### 前端渲染支付表单
+
+```javascript
+// pageExec 返回的 result 是包含自动提交脚本的 HTML <form> 字符串
+// 前端必须将此 HTML 渲染到页面并自动提交表单
+
+// ✅ 正确写法（以浏览器端 JavaScript 为例）
+if (data.paymentHtml) {
+  const container = document.createElement('div');
+  container.innerHTML = data.paymentHtml;
+  container.style.position = 'fixed';
+  container.style.top = '0';
+  container.style.left = '0';
+  container.style.width = '100%';
+  container.style.height = '100%';
+  container.style.zIndex = '9999';
+  container.style.background = 'white';
+  document.body.appendChild(container);
+  const form = container.querySelector('form');
+  if (form) form.submit();
+}
+
+// ❌ 错误写法 — 禁止用 URL 直接跳转
+// window.location.href = data.paymentHtml; // 页面只会显示参数，无法跳转支付宝
+```
+
+## 响应示例
+
+### 正常示例
+
+```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/nodejs/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,65 @@
+# APP支付接口 - Node.js 示例
+
+## 请求示例
+
+```javascript
+const { AlipaySdk } = require("alipay-sdk");
+
+const alipaySdk = new AlipaySdk({
+  appId: "<-- 请填写您的AppId，例如：20190xxxxxx -->",
+  privateKey: "<-- 请填写您的应用私钥，例如：MIIE...（脱敏示例） -->",
+  alipayPublicKey: "<-- 请填写您的支付宝公钥，例如：MIIB...（脱敏示例） -->",
+  gateway: "https://openapi.alipay.com/gateway.do",
+  appAuthToken: "<-- 请填写应用授权令牌 -->",
+});
+const result = await alipaySdk.sdkExec("alipay.trade.app.pay", {
+  bizContent: {
+    out_trade_no: "MERCHANT_ORDER_NO_PLACEHOLDER",
+    total_amount: "9.00",
+    subject: "大乐透",
+    product_code: "QUICK_MSECURITY_PAY",
+    goods_detail: [
+      {
+        goods_name: "ipad",
+        alipay_goods_id: "20010001",
+        quantity: 1,
+        price: "2000",
+        goods_id: "apple-01",
+        goods_category: "34543238",
+        categories_tree: "124868003|126232002|126252004",
+        show_url: "http://www.alipay.com/xxx.jpg",
+      },
+    ],
+    time_expire: "2016-12-31+10:05:00",
+    extend_params: {
+      sys_service_provider_id: "<SYS_SERVICE_PROVIDER_ID>",
+      hb_fq_seller_percent: "100",
+      hb_fq_num: "3",
+      industry_reflux_info:
+        '{\\"scene_code\\":\\"metro_tradeorder\\",\\"channel\\":\\"xxxx\\",\\"scene_data\\":{\\"asset_name\\":\\"ALIPAY\\"}}',
+      royalty_freeze: "true",
+      card_type: "S0JP0000",
+    },
+    passback_params: "merchantBizType%3d3C%26merchantBizNo%3dMERCHANT_BIZ_NO_PLACEHOLDER",
+    merchant_order_no: "MERCHANT_ORDER_NO_PLACEHOLDER",
+    ext_user_info: {
+      cert_type: "IDENTITY_CARD",
+      cert_no: "<CERT_NO>",
+      mobile: "<MOBILE>",
+      name: "李明",
+      min_age: "18",
+      need_check_info: "F",
+      identity_hash:
+        "<IDENTITY_HASH>",
+    },
+    query_options: ["hyb_amount", "enterprise_pay_info"],
+  },
+});
+```
+
+## 响应示例
+### 正常示例
+```
+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
+```
+