Skip to content

klover2/wechatpay-node-v3-ts

Repository files navigation

wechatpay-node-v3

OSCS Status npm version npm downloads contributors License: MIT

微信支付v3 支持在ts和js中使用

欢迎大家加入一起完善这个api

前言

微信官方在2020-12-25正式开放了v3版本的接口,相比较旧版本v2有了不少改变,例如:

  • 遵循统一的Restful的设计风格
  • 使用JSON作为数据交互的格式,不再使用XML
  • 使用基于非对称密钥的SHA256-RSA的数字签名算法,不再使用MD5或HMAC-SHA256
  • 不再要求HTTPS客户端证书
  • 使用AES-256-GCM,对回调中的关键信息进行加密保护

由于官方文档只支持java和php,所以我在这里使用ts简单的封装了一个版本,支持在js或者ts中使用,后续会更加完善这个npm包,谢谢。

使用

yarn add [email protected](也可以用npm,请加上版本号,使用正式版本)

import WxPay from 'wechatpay-node-v3'; // 支持使用require
import fs from 'fs';
import request from 'superagent';

const pay = new WxPay({
  appid: '直连商户申请的公众号或移动应用appid',
  mchid: '商户号',
  publicKey: fs.readFileSync('./apiclient_cert.pem'), // 公钥
  privateKey: fs.readFileSync('./apiclient_key.pem'), // 秘钥
});

# 这里以h5支付为例
try {
    # 参数介绍请看h5支付文档 https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter3_3_1.shtml
    const params = {
      appid: '直连商户申请的公众号或移动应用appid',
      mchid: '商户号',
      description: '测试',
      out_trade_no: '订单号',
      notify_url: '回调url',
      amount: {
        total: 1,
      },
      scene_info: {
        payer_client_ip: 'ip',
        h5_info: {
          type: 'Wap',
          app_name: '网页名称 例如 百度',
          app_url: '网页域名 例如 https://www.baidu.com',
        },
      },
    };
    const nonce_str = Math.random().toString(36).substr(2, 15), // 随机字符串
      timestamp = parseInt(+new Date() / 1000 + '').toString(), // 时间戳 秒
      url = '/v3/pay/transactions/h5';

    # 获取签名
    const signature = pay.getSignature('POST', nonce_str, timestamp, url, params); # 如果是get 请求 则不需要params 参数拼接在url上 例如 /v3/pay/transactions/id/12177525012014?mchid=1230000109
    # 获取头部authorization 参数
    const authorization = pay.getAuthorization(nonce_str, timestamp, signature);

    const result = await request
      .post('https://api.mch.weixin.qq.com/v3/pay/transactions/h5')
      .send(params)
      .set({
        Accept: 'application/json',
        'Content-Type': 'application/json',
        'User-Agent':
          'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36',
        Authorization: authorization,
      });

    console.log('result==========>', result.body);
  } catch (error) {
    console.log(error);
  }

如果你使用的是nest框架,请结合nest-wechatpay-node-v3一起使用。

使用自定义 http 请求

import { IPayRequest, Output } from 'wechatpay-node-v3/dist/define';

自己实现 IPayRequest 接口,使用如下方法注入

pay.createHttp(...);

WxPay 介绍

import WxPay from 'wechatpay-node-v3'; 或者 const WxPay = require('wechatpay-node-v3')

参数介绍

参数名称 参数介绍 是否必须
appid 直连商户申请的公众号或移动应用appid
mchid 商户号
serial_no 证书序列号
publicKey 公钥
privateKey 密钥
authType 认证类型,目前为WECHATPAY2-SHA256-RSA2048
userAgent 自定义User-Agent
key APIv3密钥 否 有验证回调必须

注意

  1. serial_no是证书序列号 请在命令窗口使用 openssl x509 -in apiclient_cert.pem -noout -serial 获取
  2. 头部参数需要添加 User-Agent 参数
  3. 需要在商户平台设置APIv3密钥才会有回调,详情参看文档指引http://kf.qq.com/faq/180830E36vyQ180830AZFZvu.html

使用介绍

以下函数是我针对微信相关接口进行进一步封装,可以直接使用。

api名称 函数名
h5支付 transactions_h5
native支付 transactions_native
app支付 transactions_app
JSAPI支付 或者 小程序支付 transactions_jsapi
查询订单 query
关闭订单 close
申请交易账单 tradebill
申请资金账单 fundflowbill
下载账单 downloadBill
回调解密 decipher_gcm
合单h5支付 combine_transactions_h5
合单native支付 combine_transactions_native
合单app支付 combine_transactions_app
合单JSAPI支付 或者 小程序支付 combine_transactions_jsapi
查询合单 combine_query
关闭合单 combine_close
获取序列号 getSN
申请退款 refunds
查询退款 find_refunds
签名验证 verifySign
微信提现到零钱 batches_transfer
分账 create_profitsharing_orders

版本介绍

版本号 版本介绍
v0.0.1 仅支持签名和获取头部参数Authorization
v1.0.0 增加了支付(不包括合单支付)、查询订单、关闭订单、申请交易账单、申请资金账单、下载账单
v1.2.0 增加了回调解密,合单支付、合单关闭、合单查询
v1.2.1 修改app、jsapi、native支付字段scene_info 改为可选
v1.2.2 增加获取序列号方法
v1.2.3 修改小程序支付签名错误和取消serial_no字段必填
v1.3.0 增加普通订单的退款和查询
v1.3.1 修复APP调起支付时出现“支付验证签名失败“的问题
v1.3.2 增加请求成功后的签名验证
v1.3.3 修复superagent post请求异常 Z_DATA_ERROR
v1.3.4 修复superagent get请求异常 Z_DATA_ERROR
v1.3.5 修复APP支付签名错误
v2.0.0 增加提现到零钱和优化接口参数,规定返回参数格式,其他接口会后续优化
v2.0.1 增加请求头Wechatpay-Serial和完善转账其他接口
v2.0.2 增加敏感信息加密方法(publicEncrypt)
v2.0.3 修复get请求无参时的签名
v2.0.4 修复敏感信息加密方法(publicEncrypt)使用微信平台公钥
v2.0.6 修复发起商家转账零钱参数wx_serial_no(自定义参数,即http请求头Wechatpay-Serial的值)为可选参数
v2.1.0 升级superagent依赖6.1.0到8.0.6
v2.1.1 商家转账API支持场景参数
v2.1.2 基础支付接口支持传appid
v2.1.3 支持分账相关接口
v2.1.4 修复错误原因存在空值bug
v2.1.5 修复动态 appid 签名错误
v2.1.6 Native下单API支持support_fapiao字段
v2.1.7 修复退款接口refunds和find_refunds返回结果中的http status会被业务status覆盖问题
v2.1.8 修复回调签名key错误
v2.2.0 修复回调解密报Unsupported state or unable to authenticate data
v2.2.1 上传图片

文档

v2支付文档 v3支付文档

贡献

欢迎提存在的Bug或者意见

About

微信支付v3

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published