moltspay 2.0.0 → 2.4.0

package/schemas/moltspay.services.schema.json

@@ -32,16 +32,16 @@
         },
         "chain": {
           "type": "string",
-          "enum": ["base", "polygon", "base_sepolia", "tempo_moderato", "bnb", "bnb_testnet", "solana", "solana_devnet", "alipay"],
+          "enum": ["base", "polygon", "base_sepolia", "tempo_moderato", "bnb", "bnb_testnet", "solana", "solana_devnet", "alipay", "wechat", "balance"],
           "default": "base",
-          "description": "Single chain mode (use 'chains' for multi-chain). 'alipay' is a fiat rail (1.7.0+), not a blockchain."
+          "description": "Single chain mode (use 'chains' for multi-chain). 'alipay'/'wechat' are fiat rails (2.0+/2.1+), 'balance' is the custodial rail (2.2+), none are blockchains."
         },
         "chains": {
           "type": "array",
-          "description": "Supported chains/rails. EVM chains use 'wallet', Solana chains use 'solana_wallet', 'alipay' (1.7.0+) uses 'provider.alipay'.",
+          "description": "Supported chains/rails. EVM chains use 'wallet', Solana chains use 'solana_wallet', 'alipay' (2.0+) uses 'provider.alipay', 'wechat' (2.1+) uses 'provider.wechat'.",
           "items": {
             "type": "string",
-            "enum": ["base", "polygon", "base_sepolia", "tempo_moderato", "bnb", "bnb_testnet", "solana", "solana_devnet", "alipay"]
+            "enum": ["base", "polygon", "base_sepolia", "tempo_moderato", "bnb", "bnb_testnet", "solana", "solana_devnet", "alipay", "wechat", "balance"]
           },
           "examples": [
             ["base", "polygon", "solana_devnet"],
@@ -51,7 +51,7 @@
         },
         "alipay": {
           "type": "object",
-          "description": "Alipay AI 收 provider config (1.7.0+). Required when 'chains' contains 'alipay'.",
+          "description": "Alipay AI 收 provider config (2.0+). Required when 'chains' contains 'alipay'.",
           "required": ["seller_id", "app_id", "seller_name", "service_id_default", "private_key_path", "alipay_public_key_path"],
           "properties": {
             "seller_id": {
@@ -70,7 +70,7 @@
             },
             "service_id_default": {
               "type": "string",
-              "description": "Default service_id when a service entry doesn't override it (e.g. 'API_0EA6DC4FC99A4DF7')"
+              "description": "Default service_id when a service entry doesn't override it (e.g. 'API_XXXXXXXXXXXXXXXX')"
             },
             "private_key_path": {
               "type": "string",
@@ -90,7 +90,102 @@
               "type": "string",
               "enum": ["RSA2"],
               "default": "RSA2",
-              "description": "Signature algorithm. Only RSA2 is supported in 1.7.0."
+              "description": "Signature algorithm. Only RSA2 is supported in 2.0."
+            }
+          }
+        },
+        "wechat": {
+          "type": "object",
+          "description": "WeChat Pay v3 Native provider config (2.1+). Required when 'chains' contains 'wechat'.",
+          "required": ["mchid", "appid", "serial_no", "private_key_path", "notify_url"],
+          "properties": {
+            "mchid": {
+              "type": "string",
+              "description": "Merchant id (商户号)"
+            },
+            "appid": {
+              "type": "string",
+              "description": "App id (official account / mini-program / app)"
+            },
+            "serial_no": {
+              "type": "string",
+              "description": "Merchant API certificate serial number"
+            },
+            "private_key_path": {
+              "type": "string",
+              "description": "Path to the merchant RSA private key PEM file (relative to moltspay.services.json)"
+            },
+            "platform_public_key_path": {
+              "type": "string",
+              "description": "Path to the WeChat platform certificate public key PEM (enables response verification)"
+            },
+            "apiv3_key": {
+              "type": "string",
+              "minLength": 32,
+              "maxLength": 32,
+              "description": "APIv3 key (32 bytes). Only needed for callback decryption (Phase 2)"
+            },
+            "notify_url": {
+              "type": "string",
+              "format": "uri",
+              "description": "Async result notify URL. Required by Native order create even when polling."
+            },
+            "api_base": {
+              "type": "string",
+              "format": "uri",
+              "default": "https://api.mch.weixin.qq.com",
+              "description": "Open API base URL"
+            }
+          }
+        },
+        "balance": {
+          "type": "object",
+          "description": "Custodial balance rail config (2.2+). Required when 'chains' contains 'balance'. Enabling requires Node.js >= 22.5.",
+          "required": ["db_path"],
+          "properties": {
+            "db_path": {
+              "type": "string",
+              "description": "SQLite ledger file path (relative to moltspay.services.json); created on first start"
+            },
+            "currency": {
+              "type": "string",
+              "enum": ["USD", "CNY"],
+              "default": "USD",
+              "description": "Ledger quote currency. Recorded once and enforced on reopen (a mismatch refuses to start). CNY funds 1:1 from WeChat (payer_total is fen)."
+            },
+            "single_limit": {
+              "type": "string",
+              "pattern": "^\\d+(\\.\\d{1,2})?$",
+              "default": "5.00",
+              "description": "Default per-transaction limit for new buyers (decimal string, ledger currency)"
+            },
+            "daily_limit": {
+              "type": "string",
+              "pattern": "^\\d+(\\.\\d{1,2})?$",
+              "default": "10.00",
+              "description": "Default daily limit for new buyers (decimal string, ledger currency)"
+            },
+            "topup_packs": {
+              "type": "array",
+              "minItems": 1,
+              "items": { "type": "string", "pattern": "^\\d+(\\.\\d{1,2})?$" },
+              "description": "Offered recharge amounts in ledger currency (2.3+), e.g. [\"20.00\", \"50.00\"]"
+            },
+            "default_pack": {
+              "type": "string",
+              "pattern": "^\\d+(\\.\\d{1,2})?$",
+              "description": "Pack the client auto-selects when a 402 finds an insufficient balance (2.3+). Must be one of topup_packs."
+            },
+            "auto_topup_max": {
+              "type": "string",
+              "pattern": "^\\d+(\\.\\d{1,2})?$",
+              "description": "Ceiling on client auto-topup without explicit pack selection (2.3+). Must be >= the largest topup_pack."
+            },
+            "auth_mode": {
+              "type": "string",
+              "enum": ["off", "shadow", "enforce"],
+              "default": "off",
+              "description": "Balance spend authentication (2.4+). 'off': signature not checked (default, backward-compatible; buyer_id keeps bearer semantics). 'shadow': verify per-request signatures and log what would be denied, without blocking (use to confirm every client signs before tightening). 'enforce': reject unsigned/invalid/wrong-signer deductions with 401. The account's signer address is TOFU-bound on first signed use and anchored to the WeChat payer openid at top-up."
             }
           }
         }
@@ -123,7 +218,7 @@
           "output": { "type": "object", "description": "Output schema" },
           "alipay": {
             "type": "object",
-            "description": "Alipay AI 收 per-service config (1.7.0+). Set when this service accepts CNY payments.",
+            "description": "Alipay AI 收 per-service config (2.0+). Set when this service accepts CNY payments.",
             "required": ["price_cny", "goods_name"],
             "properties": {
               "service_id": {
@@ -140,6 +235,22 @@
                 "description": "Goods name shown to the user in the Alipay app"
               }
             }
+          },
+          "wechat": {
+            "type": "object",
+            "description": "WeChat Pay Native per-service config (2.1+). Set when this service accepts CNY payments.",
+            "required": ["price_cny", "description"],
+            "properties": {
+              "price_cny": {
+                "type": "string",
+                "pattern": "^\\d+(\\.\\d{1,2})?$",
+                "description": "CNY price as decimal string in yuan (e.g. '10.00' = 10 CNY, NOT fen)"
+              },
+              "description": {
+                "type": "string",
+                "description": "Order description shown to the payer in the WeChat app"
+              }
+            }
           }
         }
       }
@@ -159,14 +270,14 @@
     },
     {
       "provider": {
-        "name": "灵机一物",
-        "wallet": "0xb8d6f2441e8f8dfB6288A74Cf73804cDd0484E0C",
+        "name": "My Shop",
+        "wallet": "0x0000000000000000000000000000000000000000",
         "chains": ["base", "polygon", "alipay"],
         "alipay": {
-          "seller_id": "2088641494699428",
-          "app_id": "2021006150642142",
-          "seller_name": "上海超响应数字科技有限公司",
-          "service_id_default": "API_0EA6DC4FC99A4DF7",
+          "seller_id": "2088000000000000",
+          "app_id": "2021000000000000",
+          "seller_name": "Example Merchant Co., Ltd.",
+          "service_id_default": "API_XXXXXXXXXXXXXXXX",
           "private_key_path": "./cert/ALIPAY_PRIVATE_KEY.txt",
           "alipay_public_key_path": "./cert/ALIPAY_PUBLIC_KEY.txt"
         }
@@ -178,9 +289,9 @@
           "price": 0.99,
           "currency": "USDC",
           "alipay": {
-            "service_id": "API_0EA6DC4FC99A4DF7",
+            "service_id": "API_XXXXXXXXXXXXXXXX",
             "price_cny": "7.00",
-            "goods_name": "产品演示视频 - 系列一"
+            "goods_name": "Demo Video"
           }
         }
       ]