npm 包 wx-payment 使用教程

阅读时长 5 分钟读完

在微信小程序或公众号开发中,实现支付功能需要使用微信支付 API,而 npm 包 wx-payment 提供了封装好的支付相关接口,使得我们能够更加方便快捷地完成支付功能的开发。本文将详细介绍 wx-payment 的使用方法,以帮助读者更好地了解和运用它。

安装

使用 npm 包管理器安装 wx-payment:

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,内容如下:

然后在代码中引入 wx-payment 和配置文件:

在使用 wx-payment 各个 API 之前,我们需要调用 init 方法进行初始化:

统一下单

-- -------------------- ---- -------
--------------------
  ----- -------
  ------------- --------
  ---------- ----
  ----------------- --------------
  ----------- -----------------------------------
  ----------- --------
  ------- ----------
-- -------- ----- ------- -
  -- ----- -
    -- ----
  - ---- -
    -- -------- --------- ---
    --------------------
  -
---

查询订单

-- -------------------- ---- -------
------------------
  ------------- -------
-- -------- ----- ------- -
  -- ----- -
    -- ----
  - ---- -
    -- ---------------
    --------------------
  -
---

申请退款

-- -------------------- ---- -------
--------------
  ------------- --------
  -------------- ---------
  ---------- ----
  ----------- ---
-- -------- ----- ------- -
  -- ----- -
    -- ----
  - ---- -
    -- --------------
    --------------------
  -
---

查询退款

-- -------------------- ---- -------
-------------------
  ------------- --------
  -------------- --------
-- -------- ----- ------- -
  -- ----- -
    -- ----
  - ---- -
    -- --------------
    --------------------
  -
---

总结

本文介绍了 npm 包 wx-payment 的使用方法,包括支付配置、API 的调用以及相应返回的数据等内容。wx-payment 封装了微信支付 API,能够更加方便快捷地完成支付功能的开发。希望本文能够帮助读者更好地了解和运用 wx-payment。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600671158dd3466f61ffe64d

纠错
反馈