liufumingren 8949b7198c feat(pay): 微信 Native 扫码支付(下单出码 + 回调入账 + 扫码轮询)
- 新增 service/wxpay.js:统一下单 / 查询订单 / 关闭订单 / APIv2 验签,二维码在服务端本地生成 SVG
- 新增 pay/wechat.js 与 XML 编解码,公开回调 POST /api/pay/wechat/notify
- 订单:同主体 + 同套餐复用未超时待支付单;2 小时超时关单;回调 / 查单 / 手工确认统一走 payNotify
- 迁移 subject_orders 增加 code_url / prepay_id 等字段,配置项 WXPAY_*
- 前端续期弹窗展示二维码并按 2s 轮询支付结果
- 文档与测试同步更新

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 16:23:03 +08:00

233 lines
8.7 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
const { app, mock, assert } = require('egg-mock/bootstrap');
const crypto = require('crypto');
const { buildXml, parseXml, formatWxTime, parseWxTime, truncateUtf8 } = require('../../../app/lib/wxpay-xml');
const KEY = '0123456789abcdef0123456789abcdef';
/** 微信 APIv2 签名(测试里独立实现一遍,避免「用被测代码验被测代码」) */
function wxSign(params, key = KEY, signType = 'MD5') {
const content = Object.keys(params)
.filter(name => name !== 'sign' && params[name] !== undefined && params[name] !== null && params[name] !== '')
.sort()
.map(name => `${name}=${params[name]}`)
.join('&');
const payload = `${content}&key=${key}`;
const digest = signType === 'HMAC-SHA256'
? crypto.createHmac('sha256', key).update(payload, 'utf8').digest('hex')
: crypto.createHash('md5').update(payload, 'utf8').digest('hex');
return digest.toUpperCase();
}
/** 微信应答(自动带正确签名) */
function wxResponse(params, key = KEY) {
return buildXml(Object.assign({}, params, { sign: wxSign(params, key) }));
}
const ctx = () => app.createAnonymousContext();
/** 填上一套假凭证,让 service 认为「已开通」 */
function configure() {
const cfg = app.config.wxpay;
mock(cfg, 'enabled', true);
mock(cfg, 'appId', 'wx-app-1');
mock(cfg, 'mchId', '1900000109');
mock(cfg, 'apiKey', KEY);
mock(cfg, 'signType', 'MD5');
mock(cfg, 'notifyUrl', 'https://trace.example.com/api/pay/wechat/notify');
mock(cfg, 'apiBase', 'https://api.mch.weixin.qq.com');
}
/**
* 微信 Native 支付(APIv2)
*
* 重点:
* - 签名/验签与微信规则一致(独立实现复算请求签名);
* - 统一下单能拿到 `code_url`,参数按 NATIVE 传;
* - 微信的业务错误码(ORDERPAID 等)要原样带给调用方(关单时据此判断「其实已付」)。
*/
describe('test/app/service/wxpay.test.js', () => {
it('wxpay-xml:扁平 XML 编解码 / 时间互转 / 按 UTF-8 字节截断', async () => {
const xml = buildXml({ return_code: 'SUCCESS', return_msg: 'OK' });
assert(xml === '<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg></xml>', xml);
const parsed = parseXml(xml);
assert(parsed.return_code === 'SUCCESS' && parsed.return_msg === 'OK');
assert(parsed.xml === undefined, '根节点不能被当成字段');
// 值可能是 CDATA,也可能是普通文本
const mixed = parseXml('<xml><a>1</a><b><![CDATA[x<y]]></b><c/></xml>');
assert(mixed.a === '1' && mixed.b === 'x<y', JSON.stringify(mixed));
const date = new Date('2026-11-06T02:03:04Z');
assert(formatWxTime(date) === '20261106100304', formatWxTime(date));
assert(parseWxTime('20261106100304').toISOString() === date.toISOString());
assert(parseWxTime('bad') === null);
assert(Buffer.byteLength(truncateUtf8('续期订单', 6), 'utf8') === 6, '中文按字节截断');
assert(Buffer.byteLength(truncateUtf8('abcdef', 6), 'utf8') === 6);
});
it('未配置凭证 → enabled=false,调接口直接 503', async () => {
const wxpay = ctx().service.wxpay;
assert(wxpay.enabled === false, '单测环境默认没有微信支付凭证');
let error = null;
try {
await wxpay.unifiedOrder({ orderNo: 'SO1', totalFee: 100 });
} catch (err) {
error = err;
}
assert(error && error.status === 503, JSON.stringify(error && error.message));
});
it('统一下单:参数/签名正确,返回 code_url', async () => {
configure();
let captured = null;
mock(app, 'httpclient', {
async request(url, options) {
captured = { url, xml: options.data };
return {
status: 200,
data: wxResponse({
return_code: 'SUCCESS',
result_code: 'SUCCESS',
appid: 'wx-app-1',
mch_id: '1900000109',
nonce_str: 'wx-nonce',
prepay_id: 'wx-prepay-1',
code_url: 'weixin://wxpay/bizpayurl?pr=abc',
}),
};
},
});
const result = await ctx().service.wxpay.unifiedOrder({
orderNo: 'SO20261106100000000001',
totalFee: 9900,
description: '30 天',
clientIp: '1.2.3.4',
expireAt: new Date('2026-11-06T02:00:00Z'),
});
assert(result.codeUrl === 'weixin://wxpay/bizpayurl?pr=abc', JSON.stringify(result));
assert(result.prepayId === 'wx-prepay-1');
assert(captured.url === 'https://api.mch.weixin.qq.com/pay/unifiedorder', captured.url);
const req = parseXml(captured.xml);
assert(req.trade_type === 'NATIVE');
assert(req.total_fee === '9900');
assert(req.out_trade_no === 'SO20261106100000000001');
assert(req.spbill_create_ip === '1.2.3.4');
assert(req.notify_url === 'https://trace.example.com/api/pay/wechat/notify');
assert(req.time_expire === '20261106100000', req.time_expire);
assert(req.sign === wxSign(req), '请求签名应能被独立实现复算');
});
it('统一下单:return_code=FAIL → 502;result_code=FAIL 保留业务错误码', async () => {
configure();
mock(app, 'httpclient', {
async request() {
return { status: 200, data: buildXml({ return_code: 'FAIL', return_msg: '签名错误' }) };
},
});
let error = null;
try {
await ctx().service.wxpay.unifiedOrder({ orderNo: 'SO1', totalFee: 100 });
} catch (err) {
error = err;
}
assert(error && error.status === 502, JSON.stringify(error && error.message));
mock(app, 'httpclient', {
async request() {
return {
status: 200,
data: wxResponse({
return_code: 'SUCCESS',
result_code: 'FAIL',
appid: 'wx-app-1',
mch_id: '1900000109',
err_code: 'ORDERPAID',
err_code_des: '订单已支付',
}),
};
},
});
error = null;
try {
await ctx().service.wxpay.closeOrder({ orderNo: 'SO1' });
} catch (err) {
error = err;
}
assert(error && error.code === 'ORDERPAID', JSON.stringify(error && error.message));
});
it('统一下单:应答验签不过 → 502(防伪造回调/应答)', async () => {
configure();
mock(app, 'httpclient', {
async request() {
return {
status: 200,
data: '<xml><return_code><![CDATA[SUCCESS]]></return_code>'
+ '<result_code><![CDATA[SUCCESS]]></result_code><sign><![CDATA[BAD]]></sign></xml>',
};
},
});
let error = null;
try {
await ctx().service.wxpay.queryOrder({ orderNo: 'SO1' });
} catch (err) {
error = err;
}
assert(error && error.status === 502, JSON.stringify(error && error.message));
});
it('verifySign / signOf:正确签名通过,签名或商户号不对一律拒绝', async () => {
configure();
const wxpay = ctx().service.wxpay;
const params = { appid: 'wx-app-1', mch_id: '1900000109', nonce_str: 'n1', out_trade_no: 'SO1' };
assert(wxpay.verifySign(Object.assign({}, params, { sign: wxSign(params) })).ok === true);
assert(wxpay.verifySign(Object.assign({}, params, { sign: 'BAD' })).ok === false);
const otherMch = Object.assign({}, params, { mch_id: '1999999999' });
assert(wxpay.verifySign(Object.assign({}, otherMch, { sign: wxSign(otherMch) })).ok === false,
'别人家的商户号不能通过');
assert(wxpay.signOf({ a: '1' }) === wxSign({ a: '1' }));
assert(wxpay.signOf({ a: '1' }, 'HMAC-SHA256') === wxSign({ a: '1' }, KEY, 'HMAC-SHA256'));
});
it('qrDataUrl:把 code_url 画成本地 SVG data URL', async () => {
const wxpay = ctx().service.wxpay;
const url = wxpay.qrDataUrl('weixin://wxpay/bizpayurl?pr=abc');
assert(url.startsWith('data:image/svg+xml;base64,'), url);
const svg = Buffer.from(url.split(',')[1], 'base64').toString('utf8');
assert(svg.includes('<svg'), svg.slice(0, 80));
assert(wxpay.qrDataUrl('') === null);
});
it('configIssues / warnIfMisconfigured:缺字段、密钥长度不对都要能指出来', async () => {
const wxpay = ctx().service.wxpay;
const issues = wxpay.configIssues();
assert(issues.some(item => item.includes('WXPAY_APP_ID')), JSON.stringify(issues));
assert(issues.some(item => item.includes('WXPAY_MCH_ID')), JSON.stringify(issues));
assert(issues.some(item => item.includes('WXPAY_API_KEY')), JSON.stringify(issues));
configure();
assert(wxpay.configIssues().length === 0, JSON.stringify(wxpay.configIssues()));
// 34 位(微信要求 32 位字母数字)必须报出来
mock(app.config.wxpay, 'apiKey', '4e5qwrtyuiopasdfghjklzxcvbnm123456');
const bad = wxpay.configIssues();
assert(bad.length === 1 && bad[0].includes('32 位'), JSON.stringify(bad));
assert(wxpay.warnIfMisconfigured().length === 1);
});
});