3e35f7d687
在 #544、#545、#546 的原作者 merge commit 之后独立修复：保留上传 Promise、处理重复上传与复制失败、格式对齐，以及易支付网关、订单证据、签名、通知幂等与安全关单校验。同步重建六平台插件产物和包。 验证：前端 1832 tests、build/typecheck、lint、相关格式检查通过；财务 SQLite、支付、插件 RPC 与产物专项通过。后端全量出现一项未改动的素材删除 SQLite 表锁失败，单独复跑 3 次通过，保留全量未通过记录。浏览器与真实商户验收待完成。#543 因迁移历史与能力限制回退暂缓。
5.6 KiB
yingce.payment/v1
支持 validate_config、create_order、query_order、close_order、verify_notification 和 download_trade_bill，统一返回 JSON 响应。
易支付渠道协议全部封装在本插件内：V1 下单 POST /mapi.php（MD5），查单 GET /api.php?act=order；V2 下单 POST /api/pay/create（RSA，method=jump），异步通知为 form/JSON，成功应答 success。配置字段包括 publicBaseUrl、pid、key、gateway、payType、version、checkoutMode、privateKey、platformPublicKey。
必须显式填写可信 gateway，不默认向任何第三方网关发送商户信息。V1 查单严格校验商户（响应包含时）、订单号、正数金额、支付状态和成功流水号；不以请求中的订单号或零金额掩盖不完整响应。通知校验拒绝重复参数、无效签名、非正金额及缺失的成功流水号。支付地址只接受 HTTP(S) 与明确允许的微信、支付宝、QQ 支付协议，不接受任意本机协议或含用户名密码的地址。
V1 关单先查单：已支付订单返回付款凭据，未付款订单只关闭宿主本地记录，不能据此声称上游支付链接已失效。V2 当前仅实现下单和通知验签，未实现查单、刷新收银台和安全关单；query_order 返回 epay_query_unsupported，close_order 返回 epay_close_unsupported，不会把未知订单标成已关闭。启用 V2 前需接受这一限制并准备在网关人工核对订单；本次没有新增或猜测 V2 查单接口。交易账单下载返回 not found，不表示已完成对账。
Manifest 完整接口定义
以下 JSON 与插件包内实际 manifest.json 逐字段一致，覆盖插件身份、权限、配置、鉴权、参数、校验、创建、Agent、查询、取消、结果下载、响应和 Agent 响应映射。documentation 字段的值就是当前完整文档；为避免文档在自身内部无限递归，JSON 中仅用等义占位文本表示正文。
{
"apiVersion": "yingce.plugin/v1",
"id": "official-payment-epay",
"name": "易支付",
"version": "1.0.9",
"author": "Epay",
"description": "易支付适配器，支持 V1/MD5 与 V2/RSA 的支付宝/微信/QQ 通道。",
"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,
"description": "用于确认回调可达；实际 notify_url 由宿主订单生成。"
},
{
"name": "pid",
"type": "string",
"label": "商户号 (pid)",
"required": true
},
{
"name": "key",
"type": "password",
"label": "商户密钥 (key)",
"required": false,
"secret": true,
"description": "V1/MD5 密钥；version=1 可留空。"
},
{
"name": "gateway",
"type": "url",
"label": "支付网关",
"required": true,
"description": "显式填写可信易支付网关根地址，不要带 /mapi.php；不会默认向第三方网关发送商户信息。"
},
{
"name": "payType",
"type": "string",
"label": "默认支付方式",
"required": false,
"default": "alipay",
"values": [
"alipay",
"wxpay",
"qqpay",
"usdt"
]
},
{
"name": "version",
"type": "string",
"label": "接口版本",
"required": false,
"default": "0",
"values": [
"0",
"1"
],
"description": "0=V1/MD5，1=V2/RSA。V2 仅支持下单和验签通知，暂不支持查单、刷新收银台及自动关单，启用前需确认此限制。"
},
{
"name": "checkoutMode",
"type": "string",
"label": "收银方式",
"required": false,
"default": "redirect",
"values": [
"redirect",
"qr_code"
],
"description": "redirect 跳转；qr_code 展示二维码载荷。"
},
{
"name": "privateKey",
"type": "textarea",
"label": "V2 商户私钥",
"required": false,
"secret": true,
"description": "仅 version=1，PEM 或裸 Base64。"
},
{
"name": "platformPublicKey",
"type": "textarea",
"label": "V2 平台公钥",
"required": false,
"description": "仅 version=1，PEM 或裸 Base64。"
}
]
},
"contributes": {
"paymentProviders": [
{
"id": "epay",
"label": "易支付",
"icon": "assets/icon.svg",
"checkoutMode": "redirect",
"identityFields": [
"pid"
],
"expiryPolicy": {
"defaultMinutes": 10,
"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": "<当前插件的完整 documentation，由 README.md 与 docs/interface.md 拼接而成；为避免 JSON 递归，此处不重复展开正文。>"
}