Code Monkey home page Code Monkey logo

node-wxpay's Introduction

node-wxpay

微信支付APIv3 for nodejs

功能概述

  • 完成模块 jsapi,native,h5,app统一下单,付款交易查询,退款,退款交易查询,解密通知参数,公钥获取,验证签名,交易账单,资金账单,下载账单
  • 支付模式支持 付款码/公众号/小程序/APP/H5/扫码支付

交流

微信:yangfuhe036,如有任何问题欢迎加微信交流。喜欢或对你有帮助,欢迎右上角 star,非常感谢!

使用前必读

版本要求

nodejs >= 8.3.0

安装

npm i wxpay-v3 --save

# 如已安装旧版, 重新安装最新版
npm i wxpay-v3@latest

实例化

const Payment = require('wxpay-v3');
const paymnet = new Payment({
    appid: '公众号ID',
    mchid: '微信商户号',
    private_key: require('fs').readFileSync('*_key.pem证书文件路径').toString(),//或者直接复制证书文件内容
    serial_no:'证书序列号',
    apiv3_private_key:'api v3密钥',
    notify_url: '支付退款结果通知的回调地址',
})

config说明:

  • appid - 公众号ID(必填)
  • mchid - 微信商户号(必填)
  • private_key - 商户API证书*_key.pem中内容 可在微信支付平台获取(必填, 在微信商户管理界面获取)
  • serial_no - 证书序列号(必填, 证书序列号,可在微信支付平台获取 也可以通过此命令获取(*_cert.pem为你的证书文件) openssl x509 -in *_cert.pem -noout -serial )
  • apiv3_private_key - apiv3密钥 在创建实例时通过apiv3密钥会自动获取平台证书的公钥,以便于验证签名(必填)
  • notify_url - 支付退款结果通知的回调地址(选填)
    • 可以在初始化的时候传入设为默认值, 不传则需在调用相关API时传入
    • 调用相关API时传入新值则使用新值

jsapi统一下单

let result = await payment.jsapi({
    description:'点存云-测试支付',
    out_trade_no:Date.now().toString(),
    amount:{
        total:1
    },
    payer:{
        openid:'ouEJk65CZr8_7eb95RIPDNWZKrvI'
    },

})
console.log(result)

app统一下单

let result = await payment.app({
    description:'点存云-测试支付',
    out_trade_no:Date.now().toString(),
    amount:{
        total:1
    }
})
console.log(result)

h5统一下单

let result = await payment.h5({
    description:'点存云-测试支付',
    out_trade_no:Date.now().toString(),
    amount:{
        total:1
    },
    scene_info:{
        payer_client_ip:'203.205.219.187'
    }
})
console.log(result)

native统一下单

let result = await payment.native({
    description:'点存云-测试支付',
    out_trade_no:Date.now().toString(),
    amount:{
        total:1
    }
})
console.log(result)

通过transaction_id查询订单

let result = await payment.getTransactionsById({
    transaction_id:'4200000928202103013162567337'
})
console.log(result)

通过out_trade_no查询订单

let result = await payment.getTransactionsByOutTradeNo({
    out_trade_no:'1614602083807'
})
console.log(result)

关闭订单

let result = await payment.close({
    out_trade_no:'1614602083807'
})
console.log(result)

退款

let result = await payment.refund({
    transaction_id:'4200000902202103026804947229',
    //out_trade_no:'1614602083807',
    out_refund_no:Date.now().toString(),
    amount:{
        refund:1,
        total:1,
        currency:'CNY'
    }
})
console.log(result)

查询单笔退款订单

let result = await payment.getRefund({
    out_refund_no:'1614757507992',
})
console.log(result)

获取平台证书列表

let result = await payment.getCertificates()
console.log(result)

解密支付退款通知参数

let result = payment.decodeResource({
    "original_type":"refund",
    "algorithm":"AEAD_AES_256_GCM",
    "ciphertext":"d2Zi2VToOGXqB3K6bgQaFKktgA3AHm+cJg0vGZPcD22OUZ+CBymtrFJsFtaKKEwebSDN8Habic7NJVpKJpAxZd8ejm32v4UePg139/gj+X7vJtqB39ZkjZXLH973LT5R5yZQ351R3onlpx9JILN2+FNEbrUNenjgEufuQn45b9jwGSBX/sU6n/+gsCdt8+sSkbMy37sSX1bjMicHzte27fR0QSuO1TDjZjjDqP2ou0j7Jb+x9RRtWlbZ1hOYe7AhSTFzOXvkdCq0M6P6ja1cc2olV9xG8UzKxZN0JLnoqIGWwPzTVOPqmt/N3/MrzCK3TT1mNagBnhqEvSXhL9KUjpAIY8J6tkjfoG+9QwnJA8kW48C3nGsgePvNYvikJooQii7rx78Y2paR7cS8Pn8+sxKg4q91DiovBSdW2/ePDruI6SH/FWFrPmLQCG11fCjz/C9o6bqjaSsHKMaSVSAW9e/et04MP6GcZIDweG5AN9FgOXMI",
    "associated_data":"refund",
    "nonce":"AqfRSFm7h9Sa"
})
console.log(result)

验证签名

setTimeout(async ()=>{
    //timestamp,nonce,serial,signature均在HTTP头中获取,body为请求参数
    let result = await payment.verifySign({
        timestamp:'1614829763',
        nonce:'Eeumuhd3zA5TirWeJUCLCpkENYM8PSUA',
        serial:'3DEA336346E96C002B7B0D514D424C8DEDBF9145',
        signature:'ame3lX1y6FeXrlBN973M1Dhg5n77M1wVsD3VgeyZlb8c3dz/hpQ+9vNOMBBHGdv8kDIfZUxKDdfoeUaVJhfqAEn9ZV4x112ntEzCHpJtIXQ3rr8fScY7cO71EN/QyQHtY1Ovt8U2Yr891iYaLujUrBHtWrhiR6UKecRA+/RgsUBYh4D10rrqW5ywNrLVN+PSuG4QB85bz3jSslMvRrSG7HP/Xwo3e2sWMDuQ2Uadefu+8/FK1P3KDLDO2fq5teSaaqs7oof2WpV6zrVtyQ+P4p5t8NJ0ExlOSAs2xGJ0+xi+U996tq3VYZXf/4nVsfGW9rn0m/mOrYTmiST9PF+q1g==',
        body:'{"id":"3b66121d-c9b9-5d61-9d92-eeec248e993d","create_time":"2021-03-04T11:49:23+08:00","resource_type":"encrypt-resource","event_type":"TRANSACTION.SUCCESS","summary":"支付成功","resource":{"original_type":"transaction","algorithm":"AEAD_AES_256_GCM","ciphertext":"PB305U6jR6TN8mBzbzGts5TaKnDXQt/7C+uJpGnvOT1SyCvI18L4f42eTZtrZv+5XUdOkxwEHGWDVl2MwbvpgLjLdjyisaHc+uRQCDoYlusiaeDJzd515Rl36nqmdPD8xFKZahWZBBkAlCgXLuW3qcdxSISTk/pyqPziwUtFKfMeq3LEEm4z8DfBM9cVXJrN8EiY2WaQsm+lGnZAV4+pxCELj67xmccXs3JgJwHSKE4exqW919atQWTwJHzuP3WNd+Xvp0zwm9RtDPTvZ8egehqqBw+DARC5jg8MmDtlMR2sTgH2xq6b4+QqLXPPIooOyvEZKMOteSI4FmSfPNwDfZ26D4ga9yGRIxSQKkWDq3QRNhOzvmSkCax08t2hdq12NxBSE9y7aZkjKIr4/uMEtKDU/3wcSoVKlawfN1hlCKo2nWbdKH1avRvc6FAFxXHtXRw0Y0MRnSk8gPMF/T+QqEMRJniXbrylt21xR0AEKbIVk0xK9jvhXex0AvST4x3eKM0r4DXkmL/pCjo1XmZLZIMc2uJ1jJEyqWcURXirrxADCATIAEWOu1hNL6PE","associated_data":"transaction","nonce":"KcsMoPx5UW1i"}}'
    })
    console.log(result)
},2000)

申请交易账单

let result = await payment.tradebill({
    bill_date:'2021-03-03'
})
console.log(result)

申请资金账单

let result = await payment.fundflowbill({
    bill_date:'2021-03-03'
})
console.log(result)

下载账单

let result = await payment.downloadbill('https://api.mch.weixin.qq.com/v3/billdownload/file?token=ktWgOuBvGNvmCk0NaOTMF41tG3yWsZrdM4zdgl10r1GRRNo4tG5V9mPi04ku-PY8&tartype=gzip')
console.log(result)

交流

微信:yangfuhe036,如有任何问题欢迎加微信交流。喜欢或对你有帮助,欢迎右上角 star,非常感谢!

node-wxpay's People

Contributors

yangfuhe avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

node-wxpay's Issues

支付方式及入参相关问题

请问支持小程序的支付方式吗?
JSAPI支付发起的时候
商户订单号 | out_trade_no 这个参数 不需要传吗?

throw new Error('获取证书列表失败')

const Payment = require("wxpay-v3");
const payment = new Payment({
appid: "xxxx",
mchid: "xxx",
private_key: require("fs")
.readFileSync("./cert/apiclient_key.pem")
.toString(), //或者直接复制证书文件内容
serial_no: "3xxxxxxxC0DFDB7CF67B901A5A5746A",
apiv3_private_key: "xxxxxx",
notify_url: "https://f.tuoyal.com/beta-api/version",
});
// const config = {
// mchid: '1633213487', // 商户号
// serial: '36DA2A3BF839A4FC0C0DFDB7CF67B901A5A5746A', // 商户API证书序列号
// privateKey: readFileSync('./cert/apiclient_key.pem'), // 商户API私钥
// publicKey: readFileSync('./cert/apiclient_cert.pem'), // 微信支付平台公钥
// appid: 'wx7331e7f65737fd9a', // 微信支付应用ID
// };

let test = async () => {
let result = await payment.app({
description: "点存云-测试支付",
out_trade_no: Date.now().toString(),
amount: {
total: 1,
},
});
console.log("result", result);
};

/Users/liuzukuan/Desktop/wechat/node_modules/wxpay-v3/lib/index.js:231
throw new Error('获取证书列表失败')
^

Error: 获取证书列表失败
at Payment.decodeCertificates (/Users/liuzukuan/Desktop/wechat/node_modules/wxpay-v3/lib/index.js:231:19)
at process.processTicksAndRejections (node:internal/process/task_queues:95:5)

decodeCertificates() in constructor

decodeCertificates 是异步函数

constructor({appid, mchid, private_key, serial_no,apiv3_private_key,notify_url} = {}) {
....
this.decodeCertificates(); // pending , 无法加载 certificates
}

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.