refactor(payment): 支付插件 - 宿主仅通过 RPC 包加载并保护订单版本

2026-09-02 16:15:57 +08:00
parent d6bbdbe27b
commit 38e715ea3f
45 changed files with 1584 additions and 203 deletions
--- a/plugin-packages/official-payment-alipay-page/manifest.json
+++ b/plugin-packages/official-payment-alipay-page/manifest.json
@@ -0,0 +1,97 @@
+{
+  "apiVersion": "yingce.plugin/v1",
+  "id": "official-payment-alipay-page",
+  "name": "支付宝电脑网站支付",
+  "version": "1.0.0",
+  "author": "支付宝",
+  "description": "支付宝电脑网站支付充值适配器。",
+  "enabled": true,
+  "installable": true,
+  "runtime": {
+    "backend": "rpc",
+    "backendEntry": "backend/provider"
+  },
+  "surfaces": [
+    "wallet",
+    "settings"
+  ],
+  "permissions": [
+    "payment.create",
+    "payment.query",
+    "payment.close",
+    "payment.reconcile"
+  ],
+  "configuration": {
+    "fields": [
+      {
+        "name": "publicBaseUrl",
+        "type": "url",
+        "label": "服务器公网地址",
+        "required": true
+      },
+      {
+        "name": "appId",
+        "type": "string",
+        "label": "应用 AppID",
+        "required": true
+      },
+      {
+        "name": "sellerId",
+        "type": "string",
+        "label": "支付宝商户 PID",
+        "required": true
+      },
+      {
+        "name": "merchantPrivateKey",
+        "type": "textarea",
+        "label": "应用私钥",
+        "required": true,
+        "secret": true
+      },
+      {
+        "name": "alipayPublicKey",
+        "type": "textarea",
+        "label": "支付宝公钥",
+        "required": true,
+        "secret": true
+      },
+      {
+        "name": "gateway",
+        "type": "url",
+        "label": "支付宝网关",
+        "required": true,
+        "default": "https://openapi.alipay.com/gateway.do"
+      }
+    ]
+  },
+  "contributes": {
+    "paymentProviders": [
+      {
+        "id": "alipay-page-pay",
+        "label": "支付宝电脑网站支付",
+        "icon": "brand:alipay",
+        "checkoutMode": "redirect",
+        "identityFields": [
+          "appId",
+          "sellerId"
+        ],
+        "expiryPolicy": {
+          "defaultMinutes": 30,
+          "minMinutes": 5,
+          "maxMinutes": 1440
+        },
+        "notificationSuccess": {
+          "status": 200,
+          "contentType": "text/plain; charset=utf-8",
+          "body": "success"
+        },
+        "notificationFailure": {
+          "status": 400,
+          "contentType": "text/plain; charset=utf-8",
+          "body": "failure"
+        }
+      }
+    ]
+  },
+  "documentation": "# 支付宝电脑网站支付\n\n官方 `yingce.payment/v1` 支付插件。后端入口由构建脚本编译为 `backend/provider`。\n\n---\n\n## yingce.payment/v1\n\n支持 `validate_config`、`create_order`、`query_order`、`close_order`、`verify_notification` 和 `download_trade_bill`，统一返回 JSON 响应。\n\n<!-- YINGCE_MANIFEST_CONTRACT_START -->\n## Manifest 完整接口定义\n\n以下 JSON 与插件包内实际 `manifest.json` 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。`documentation` 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。\n\n```json\n{\n  \"apiVersion\": \"yingce.plugin/v1\",\n  \"id\": \"official-payment-alipay-page\",\n  \"name\": \"支付宝电脑网站支付\",\n  \"version\": \"1.0.0\",\n  \"author\": \"支付宝\",\n  \"description\": \"支付宝电脑网站支付充值适配器。\",\n  \"enabled\": true,\n  \"installable\": true,\n  \"runtime\": {\n    \"backend\": \"rpc\",\n    \"backendEntry\": \"backend/provider\"\n  },\n  \"surfaces\": [\n    \"wallet\",\n    \"settings\"\n  ],\n  \"permissions\": [\n    \"payment.create\",\n    \"payment.query\",\n    \"payment.close\",\n    \"payment.reconcile\"\n  ],\n  \"configuration\": {\n    \"fields\": [\n      {\n        \"name\": \"publicBaseUrl\",\n        \"type\": \"url\",\n        \"label\": \"服务器公网地址\",\n        \"required\": true\n      },\n      {\n        \"name\": \"appId\",\n        \"type\": \"string\",\n        \"label\": \"应用 AppID\",\n        \"required\": true\n      },\n      {\n        \"name\": \"sellerId\",\n        \"type\": \"string\",\n        \"label\": \"支付宝商户 PID\",\n        \"required\": true\n      },\n      {\n        \"name\": \"merchantPrivateKey\",\n        \"type\": \"textarea\",\n        \"label\": \"应用私钥\",\n        \"required\": true,\n        \"secret\": true\n      },\n      {\n        \"name\": \"alipayPublicKey\",\n        \"type\": \"textarea\",\n        \"label\": \"支付宝公钥\",\n        \"required\": true,\n        \"secret\": true\n      },\n      {\n        \"name\": \"gateway\",\n        \"type\": \"url\",\n        \"label\": \"支付宝网关\",\n        \"required\": true,\n        \"default\": \"https://openapi.alipay.com/gateway.do\"\n      }\n    ]\n  },\n  \"contributes\": {\n    \"paymentProviders\": [\n      {\n        \"id\": \"alipay-page-pay\",\n        \"label\": \"支付宝电脑网站支付\",\n        \"icon\": \"brand:alipay\",\n        \"checkoutMode\": \"redirect\",\n        \"identityFields\": [\n          \"appId\",\n          \"sellerId\"\n        ],\n        \"expiryPolicy\": {\n          \"defaultMinutes\": 30,\n          \"minMinutes\": 5,\n          \"maxMinutes\": 1440\n        },\n        \"notificationSuccess\": {\n          \"status\": 200,\n          \"contentType\": \"text/plain; charset=utf-8\",\n          \"body\": \"success\"\n        },\n        \"notificationFailure\": {\n          \"status\": 400,\n          \"contentType\": \"text/plain; charset=utf-8\",\n          \"body\": \"failure\"\n        }\n      }\n    ]\n  },\n  \"documentation\": \"<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>\"\n}\n```\n<!-- YINGCE_MANIFEST_CONTRACT_END -->\n"
+}