@moksa/plugin-ecpay 0.0.0-stage → 0.1.1

package/dist/manifest.json

@@ -0,0 +1,1597 @@
+{
+  "id": "moksa-ecpay",
+  "version": "0.1.1",
+  "declaredAccess": {
+    "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"
+        ]
+      }
+    }
+  },
+  "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"
+          ]
+        }
+      }
+    ]
+  },
+  "admin": {
+    "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"
+      }
+    },
+    "pages": [
+      {
+        "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"
+      }
+    ],
+    "widgets": []
+  }
+}