npm 包 cardknox 使用教程

阅读时长 4 分钟读完

简介

cardknox 是一个用于处理信用卡付款的 Node.js 模块。它能够轻松地与信用卡支付处理器通信,支持各种付款流程和自定义选项。本文将详细介绍 cardknox 包的使用方法和相关技术。

安装

在安装之前,需要先安装 Node.js 环境。在命令行中运行以下命令来安装 cardknox 包:

基本使用

在你的应用程序中,你需要引入 cardknox 模块,然后创建一个 cardknox 对象。以下是一个基本的代码示例:

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

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

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

在这个代码示例中,我们创建了一个 config 对象,其中包含要连接到的 gateway URL、商家 ID、API 类型以及登录凭据。然后我们创建了一个 cardknox 对象,使用这个对象来设定付款和连接选项,以及调用 charge 方法完成付款操作。

cardknox 方法

cardknox 模块支持多种付款方法和付款流程。以下是一些 cardknox 对象提供的方法的简要介绍:

1. charge(data)

使用此方法可以向信用卡获取资金授权,或者进行一次处理付款操作。方法的参数应该为一个包含以下属性的对象:

  • xCommand (必需):付款命令:“cc:sale” 表示直接进行支付,而 “cc:auth” 表示获取资金授权。

  • xAmount (必需):付款数额,必须为浮点数字格式。

  • xCardNum (必需):信用卡号码,必须为字符串格式。

  • xExp (必需):信用卡过期日期,格式为 YYMM

  • xCVNum (必需):信用卡安全码,必须为字符串格式。

2. void(data)

使用此方法可以取消之前进行的已授权交易。方法的参数应该为一个包含以下属性的对象:

  • xCommand (必需):付款命令:“cc:void”。

  • xRefNum (必需):交易的 reference number(参考编号),必须为字符串格式。

3. refund(data)

使用此方法可以对之前成功的交易进行退款。方法的参数应该为一个包含以下属性的对象:

  • xCommand (必需):付款命令:“cc:credit”。

  • xAmount (必需):退款数额,必须为浮点数字格式。

  • xRefNum (必需):交易的 reference number(参考编号),必须为字符串格式。

4. capture(data)

使用此方法可以完成已经进行了授权的交易。授权可以在一段时间内保持资金的冻结状态,进行捕获操作才能真正转移到 merchan 拥有的账户中。方法的参数应该为一个包含以下属性的对象:

  • xCommand (必需):付款命令:“cc:capture”。

  • xAmount (必需):捕获数额,必须为浮点数字格式。

  • xRefNum (必需):交易的 reference number(参考编号),必须为字符串格式。

参考

我们介绍了 cardknox 模块的基本功能和调用方法。在实际使用过程中,你还可以进行自定义选项和其他操作。如果你想了解更多,请参考官方的 API 文档:https://kb.cardknox.com/api

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

纠错
反馈