diff --git a/docs/incidents/2026-11-19-one-shop-payment-directory.md b/docs/incidents/2026-11-19-one-shop-payment-directory.md
new file mode 100644
index 0000000..c78b941
--- /dev/null
+++ b/docs/incidents/2026-11-19-one-shop-payment-directory.md
@@ -0,0 +1,11 @@
+# 商城微信付款页面 URL 未注册
+
+用户在 iOS 微信中从商城登录进入商品付款页,微信提示当前页面 URL 未注册,错误中的 URL 仍是商城 `/login` 登录回调地址。后端预支付已成功,但收银台从商城域名下拉起,支付授权目录未匹配;SPA 路由变化没有替换微信识别的初始文档。
+
+修复:现金订单桥接下单携带服务端订单 ID,Memind 返回 `H5_PUBLIC_BASE_URL` Origin 下 `/one-shop-pay` 的签名付款链接。商城使用整页导航。独立收银台通过 POST 验证片段中的短时 HMAC token,显示服务端金额,点击后调用微信。成功或手动返回时整页回到固定商城原订单,由商城读取微信回调后的状态。
+
+链接有效期 5 分钟,签名覆盖金额、预支付参数和固定返回地址。链接不携带商城登录 token 或桥接密钥,不允许浏览器修改价格或返回站点。页面禁止缓存、外部资源和嵌入,返回地址仅允许商城订单路径。扫码支付和旧充值桥接保持兼容。
+
+配置核验:生产 `H5_PUBLIC_BASE_URL=https://m.tkmind.cn`,微信商户平台 JSAPI 支付授权目录需匹配(建议 `https://m.tkmind.cn/`)。无法通过本地自动化读取商户后台的实际授权目录,最终需微信真机低金额付款验收。
+
+验证:`node --test server/one-shop-checkout.test.mjs server/portal-one-shop-routes.test.mjs server/one-shop-cash-payment.test.mjs wechat-pay.test.mjs`,覆盖签名篡改、过期、外站返回拒绝、服务端金额、取消重试和成功返回。商城前后台执行 `npm run build`。不主动扣款。
diff --git a/server/one-shop-checkout.mjs b/server/one-shop-checkout.mjs
new file mode 100644
index 0000000..7105597
--- /dev/null
+++ b/server/one-shop-checkout.mjs
@@ -0,0 +1,80 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+
+const lifetimeMs = 5 * 60_000;
+const signature = (body, secret) => createHmac('sha256', secret)
+ .update('one-shop-checkout-v1:' + body).digest('base64url');
+
+export function createCheckoutToken(payload, secret, now = Date.now()) {
+ const body = Buffer.from(JSON.stringify({ ...payload, expires: now + lifetimeMs })).toString('base64url');
+ return body + '.' + signature(body, secret);
+}
+
+export function readCheckoutToken(token, secret, shopOrigin, now = Date.now()) {
+ if (typeof token !== 'string' || token.length > 8192) throw new Error('Invalid checkout');
+ const [body, signed, extra] = token.split('.');
+ if (!body || !signed || extra !== undefined) throw new Error('Invalid checkout');
+ const expected = Buffer.from(signature(body, secret));
+ const actual = Buffer.from(signed);
+ if (actual.length !== expected.length || !timingSafeEqual(actual, expected)) throw new Error('Invalid checkout');
+ const payload = JSON.parse(Buffer.from(body, 'base64url').toString());
+ const target = new URL(payload.return_url);
+ if (!Number.isSafeInteger(payload.expires) || payload.expires <= now || payload.expires > now + lifetimeMs ||
+ target.origin !== shopOrigin || !/^\/my\/orders\/[1-9]\d*\/pay$/.test(target.pathname) || target.search || target.hash ||
+ !Number.isSafeInteger(payload.amount_cents) || payload.amount_cents <= 0 || !payload.jsapi_params?.package) {
+ throw new Error('Invalid checkout');
+ }
+ return payload;
+}
+
+// A standalone document ensures WeChat sees Memind's URL rather than a shop SPA entry URL.
+export function checkoutHtml(nonce) {
+ return `
+商城订单付款
+
+商城订单付款
正在加载付款信息…
+
+`;
+}
diff --git a/server/one-shop-checkout.test.mjs b/server/one-shop-checkout.test.mjs
new file mode 100644
index 0000000..1752ee4
--- /dev/null
+++ b/server/one-shop-checkout.test.mjs
@@ -0,0 +1,106 @@
+import assert from 'node:assert/strict';
+import { once } from 'node:events';
+import test from 'node:test';
+import vm from 'node:vm';
+import express from 'express';
+import { attachPortalOneShopRoutes } from './portal-one-shop-routes.mjs';
+import { checkoutHtml, createCheckoutToken, readCheckoutToken } from './one-shop-checkout.mjs';
+
+const key = 'test-only-shop-checkout-secret-32bytes';
+const origin = 'https://shop.example.test';
+const params = { appId: 'wx-app', package: 'prepay_id=test', paySign: 'test-sign' };
+const payload = { amount_cents: 1234, return_url: origin + '/my/orders/42/pay', jsapi_params: params };
+
+test('checkout handoff rejects altered, expired, wrong-key and foreign-return tokens', () => {
+ const now = 1_000_000;
+ const token = createCheckoutToken(payload, key, now);
+ assert.equal(readCheckoutToken(token, key, origin, now).amount_cents, 1234);
+ assert.throws(() => readCheckoutToken(token + 'x', key, origin, now));
+ assert.throws(() => readCheckoutToken(token, 'wrong-key', origin, now));
+ assert.throws(() => readCheckoutToken(token, key, origin, now + 300_000));
+ assert.throws(() => readCheckoutToken(token, key, 'https://other.example.test', now));
+ for (const return_url of ['https://evil.example/', origin + '//evil', origin + '/my/orders/42/pay?return=evil']) {
+ assert.throws(() => readCheckoutToken(createCheckoutToken({ ...payload, return_url }, key, now), key, origin, now));
+ }
+});
+
+test('cash prepay returns Memind checkout and signed data without trusting browser prices or Host', async (t) => {
+ const app = express();
+ let created = 0;
+ attachPortalOneShopRoutes({
+ app, jsonBody: express.json(), wechatNotifyBody: express.raw({ type: '*/*' }),
+ userAuthReady: Promise.resolve(),
+ getUserAuth: () => ({ getWechatOpenidForUser: async (user, appId) => {
+ assert.equal(user, 'user-1'); assert.equal(appId, 'wx-app'); return 'openid-1';
+ } }),
+ userToken: () => '', shopPublicUrl: origin, shopInternalUrl: origin,
+ sharedSecret: key, paymentPublicUrl: 'https://memind.example.test',
+ getPayClient: () => ({ enabled: true, appId: 'wx-app', createJsapiOrder: async (order) => {
+ assert.equal(order.amountCents, 1234); assert.equal(order.openid, 'openid-1');
+ created++; return { jsapiParams: params };
+ } }), logger: { warn() {} },
+ });
+ const server = app.listen(0, '127.0.0.1');
+ t.after(() => new Promise(resolve => server.close(resolve)));
+ await once(server, 'listening');
+ const base = `http://127.0.0.1:${server.address().port}`;
+ const prepay = (secret, order_id = 42) => fetch(base + '/internal/one-shop/wechat-pay', {
+ method: 'POST', headers: { 'Content-Type': 'application/json', 'X-One-Shop-Bridge-Key': secret, Host: 'evil.example' },
+ body: JSON.stringify({ out_trade_no: 'OC' + 'A'.repeat(30), amount_cents: 1234, memind_user_id: 'user-1', order_id }),
+ });
+ assert.equal((await prepay('bad')).status, 403);
+ assert.equal((await prepay(key, '../evil')).status, 400);
+ assert.equal(created, 0);
+ const response = await prepay(key);
+ assert.equal(response.headers.get('cache-control'), 'no-store');
+ const url = new URL((await response.json()).checkout_url);
+ assert.equal(url.origin, 'https://memind.example.test');
+ assert.equal(url.pathname, '/one-shop-pay');
+ assert.equal(url.search, '');
+ const token = new URLSearchParams(url.hash.slice(1)).get('checkout');
+ const redeem = (body) => fetch(base + '/auth/one-shop/payment', {
+ method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body),
+ });
+ const checkout = await redeem({ token, amount_cents: 1, return_url: 'https://evil.example' });
+ assert.equal(checkout.headers.get('cache-control'), 'no-store');
+ const data = await checkout.json();
+ assert.equal(data.amount_cents, 1234);
+ assert.equal(data.return_url, payload.return_url);
+ assert.deepEqual(data.jsapi_params, params);
+ assert.equal((await redeem({ token: token + 'x' })).status, 410);
+ assert.equal((await redeem({})).status, 410);
+ const page = await fetch(base + '/one-shop-pay');
+ assert.match(page.headers.get('content-security-policy'), /frame-ancestors 'none'/);
+ assert.equal(page.headers.get('referrer-policy'), 'no-referrer');
+ assert.equal(page.headers.get('cache-control'), 'no-store');
+ assert.match(await page.text(), /商城订单付款/);
+});
+
+test('checkout invokes bridge on user click, handles cancellation, and returns for server confirmation', async () => {
+ const elements = Object.fromEntries(['pay', 'back', 'message', 'amount'].map(id => [id, {}]));
+ const redirects = [];
+ let callback;
+ let invokes = 0;
+ const script = checkoutHtml('fixture').match(/