扫码联系在线客服微信支付风控核查技能
基本信息
| 字段 | 内容 |
|------|------|
| Slug | wechatpay-risk-check |
| 名称 | 微信支付风控核查 |
| 描述 | 微信支付风控核查解决方案，提供事前商户风险核查服务。基于微信支付官方风控接口，支持身份证、银行卡、营业执照、门店信息等多维度风险评估，精准识别高风险商户，保障支付安全。 |
| 版本 | 1.0.0 |
| 作者 | 叶建国 |
| 标签 | payment, wechat, weixin, fintech, risk-control |
功能概述
🔒 核心功能 - 风险商户核查
在商户入驻前进行多维度风险评估，精准识别高风险商户。
核查维度：
- 身份信息核查 - 身份证号、姓名
- 结算信息核查 - 银行卡号、户名、开户行
- 公司信息核查 - 营业执照、公司名称
- 门店信息核查 - 门店地址、经纬度
风险级别： | 级别 | 说明 | 处理建议 | |------|------|----------| | UNKNOW | 未知风险 | 需人工复核 | | NORMAL | 一般风险 | 正常进件 | | MEDIUM | 中风险 | 需补充材料 | | HIGH | 高风险 | 拒绝进件 | | LOW | 低风险 | 快速通过 | | FORBIDDEN | 禁入 | 永久拒绝 |
快速开始
1. 配置参数
const WechatPay = require('./lib/wechatpay');
const wp = new WechatPay({
appId: 'wx8888888888888888',
mchId: '1900000109', // 服务商号
apiKey: 'YOUR_API_KEY', // API密钥
appSecret: 'YOUR_APPSECRET',
certPath: '/path/to/apiclient_cert.pem', // 证书路径
certKeyPath: '/path/to/apiclient_key.pem', // 私钥路径
notifyUrl: 'https://your-domain.com/notify',
isSandbox: false // 是否沙箱环境
});
2. 事前 - 商户风险核查
// 查询商户风险
const riskResult = await wp.preRisk.queryMchRisk({
certificates_number: '加密后的身份证号',
certificates_name: '加密后的姓名',
settlement_card_no: '加密后的银行卡号',
settlement_card_name: '加密后的户名',
business_license_number: '加密后的营业执照号',
company_name: '公司名称',
store_address: '门店地址',
store_longitude: '经度',
store_latitude: '纬度'
});
console.log('风险级别:', riskResult.risk_level);
console.log('风险描述:', riskResult.risk_level_desc);
3. 事中 - 创建支付订单
// JSAPI支付下单
const order = await wp.trade.createJsapiOrder({
body: '商品描述',
out_trade_no: 'ORDER123456789',
total_fee: 1, // 单位：分
spbill_create_ip: '客户端IP',
notify_url: 'https://your-domain.com/notify',
trade_type: 'JSAPI',
sub_openid: '用户openid'
});
console.log('支付参数:', order);
// 返回唤起微信支付所需的参数
4. 事中 - 订单查询
// 查询订单状态
const orderInfo = await wp.trade.queryOrder({
out_trade_no: 'ORDER123456789'
});
console.log('订单状态:', orderInfo.trade_state);
console.log('交易金额:', orderInfo.total_fee);
5. 事中 - 申请退款
// 申请退款
const refund = await wp.trade.applyRefund({
out_trade_no: 'ORDER123456789',
out_refund_no: 'REFUND123456789',
total_fee: 1,
refund_fee: 1,
refund_desc: '用户申请退款'
});
6. 事后 - 查询余额
// 查询账户余额
const balance = await wp.settlement.getBalance();
console.log('可用余额:', balance.available_balance);
console.log('待结算金额:', balance.pending_balance);
7. 事后 - 下载对账单
// 获取对账单下载链接
const billUrl = await wp.settlement.getBillDownloadUrl({
bill_date: '20240401',
bill_type: 'ALL' // ALL: 全部分账账单, SUCCESS: 成功账单, REFUND: 退款账单
});
console.log('账单下载地址:', billUrl.download_url);
API 参考
事前风控模块 (PreRisk)
| 方法 | 说明 | 适用场景 |
|------|------|----------|
| queryMchRisk | 商户风险核查 | 商户入驻前必查 |
| queryCertificateRisk | 证照风险核查 | 营业执照核实 |
| querySettlementRisk | 结算信息风险 | 银行卡风控 |
交易模块 (Trade)
| 方法 | 说明 |
|------|------|
| createJsapiOrder | JSAPI支付下单 |
| createNativeOrder | Native支付下单 |
| createAppOrder | APP支付下单 |
| queryOrder | 查询订单 |
| closeOrder | 关闭订单 |
| applyRefund | 申请退款 |
| queryRefund | 查询退款 |
| reverseOrder | 撤销订单 |
结算模块 (Settlement)
| 方法 | 说明 |
|------|------|
| getBalance | 查询账户余额 |
| getBillDownloadUrl | 获取账单下载链接 |
| getTransferBill | 转账电子回单 |
| getSettlementInfo | 结算信息 |
| getDailySummary | 日交易汇总 |
回调通知模块 (Notify)
| 方法 | 说明 |
|------|------|
| parseNotify | 解析回调通知 |
| verifyNotifySign | 验签 |
| responseSuccess | 返回成功响应 |
配置说明
证书配置
微信支付需要双向SSL证书：
{
certPath: './cert/apiclient_cert.pem',
certKeyPath: './cert/apiclient_key.pem'
}
证书获取方式：
- 登录微信支付商户平台
- 账户中心 → API安全
- 申请API证书
加密说明
敏感信息（身份证、银行卡等）需使用RSA加密：
const encrypted = wp.utils.rsaEncrypt(rawData, publicKey);
签名机制
所有请求需使用HMAC-SHA256签名：
const sign = wp.utils.sign(params, apiKey);
错误码处理
| 错误码 | 说明 | 处理建议 | |--------|------|----------| | SYSTEMERROR | 系统错误 | 稍后重试 | | PARAM_ERROR | 参数错误 | 检查参数 | | ORDERPAID | 订单已支付 | 核实订单状态 | | ORDERCLOSED | 订单已关闭 | 无需处理 | | BANKERROR | 银行异常 | 联系银行 | | USERPAYING | 用户支付中 | 等待支付结果 | | AUTHCODEERROR | 授权码无效 | 重新获取授权码 | | NOTENOUGH | 余额不足 | 用户充值 |
安全规范
- 证书安全：证书文件妥善保管，禁止提交到代码仓库
- 敏感信息：身份证、银行卡等需RSA加密传输
- 签名验证：回调通知必须验签后再处理业务
- 日志规范：禁止记录敏感信息（卡号、密码等）
- 超时处理：网络异常需做好幂等处理
依赖项
{
"axios": "^1.6.0",
"xml2js": "^0.5.0",
"crypto-js": "^4.2.0",
"node-rsa": "^1.1.1"
}
注意事项
- 事前风控是必选项：建议所有商户入驻前必须调用风险核查接口
- 交易金额单位：所有金额单位为分，需自行转换
- 签名类型：仅支持HMAC-SHA256
- 证书要求：涉及资金操作需双向证书
- 回调验签：生产环境必须验签
版权声明
本技能基于微信支付官方文档开发，版权归属微信支付所有。 如有疑问请联系微信支付商户客服：95017
微信支付文档：https://pay.weixin.qq.com/
更新日志
v1.0.0 (2026-04-05)
- 初始版本
- 支持事前风险核查
- 支持事中交易处理
- 支持事后结算对账