在微信小程序或公众号开发中,实现支付功能需要使用微信支付 API,而 npm 包 wx-payment 提供了封装好的支付相关接口,使得我们能够更加方便快捷地完成支付功能的开发。本文将详细介绍 wx-payment 的使用方法,以帮助读者更好地了解和运用它。
安装
使用 npm 包管理器安装 wx-payment:
npm install wx-payment --save
API
wx-payment 提供了以下主要的 API:
init(options)
: 初始化支付配置,参数说明如下:appid
: 服务号应用唯一标识符。mch_id
: 商户号。key
: 商户支付密钥。pfx
: 微信支付证书。
unifiedOrder(params)
: 统一下单接口,参数说明如下:body
: 商品描述。out_trade_no
: 商户订单号。total_fee
: 订单总金额,单位为分。spbill_create_ip
: 用户端实际ip地址。notify_url
: 支付结果通知地址。trade_type
: 交易类型。openid
: 用户标识。
queryOrder(params)
: 查询订单接口,参数说明如下:out_trade_no
: 商户订单号。
refund(params)
: 申请退款接口,参数说明如下:out_trade_no
: 商户订单号。out_refund_no
: 商户退款单号。total_fee
: 订单总金额,单位为分。refund_fee
: 退款金额,单位为分。
queryRefund(params)
: 查询退款接口,参数说明如下:out_trade_no
: 商户订单号或微信交易号。out_refund_no
: 商户退款单号。refund_id
: 微信退款单号。transaction_id
: 微信订单号。
使用
在使用 wx-payment 之前,我们需要先配置支付信息和证书。首先创建一个配置文件 config.js,内容如下:
module.exports = { appid: 'your_appid', mch_id: 'your_mch_id', key: 'your_key', pfx: require('fs').readFileSync('path/to/your_cert.p12') };
然后在代码中引入 wx-payment 和配置文件:
const wxpay = require('wx-payment'); const config = require('./config.js');
在使用 wx-payment 各个 API 之前,我们需要调用 init
方法进行初始化:
wxpay.init(config);
统一下单
-- -------------------- ---- ------- -------------------- ----- ------- ------------- -------- ---------- ---- ----------------- -------------- ----------- ----------------------------------- ----------- -------- ------- ---------- -- -------- ----- ------- - -- ----- - -- ---- - ---- - -- -------- --------- --- -------------------- - ---
查询订单
-- -------------------- ---- ------- ------------------ ------------- ------- -- -------- ----- ------- - -- ----- - -- ---- - ---- - -- --------------- -------------------- - ---
申请退款
-- -------------------- ---- ------- -------------- ------------- -------- -------------- --------- ---------- ---- ----------- --- -- -------- ----- ------- - -- ----- - -- ---- - ---- - -- -------------- -------------------- - ---
查询退款
-- -------------------- ---- ------- ------------------- ------------- -------- -------------- -------- -- -------- ----- ------- - -- ----- - -- ---- - ---- - -- -------------- -------------------- - ---
总结
本文介绍了 npm 包 wx-payment 的使用方法,包括支付配置、API 的调用以及相应返回的数据等内容。wx-payment 封装了微信支付 API,能够更加方便快捷地完成支付功能的开发。希望本文能够帮助读者更好地了解和运用 wx-payment。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600671158dd3466f61ffe64d