npm包tappay-nodejs使用教程-JavaScript中文网-JavaScript教程资源分享门户

什么是tappay-nodejs?

tappay-nodejs是一款在Node.js环境下使用的TapPay SDK，它可以帮助我们更方便地在服务器端进行信用卡支付的处理。

安装tappay-nodejs

要使用tappay-nodejs，我们首先需要在我们的项目中安装它。可以通过以下命令在Node.js项目中安装tappay-nodejs：

npm install tappay-nodejs --save

其中， --save 选项表示将tappay-nodejs作为我们项目的依赖项进行保存。

引入tappay-nodejs

在我们的代码中，需要引入tappay-nodejs作为一个模块来使用。引入的代码如下：

const TapPay = require('tappay-nodejs');

使用tappay-nodejs

初始化

初始化tappay-nodejs实例时，需要传入以下几个参数：

PartnerKey：用于双向验证的PartnerKey
MerchantID：商店唯一識别代碼
HashKey：用于加密的HashKey

初始化tappay-nodejs实例的代码如下所示：

const tappay = new TapPay({
    PartnerKey: 'Your PartnerKey',
    MerchantID: 'Your MerchantID',
    HashKey: 'Your HashKey', 
});

API说明

tappay-nodejs提供了以下几个API：

getPrime：获取支付Prime
getRecords：查询订单记录
refund：全额退款

以下是每个API的详细说明：

getPrime

获取支付Prime，需要传入以下参数：

参数	类型	是否必须	说明
card	Object	必须	卡片信息
amount	Number	必须	交易金额
currency	String	必须	货币种类
orderNumber	String	必须	订单号

其中，card对象包含以下信息：

参数	类型	是否必须	说明
number	String	必须	卡号
dueDate	String	必须	到期日期，格式：MM/YY
ccv	String	必须	安全码

示例：

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

getRecords

查询订单记录，需要传入以下参数：

参数	类型	是否必须	说明
orderNumber	String	必须	订单号
merchantId	String	可选	商户ID，默认为实例初始化时传入的MerchantID
fields	String[]	可选	查询字段，默认为['id', 'order_number', 'description', 'status', 'amount', 'currency', 'created_at', 'updated_at']

示例：

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

refund

全额退款，需要传入以下参数：

参数	类型	是否必须	说明
recTradeId	String	必须	交易记录ID
recTradeDate	Number	必须	交易时间
refundAmount	Number	必须	退款金额
refundReason	String	必须	退款原因

示例：

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

总结

本篇文章主要介绍了npm包tappay-nodejs的使用教程，并提供了详细的API说明和示例代码。使用tappay-nodejs可以帮助我们更方便地在服务器端进行信用卡支付的处理。希望本篇文章能够对大家的学习和使用有所指导。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/60056ffe81e8991b448e7c77