139 lines
8.6 KiB
JSON
139 lines
8.6 KiB
JSON
{
|
||
"apiVersion": "yingce.plugin/v1",
|
||
"id": "official-payment-epay",
|
||
"name": "易支付",
|
||
"version": "1.0.8",
|
||
"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,
|
||
"default": "https://pay.admincloudai.com",
|
||
"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。"
|
||
},
|
||
{
|
||
"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": "# 易支付\n\n官方 `yingce.payment/v1` 支付插件。兼容常见易支付网关：V1/MD5 `mapi.php` 与 V2/RSA `/api/pay/create`，支持支付宝/微信/QQ 等通道。协议实现参考 [acg-faka](https://github.com/lizhipay/acg-faka)。\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易支付渠道协议全部封装在本插件内：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`。V2 无查单和交易账单下载：关单只关本地订单，对账账单返回 not found。\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-epay\",\n \"name\": \"易支付\",\n \"version\": \"1.0.8\",\n \"author\": \"Epay\",\n \"description\": \"易支付适配器，支持 V1/MD5 与 V2/RSA 的支付宝/微信/QQ 通道。\",\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 \"description\": \"用于确认回调可达；实际 notify_url 由宿主订单生成。\"\n },\n {\n \"name\": \"pid\",\n \"type\": \"string\",\n \"label\": \"商户号 (pid)\",\n \"required\": true\n },\n {\n \"name\": \"key\",\n \"type\": \"password\",\n \"label\": \"商户密钥 (key)\",\n \"required\": false,\n \"secret\": true,\n \"description\": \"V1/MD5 密钥；version=1 可留空。\"\n },\n {\n \"name\": \"gateway\",\n \"type\": \"url\",\n \"label\": \"支付网关\",\n \"required\": true,\n \"default\": \"https://pay.admincloudai.com\",\n \"description\": \"易支付根地址，不要带 /mapi.php。\"\n },\n {\n \"name\": \"payType\",\n \"type\": \"string\",\n \"label\": \"默认支付方式\",\n \"required\": false,\n \"default\": \"alipay\",\n \"values\": [\n \"alipay\",\n \"wxpay\",\n \"qqpay\",\n \"usdt\"\n ]\n },\n {\n \"name\": \"version\",\n \"type\": \"string\",\n \"label\": \"接口版本\",\n \"required\": false,\n \"default\": \"0\",\n \"values\": [\n \"0\",\n \"1\"\n ],\n \"description\": \"0=V1/MD5，1=V2/RSA。\"\n },\n {\n \"name\": \"checkoutMode\",\n \"type\": \"string\",\n \"label\": \"收银方式\",\n \"required\": false,\n \"default\": \"redirect\",\n \"values\": [\n \"redirect\",\n \"qr_code\"\n ],\n \"description\": \"redirect 跳转；qr_code 展示二维码载荷。\"\n },\n {\n \"name\": \"privateKey\",\n \"type\": \"textarea\",\n \"label\": \"V2 商户私钥\",\n \"required\": false,\n \"secret\": true,\n \"description\": \"仅 version=1，PEM 或裸 Base64。\"\n },\n {\n \"name\": \"platformPublicKey\",\n \"type\": \"textarea\",\n \"label\": \"V2 平台公钥\",\n \"required\": false,\n \"description\": \"仅 version=1，PEM 或裸 Base64。\"\n }\n ]\n },\n \"contributes\": {\n \"paymentProviders\": [\n {\n \"id\": \"epay\",\n \"label\": \"易支付\",\n \"icon\": \"assets/icon.svg\",\n \"checkoutMode\": \"redirect\",\n \"identityFields\": [\n \"pid\"\n ],\n \"expiryPolicy\": {\n \"defaultMinutes\": 10,\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"
|
||
}
|