- 新增 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>
233 lines
8.7 KiB
JavaScript
233 lines
8.7 KiB
JavaScript
'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);
|
||
});
|
||
});
|