使用说明

安装

配置 PayAddon

import{Module}from'@nestjs/common';import{PayAddon}from'@notadd/addon-pay';@Module({imports:[PayAddon.forRoot({wechatConfig:{appid:'appid',// 公众号appi/应用appid/小程序appidmch_id:'mch_id',// 商户号secretKey:'secretKey',// 商户交易秘钥sign_type:'MD5',// 微信支付签名类型('MD5' | 'HMAC-SHA256')，默认MD5，配置后，所有接口参数均会使用这个签名类型pfx:fs.readFileSync('path_to_p12_file'),// p12文件sandbox:true// 是否启用沙箱环境，默认不启用，用于商户支付验收测试}})]})exportclassApplicationModule{}

微信支付

使用 WeChatXXXPayService 调用 API

import{Injectable,Inject}from'@nestjs/common';import{WeChatNativePayService,WeChatTradeType}from'@notadd/addon-pay';@Injectable()exportclassTestPay{constructor(@Inject(WeChatNativePayService)privatereadonlyweChatNativePayService:WeChatNativePayService){}asyncnativePay(){constressult=awaitthis.weChatNativePayService.pay({body:'支付一下',out_trade_no:'201811271512000001',total_fee:301,spbill_create_ip:'127.0.0.1',// 支付请求方IPnotify_url:'your.domain.com/payment/wechat_order_notify',// 服务端支付通知地址trade_type:WeChatTradeType.JSAPI});}}

使用 WeChatNotifyParserUtil 解析支付/退款通知

import{Controller,Inject,Post,Req,Res}from'@nestjs/common';import{WeChatNotifyParserUtil}from'@notadd/addon-pay';@Controller('payment')exportclassPaymentNotifyController{constructor(        @Inject(WeChatNotifyParserUtil)privatereadonlyweChatNotifyParserUtil:WeChatNotifyParserUtil){}/**     * 微信支付统一下单通知路由     *     * 特别提醒：商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致，防止数据泄漏导致出现“假通知”，造成资金损失。     *     * 技术人员可登进微信商户后台扫描加入接口报警群。     *     *@param req 通知请求     */    @Post('wechat_order_notify')asyncweChatOrderNotify(@Req()req, @Res()res){// 必须使用 @Res() 注解向微信返回结果// 当 data 为 undefined 时，表示通知请求中的 sign 验签失败constdata=awaitthis.weChatNotifyParserUtil.parsePayNotify(req);// 验签失败时if(!data){// 微信会重新发起通知res.end(this.weChatNotifyParserUtil.generateFailMessage('验签失败'));// 必须使用 res.end() 向微信返回当前业务结果;}// 判断返回状态，失败时if(data.return_code==='FAIL'){// 处理业务数据// ......// 根据情况返回成功或失败消息}// 判断业务状态，失败时if(data.result_code==='FAIL'){// 处理业务数据// ......// 根据情况返回成功或失败消息}// 成功时返回res.end(this.weChatNotifyParserUtil.generateSuccessMessage());// 必须使用 res.end() 向微信返回当前业务结果;}/**     * 微信支付退款通知路由     *     * 特别说明：退款结果对重要的数据进行了加密，商户需要用商户秘钥进行解密后才能获得结果通知的内容。     *     *@param req 通知请求     */    @Post('wechat_refund_notify')asyncweChatRefundNotify(@Req()req){// 当 data 为 undefined 时，表示通知请求中的 req_info 解密失败constdata=awaitthis.weChatNotifyParserUtil.parseRefundNotify(req);// 解密失败时if(!data){// 微信会重新发起通知returnthis.weChatNotifyParserUtil.generateFailMessage('解密失败');}// 判断返回状态，失败时if(data.return_code==='FAIL'){// 处理业务数据// ......// 根据情况返回成功或失败消息}// 成功时返回returnthis.weChatNotifyParserUtil.generateSuccessMessage();}}

使用 WeChatSignUtil 计算签名

import{Injectable,Inject}from'@nestjs/common';import{WeChatSignUtil}from'@notadd/addon-pay';@Injectable()exportclassTestSign{constructor(@Inject(WeChatSignUtil)privatereadonlyweChatSignUtil:WeChatSignUtil){}asynctestWechatSign(){constparams={appid:'xxxxx',openid:'xxxxx'};constsign=awaitthis.weChatSignUtil.sign(params);}}

如何使用支付验收 case ？

支付宝支付

随机字符生成工具

import{Injectable,Inject}from'@nestjs/common';import{RandomUtil}from'@notadd/addon-pay';@Injectable()exportclassTestSign{constructor(@Inject(RandomUtil)privatereadonlyrandomUtil:RandomUtil){}asynctestRandomStr(){/**         * genRandomStr(pool?: string, length?: number) 接受两个参数：         *         * pool 随机字符池，默认：ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789         *         * length 随机字符长度，默认：32         */constrandomStr=awaitthis.randomUtil.genRandomStr();}}

贡献说明

功能开发

发现 Bug ？

QQ 交流群

Roadmap