@moksa/plugin-ecpay 0.0.0-stage → 0.1.1

package/dist/index.mjs

@@ -0,0 +1,1587 @@
+// Auto-generated by emdash-plugin build. Do not edit.
+// Source: emdash-plugin.jsonc + package.json
+//
+// Default-exports a sandboxed plugin descriptor. Pass it directly into
+// emdash's `plugins:` or `sandboxed:` array — no factory call needed.
+
+/** @type {import("emdash").PluginDescriptor} */
+const descriptor = Object.freeze({
+	"id": "moksa-ecpay",
+	"version": "0.1.1",
+	"format": "standard",
+	"entrypoint": "@moksa/plugin-ecpay/sandbox",
+	"capabilities": [
+		"network:request"
+	],
+	"allowedHosts": [
+		"payment-stage.ecpay.com.tw",
+		"payment.ecpay.com.tw",
+		"ecpayment-stage.ecpay.com.tw",
+		"ecpayment.ecpay.com.tw",
+		"ecpg-stage.ecpay.com.tw",
+		"ecpg.ecpay.com.tw",
+		"logistics-stage.ecpay.com.tw",
+		"logistics.ecpay.com.tw",
+		"einvoice-stage.ecpay.com.tw",
+		"einvoice.ecpay.com.tw"
+	],
+	"storage": {
+		"trades": {
+			"indexes": [
+				"orderNumber",
+				"status",
+				"createdAt",
+				[
+					"orderNumber",
+					"createdAt"
+				]
+			]
+		},
+		"events": {
+			"indexes": [
+				"createdAt"
+			]
+		},
+		"orders": {
+			"indexes": [
+				"updatedAt",
+				"invoiceDueAt"
+			]
+		},
+		"shipments": {
+			"indexes": [
+				"orderNumber",
+				"status",
+				"updatedAt",
+				[
+					"open",
+					"updatedAt"
+				],
+				[
+					"orderNumber",
+					"updatedAt"
+				]
+			]
+		},
+		"invoices": {
+			"indexes": [
+				"status",
+				"updatedAt"
+			]
+		},
+		"reports": {
+			"indexes": [
+				"status",
+				"nextAt",
+				[
+					"status",
+					"nextAt"
+				]
+			]
+		},
+		"mandates": {
+			"indexes": [
+				"status",
+				"cardRef",
+				"orderNumber",
+				"updatedAt"
+			]
+		},
+		"charges": {
+			"indexes": [
+				"state",
+				"mandateId",
+				"orderNumber",
+				"updatedAt",
+				[
+					"state",
+					"updatedAt"
+				]
+			]
+		},
+		"members": {
+			"indexes": [
+				"createdAt"
+			]
+		}
+	},
+	"hooks": [
+		"plugin:activate",
+		"cron"
+	],
+	"routes": [
+		{
+			"name": "migrate/import",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "migrate/kv",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "migrate/stats",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "bus/methods",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/checkout",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/bind/step",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/gw/bind-pay",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/gw/bind-result",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/gw/bind-notify",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/recurring/charge",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/recurring/action",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/notify",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/gw/return",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/events",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/reports/due",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/reports/ack",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/shipping/methods",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/invoice/options",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/invoice/verify",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/gw/logistics-map",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/gw/logistics-map-reply",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/gw/logistics-notify",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "bus/refund",
+			"methods": [
+				"POST"
+			],
+			"request": {
+				"body": "text",
+				"maxBytes": 262144,
+				"headers": [
+					"x-moksa-bus-ts",
+					"x-moksa-bus-id",
+					"x-moksa-bus-sig"
+				]
+			},
+			"public": true
+		},
+		{
+			"name": "recurring/list",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "trades/list",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "trades/query",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "trades/refund",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "trades/capture",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "trades/card-status",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "shipments/create",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "shipments/list",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "shipments/sync",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "shipments/print",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "shipments/sync-all",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "shipments/void",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "shipments/print-batch",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "invoices/issue",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "invoices/get",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "invoices/void",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "invoices/allowance",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "invoices/due",
+			"methods": [
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "invoices/query",
+			"methods": [
+				"GET",
+				"POST"
+			],
+			"permission": "plugins:manage"
+		},
+		{
+			"name": "admin",
+			"permission": "plugins:manage"
+		}
+	],
+	"mcp": {
+		"tools": [
+			{
+				"name": "list_recurring_charges",
+				"description": "Subscription renewal charges made with ECPay saved cards (站內付 2.0 綁卡): state paid / failed / declined / uncertain, ECPay's code and message, the MerchantTradeNo, plus the saved cards (brand, last four digits, expiry; never the card token). Optional order number or state filter.",
+				"route": "recurring/list",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 18,
+							"pattern": "^[A-Z0-9]+$"
+						},
+						"state": {
+							"enum": [
+								"calling",
+								"paid",
+								"failed",
+								"declined",
+								"uncertain"
+							]
+						},
+						"limit": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 100,
+							"default": 20
+						}
+					},
+					"additionalProperties": true
+				}
+			},
+			{
+				"name": "list_trades",
+				"description": "List ECPay trades (one per payment attempt), newest first, optionally for one order number. Status: created, awaiting (ATM/CVS code issued), paid, failed.",
+				"route": "trades/list",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 18,
+							"pattern": "^[A-Z0-9]+$"
+						},
+						"limit": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 100,
+							"default": 20
+						}
+					},
+					"additionalProperties": true
+				}
+			},
+			{
+				"name": "query_trade",
+				"description": "Ask ECPay for the current status of a trade by MerchantTradeNo (TradeStatus 1 = paid, 0 = not paid).",
+				"route": "trades/query",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"merchantTradeNo": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Za-z0-9]+$"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"merchantTradeNo"
+					]
+				}
+			},
+			{
+				"name": "card_status",
+				"description": "A paid ECPay card trade's authorization and capture status (Authorized, To be captured, Captured, Refunded, Cancelled) with the captured amount and history.",
+				"route": "trades/card-status",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"merchantTradeNo": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Za-z0-9]+$"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"merchantTradeNo"
+					]
+				}
+			},
+			{
+				"name": "capture_trade",
+				"description": "Capture (關帳) a paid ECPay card trade for its amount less refunds, when automatic capture is off.",
+				"route": "trades/capture",
+				"permission": "plugins:manage",
+				"destructive": true,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"merchantTradeNo": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Za-z0-9]+$"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"merchantTradeNo"
+					]
+				}
+			},
+			{
+				"name": "list_shipments",
+				"description": "List 綠界物流 shipments, newest first, optionally for one order number (status, tracking number, provider fields).",
+				"route": "shipments/list",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"maxLength": 20
+						},
+						"limit": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 100,
+							"default": 20
+						}
+					},
+					"additionalProperties": true
+				}
+			},
+			{
+				"name": "create_shipment",
+				"description": "Create the 綠界物流 shipment for a paid (or cash-on-delivery) order; an existing live shipment is returned instead.",
+				"route": "shipments/create",
+				"permission": "plugins:manage",
+				"destructive": true,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Z0-9]+$"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"orderNumber"
+					]
+				}
+			},
+			{
+				"name": "sync_all_shipments",
+				"description": "Ask 綠界物流 for the status of every open shipment now (up to 100, oldest first) and apply the changes.",
+				"route": "shipments/sync-all",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {},
+					"additionalProperties": true
+				}
+			},
+			{
+				"name": "sync_shipment",
+				"description": "Ask 綠界物流 for a shipment's current status and apply it.",
+				"route": "shipments/sync",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"shipmentId": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 64
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"shipmentId"
+					]
+				}
+			},
+			{
+				"name": "print_shipment_label",
+				"description": "The 綠界物流 shipping label: a signed form (action + params) to open in a browser, a URL, or label HTML.",
+				"route": "shipments/print",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"shipmentId": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 64
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"shipmentId"
+					]
+				}
+			},
+			{
+				"name": "void_shipment",
+				"description": "Void a 綠界物流 shipment that has not shipped yet (cancel at the carrier's back office when it has no cancel API).",
+				"route": "shipments/void",
+				"permission": "plugins:manage",
+				"destructive": true,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"shipmentId": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 64
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"shipmentId"
+					]
+				}
+			},
+			{
+				"name": "issue_invoice",
+				"description": "Issue the 綠界電子發票 invoice for a paid order (idempotent: an issued invoice is returned).",
+				"route": "invoices/issue",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Z0-9]+$"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"orderNumber"
+					]
+				}
+			},
+			{
+				"name": "get_invoice",
+				"description": "The 綠界電子發票 invoice of an order: number, date, random code, allowances.",
+				"route": "invoices/get",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Z0-9]+$"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"orderNumber"
+					]
+				}
+			},
+			{
+				"name": "query_invoice",
+				"description": "Ask 綠界電子發票 for the invoice as it recorded it.",
+				"route": "invoices/query",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Z0-9]+$"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"orderNumber"
+					]
+				}
+			},
+			{
+				"name": "void_invoice",
+				"description": "Void an order's 綠界電子發票 invoice (its allowances are voided first).",
+				"route": "invoices/void",
+				"permission": "plugins:manage",
+				"destructive": true,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Z0-9]+$"
+						},
+						"reason": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 50,
+							"default": "訂單取消"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"orderNumber"
+					]
+				}
+			},
+			{
+				"name": "allowance_invoice",
+				"description": "Issue a 綠界電子發票 allowance (折讓, whole NT$) against an order's invoice.",
+				"route": "invoices/allowance",
+				"permission": "plugins:manage",
+				"destructive": true,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"orderNumber": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Z0-9]+$"
+						},
+						"amount": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 99999999
+						},
+						"reason": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 50,
+							"default": "折讓"
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"orderNumber",
+						"amount"
+					]
+				}
+			},
+			{
+				"name": "print_shipment_labels",
+				"description": "ECPay shipping labels for several shipments at once: one label page (HTML) per logistics subtype. mode A6 applies to 7-ELEVEN and post only; other subtypes print A4.",
+				"route": "shipments/print-batch",
+				"permission": "plugins:manage",
+				"destructive": false,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"shipmentIds": {
+							"type": "array",
+							"items": {
+								"type": "string",
+								"minLength": 1,
+								"maxLength": 64
+							},
+							"minItems": 1,
+							"maxItems": 50
+						},
+						"mode": {
+							"enum": [
+								"A4",
+								"A6"
+							]
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"shipmentIds"
+					]
+				}
+			},
+			{
+				"name": "refund_trade",
+				"description": "Refund a paid ECPay credit-card trade (whole NT$). An uncaptured charge can only be released in full. ATM / CVS payments must be refunded by hand.",
+				"route": "trades/refund",
+				"permission": "plugins:manage",
+				"destructive": true,
+				"inputSchema": {
+					"$schema": "http://json-schema.org/draft-07/schema#",
+					"type": "object",
+					"properties": {
+						"merchantTradeNo": {
+							"type": "string",
+							"minLength": 1,
+							"maxLength": 20,
+							"pattern": "^[A-Za-z0-9]+$"
+						},
+						"amount": {
+							"type": "integer",
+							"minimum": 1,
+							"maximum": 99999999
+						}
+					},
+					"additionalProperties": true,
+					"required": [
+						"merchantTradeNo",
+						"amount"
+					]
+				}
+			}
+		]
+	},
+	"adminPages": [
+		{
+			"path": "/trades",
+			"label": "綠界金流",
+			"icon": "credit-card"
+		},
+		{
+			"path": "/payment-labels",
+			"label": "付款方式名稱與說明",
+			"icon": "list"
+		},
+		{
+			"path": "/shipments",
+			"label": "綠界物流",
+			"icon": "truck"
+		},
+		{
+			"path": "/shipping-methods",
+			"label": "物流方式設定",
+			"icon": "list"
+		},
+		{
+			"path": "/invoices",
+			"label": "綠界電子發票",
+			"icon": "receipt"
+		}
+	],
+	"settingsSchema": {
+		"environment": {
+			"label": "環境",
+			"type": "select",
+			"options": [
+				{
+					"value": "stage",
+					"label": "測試環境（stage）"
+				},
+				{
+					"value": "production",
+					"label": "正式環境"
+				}
+			],
+			"default": "stage"
+		},
+		"merchantId": {
+			"label": "特店編號（MerchantID）",
+			"description": "測試環境留空時使用綠界公開測試帳號 3002607。",
+			"type": "string",
+			"default": ""
+		},
+		"hashKey": {
+			"label": "HashKey",
+			"type": "secret"
+		},
+		"hashIv": {
+			"label": "HashIV",
+			"type": "secret"
+		},
+		"methodCredit": {
+			"label": "信用卡",
+			"type": "boolean",
+			"default": true
+		},
+		"methodCredit3": {
+			"label": "信用卡分 3 期（需向綠界申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodCredit6": {
+			"label": "信用卡分 6 期（需向綠界申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodCredit12": {
+			"label": "信用卡分 12 期（需向綠界申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodCredit18": {
+			"label": "信用卡分 18 期（需向綠界申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodCredit24": {
+			"label": "信用卡分 24 期（需向綠界申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodCredit30N": {
+			"label": "信用卡分 30 期（永豐，需向綠界申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"credit30NMinAmount": {
+			"label": "永豐 30 期最低交易金額",
+			"description": "綠界廠商後台可查；訂單金額大於這個金額才提供 30 期。0 表示不提供。",
+			"type": "number",
+			"default": 0,
+			"min": 0
+		},
+		"methodUnionPay": {
+			"label": "銀聯卡（需向綠界申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"creditRedeem": {
+			"label": "信用卡紅利折抵（需向綠界申請）",
+			"description": "一次付清的信用卡付款頁提供紅利折抵；分期與銀聯卡不適用。",
+			"type": "boolean",
+			"default": false
+		},
+		"methodATM": {
+			"label": "ATM 轉帳",
+			"type": "boolean",
+			"default": false
+		},
+		"methodCVS": {
+			"label": "超商代碼繳費",
+			"type": "boolean",
+			"default": false
+		},
+		"methodBARCODE": {
+			"label": "超商條碼繳費",
+			"type": "boolean",
+			"default": false
+		},
+		"methodWebATM": {
+			"label": "網路 ATM（手機版不支援）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodApplePay": {
+			"label": "Apple Pay",
+			"type": "boolean",
+			"default": false
+		},
+		"methodTWQR": {
+			"label": "TWQR 行動支付（需申請，6–49,999 元）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodBNPL": {
+			"label": "無卡分期：裕富／中租（需申請，50–500,000 元）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodWeiXin": {
+			"label": "微信支付（需申請，6–500,000 元）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodJkopay": {
+			"label": "街口支付（需申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodiPASS": {
+			"label": "一卡通 iPASS MONEY（需申請）",
+			"type": "boolean",
+			"default": false
+		},
+		"methodALL": {
+			"label": "綠界付款頁自選",
+			"type": "boolean",
+			"default": false
+		},
+		"methodCreditBind": {
+			"label": "信用卡綁定：定期定額自動扣款（站內付 2.0，需向綠界申請綁卡）",
+			"description": "只在訂閱商品結帳時出現。首期刷卡同時綁定卡片，之後每期由網站自動扣款；請在綠界廠商後台開啟每日自動關帳。測試環境用綠界公開測試帳號。",
+			"type": "boolean",
+			"default": false
+		},
+		"atmExpireDays": {
+			"label": "ATM 繳費期限（天）",
+			"type": "number",
+			"default": 3,
+			"min": 1,
+			"max": 60
+		},
+		"cvsExpireDays": {
+			"label": "超商代碼繳費期限（天，最多 30）",
+			"type": "number",
+			"default": 7,
+			"min": 1,
+			"max": 30
+		},
+		"barcodeExpireDays": {
+			"label": "超商條碼繳費期限（天，最多 30）",
+			"type": "number",
+			"default": 7,
+			"min": 1,
+			"max": 30
+		},
+		"orderPrefix": {
+			"label": "訂單編號前綴（最多 5 個英數字）",
+			"description": "多個商店共用同一個綠界帳號時，用前綴區分訂單編號。",
+			"type": "string",
+			"default": ""
+		},
+		"itemName": {
+			"label": "付款頁顯示的商品名稱",
+			"description": "留空時列出訂單的商品；填寫固定文字（例如「網路商品」）時每筆訂單都顯示這段文字。",
+			"type": "string",
+			"default": ""
+		},
+		"siteUrl": {
+			"label": "網站網址",
+			"description": "例：https://shop.example.com。物流狀態回呼使用；留空時沿用網站最近一次轉來的網址。",
+			"type": "string",
+			"default": ""
+		},
+		"logisticsEnabled": {
+			"label": "啟用綠界物流",
+			"type": "boolean",
+			"default": false
+		},
+		"logisticsEnvironment": {
+			"label": "物流環境",
+			"type": "select",
+			"options": [
+				{
+					"value": "stage",
+					"label": "測試環境（stage）"
+				},
+				{
+					"value": "production",
+					"label": "正式環境"
+				}
+			],
+			"default": "stage"
+		},
+		"logisticsContract": {
+			"label": "超商合約類型",
+			"type": "select",
+			"options": [
+				{
+					"value": "C2C",
+					"label": "C2C 店到店"
+				},
+				{
+					"value": "B2C",
+					"label": "B2C 大宗寄倉"
+				}
+			],
+			"default": "C2C"
+		},
+		"logisticsC2cMerchantId": {
+			"label": "C2C 物流特店編號",
+			"description": "店到店（交貨便）用。測試環境未填時使用綠界公開測試帳號 2000933。",
+			"type": "string",
+			"default": ""
+		},
+		"logisticsC2cHashKey": {
+			"label": "C2C 物流 HashKey",
+			"type": "secret"
+		},
+		"logisticsC2cHashIv": {
+			"label": "C2C 物流 HashIV",
+			"type": "secret"
+		},
+		"logisticsB2cMerchantId": {
+			"label": "B2C／宅配物流特店編號",
+			"description": "大宗寄倉、黑貓、郵局用。測試環境未填時使用綠界公開測試帳號 2000132。",
+			"type": "string",
+			"default": ""
+		},
+		"logisticsB2cHashKey": {
+			"label": "B2C／宅配物流 HashKey",
+			"type": "secret"
+		},
+		"logisticsB2cHashIv": {
+			"label": "B2C／宅配物流 HashIV",
+			"type": "secret"
+		},
+		"cvsUnimart": {
+			"label": "7-ELEVEN 取貨（B2C 可含冷凍，另拆一張冷凍單）",
+			"type": "boolean",
+			"default": true
+		},
+		"cvsFami": {
+			"label": "全家取貨",
+			"type": "boolean",
+			"default": true
+		},
+		"cvsHilife": {
+			"label": "萊爾富取貨",
+			"type": "boolean",
+			"default": false
+		},
+		"cvsOkmart": {
+			"label": "OK 取貨",
+			"type": "boolean",
+			"default": false
+		},
+		"cvsUnimartFreeze": {
+			"label": "7-ELEVEN 冷凍取貨（僅 B2C）",
+			"type": "boolean",
+			"default": false
+		},
+		"homeTcat": {
+			"label": "黑貓宅急便（常溫／冷藏／冷凍，依溫層拆單）",
+			"type": "boolean",
+			"default": true
+		},
+		"homePost": {
+			"label": "中華郵政（僅常溫）",
+			"type": "boolean",
+			"default": false
+		},
+		"cvsFee": {
+			"label": "超商取貨運費",
+			"type": "number",
+			"default": 60,
+			"min": 0
+		},
+		"homeFee": {
+			"label": "宅配運費（常溫）",
+			"type": "number",
+			"default": 100,
+			"min": 0
+		},
+		"coldFee": {
+			"label": "低溫配送運費",
+			"type": "number",
+			"default": 160,
+			"min": 0
+		},
+		"senderName": {
+			"label": "寄件人姓名（最多 10 字）",
+			"type": "string",
+			"default": ""
+		},
+		"senderPhone": {
+			"label": "寄件人電話",
+			"type": "string",
+			"default": ""
+		},
+		"senderCellphone": {
+			"label": "寄件人手機",
+			"type": "string",
+			"default": ""
+		},
+		"senderZipcode": {
+			"label": "寄件人郵遞區號（宅配用）",
+			"description": "3、5 或 6 碼數字。留空時只採用寄件地址開頭的郵遞區號。",
+			"type": "string",
+			"default": ""
+		},
+		"senderAddress": {
+			"label": "寄件地址（宅配用）",
+			"description": "沒填郵遞區號時，地址開頭的 3–6 位數字當作郵遞區號。",
+			"type": "string",
+			"default": ""
+		},
+		"labelMode": {
+			"label": "託運單格式",
+			"description": "A6 只用於 7-ELEVEN（含冷凍）與中華郵政；全家、萊爾富、OK、黑貓沒有 A6，一律印 A4。",
+			"type": "select",
+			"options": [
+				{
+					"value": "1",
+					"label": "A4"
+				},
+				{
+					"value": "2",
+					"label": "A6"
+				}
+			],
+			"default": "1"
+		},
+		"logisticsAutoShip": {
+			"label": "付款後（貨到付款為下單後）自動建立物流單",
+			"type": "boolean",
+			"default": false
+		},
+		"invoiceEnabled": {
+			"label": "啟用綠界電子發票",
+			"type": "boolean",
+			"default": false
+		},
+		"invoiceEnvironment": {
+			"label": "發票環境",
+			"type": "select",
+			"options": [
+				{
+					"value": "stage",
+					"label": "測試環境（stage）"
+				},
+				{
+					"value": "production",
+					"label": "正式環境"
+				}
+			],
+			"default": "stage"
+		},
+		"invoiceMerchantId": {
+			"label": "發票特店編號",
+			"description": "未填時使用綠界公開測試帳號 2000132（測試環境開立的發票不會上傳財政部）。",
+			"type": "string",
+			"default": ""
+		},
+		"invoiceHashKey": {
+			"label": "發票 HashKey",
+			"type": "secret"
+		},
+		"invoiceHashIv": {
+			"label": "發票 HashIV",
+			"type": "secret"
+		},
+		"invoicePrefix": {
+			"label": "發票關聯編號前綴（最多 5 個英數字）",
+			"description": "多個商店共用同一個綠界發票帳號時，用前綴區分。",
+			"type": "string",
+			"default": ""
+		},
+		"invoiceAuto": {
+			"label": "自動開立",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceIssueWhen": {
+			"label": "開立時機",
+			"type": "select",
+			"options": [
+				{
+					"value": "paid",
+					"label": "付款完成（貨到付款於下單後）"
+				},
+				{
+					"value": "completed",
+					"label": "訂單完成（取貨完成）"
+				}
+			],
+			"default": "paid"
+		},
+		"invoiceDelayDays": {
+			"label": "延後開立天數（0–30）",
+			"type": "number",
+			"default": 0,
+			"min": 0,
+			"max": 30
+		},
+		"invoiceAutoVoid": {
+			"label": "訂單取消或全額退款時自動作廢",
+			"type": "boolean",
+			"default": false
+		},
+		"invoiceAutoAllowance": {
+			"label": "部分退款時自動開立折讓",
+			"type": "boolean",
+			"default": false
+		},
+		"invoiceVerifyOnline": {
+			"label": "結帳時向綠界驗證捐贈碼與手機條碼",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceAllowDonate": {
+			"label": "結帳可選捐贈發票",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceAllowB2b": {
+			"label": "結帳可打統編（三聯式）",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceChannelMember": {
+			"label": "個人載具：綠界會員載具",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceChannelMobile": {
+			"label": "個人載具：手機條碼",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceChannelCert": {
+			"label": "個人載具：自然人憑證",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceChannelPaper": {
+			"label": "個人載具：紙本發票",
+			"description": "至少保留一種；全部取消時自動保留紙本。紙本發票請到綠界後台列印寄送。",
+			"type": "boolean",
+			"default": true
+		},
+		"invoiceDefaultCarrier": {
+			"label": "預設的個人載具",
+			"type": "select",
+			"options": [
+				{
+					"value": "member",
+					"label": "綠界會員載具"
+				},
+				{
+					"value": "mobile",
+					"label": "手機條碼"
+				},
+				{
+					"value": "cert",
+					"label": "自然人憑證"
+				},
+				{
+					"value": "paper",
+					"label": "紙本發票"
+				}
+			],
+			"default": "member"
+		},
+		"invoiceDonateOrgs": {
+			"label": "捐贈單位（每行「名稱|愛心碼」）",
+			"description": "例：伊甸社會福利基金會|25885。填寫後結帳改為下拉選單。",
+			"type": "string",
+			"default": ""
+		},
+		"vaultKey": {
+			"label": "卡片憑證加密金鑰",
+			"description": "第一次綁卡時自動產生，用來加密綠界綁卡代碼（BindCardID）。請勿修改或刪除，否則已綁定的卡片無法再扣款。",
+			"type": "secret"
+		},
+		"busKey": {
+			"label": "匯流排金鑰",
+			"description": "由網站部署腳本寫入（scripts/provision-bus.mjs），請勿手動修改。",
+			"type": "secret"
+		}
+	}
+});
+
+export default descriptor;