前言
在前端开发中，我们经常需要使用各种 npm 包来辅助我们完成各种功能。其中，worldpay-envoy 包是一个非常好用的工具，它帮助我们更加便捷地处理世界支付环境。
在本篇文章中，我们将会详细介绍 worldpay-envoy 包的使用方法，并提供示例代码以便读者更好地理解。
安装
在开始使用 worldpay-envoy 包之前，我们需要先安装它。在命令行中执行以下命令：
npm install --save worldpay-envoy
使用
引入
安装完成之后，我们可以在项目中引入 worldpay-envoy 包。在 JavaScript 文件中，可以使用以下语句进行引入：
const WorldpayEnvoy = require('worldpay-envoy');初始化
在使用 worldpay-envoy 包之前，我们需要进行初始化设置。通过设置不同的参数，我们可以使用不同的世界支付环境。在代码中，我们可以进行如下设置：
-- -------------------- ---- -------
----- ------- - -
---- -------
------- ------------------------------------
--------- -
----- ----------------
--------- -------------------
--
--------- -
--------- --------------------
--------- -------------------
-
--
----- ------------- - --- -----------------------其中，env 表示当前使用的环境，可以取值为test(测试环境)或prod(正式环境)。server 表示世界支付服务的地址。merchant 表示商户号和密码。passport 表示通行证用户名和密码。
需要注意的是，在使用世界支付服务之前，我们需要在世界支付网站上注册账号，并申请商户号。而为了使用测试服务，我们需要在世界支付测试网站上申请一个测试账号。
API
通过 worldpay-envoy 包，我们可以使用世界支付的各种 API。在这里，我们只取其中的几个比较有代表性的 API 进行介绍。
创建订单
-- -------------------- ---- -------
----- ------------ - -
------ --------
------ -
------------- ------
------- -----
--
--------- -
----- ----- -------
------ ----------------------
-
--
---------------------------------------
------------------- -- -
------------------ ---- ---- -------------------------- -----------
--
---------- -- -
--------------------- ----- ------- ------ ---------
---在创建订单之前，我们需要获得一个 token。token 凭证可以通过调用世界支付 Web SDK来生成。
查询订单
worldpayEnvoy.getOrder(`ORDER_CODE`)
.then(orderResponse => {
console.log(`Order with code ${orderResponse.orderCode} found.`);
})
.catch(err => {
console.error(`Get order failed. Error: ${err}`);
});取消订单
worldpayEnvoy.cancelOrder(`ORDER_CODE`)
.then(() => {
console.log(`Order with code ${orderCode} cancelled.`);
})
.catch(err => {
console.error(`Cancel order failed. Error: ${err}`);
});错误处理
除了以上介绍的 api 外，worldpay-envoy 还提供了丰富的错误处理机制，以便我们更加清晰地了解和处理错误。世界支付提供了各种错误码和错误信息，我们可以通过以下代码进行错误处理：
-- -------------------- ---- -------
---------------------------------------
------------------- -- -
------------------ ---- ---- -------------------------- -----------
--
---------- -- -
-- ---- ---------- --------------------------- -
--------------------- ----- ------ ---- ------- ------ ----- -------------- -------- --------------------
- ---- -- ---- ---------- --------------------------- -
--------------------- ----- ------ ---- ------- ------ ----- --------------- -------- --------------------
- ---- -
--------------------- ----- ------ ---- ------- ------ ------ ---------
-
---示例代码
在结束前，我们提供一份完整的示例代码，展示了如何使用 worldpay-envoy 包创建订单。代码中，我们先调用世界支付的 Web SDK 获取 token，然后通过这个 token 创建订单。
-- -------------------- ---- -------
----- ------------- - --------------------------
----- -------------- - ---------------------------
----- ------- - -
---- -------
------- ------------------------------------
--------- -
----- ----------------
--------- -------------------
--
--------- -
--------- --------------------
--------- -------------------
-
--
----- ------------- - --- -----------------------
---------------------------
---------- ------------
---
---------------------
--- --------------
--------------- -
---------- -------------------
-
---
----- ----------- - ---------------------------------------
---------------------------------------------------------------------------- -- -- -
------------------------------------- ------ -- -
-- ------- -
--------------------- ----- ------- ------ -----------
- ---- -
----- ------------ - -
------ ---------------
------ -
------------- ------
------- -----
--
--------- -
----- ----- -------
------ ----------------------
-
--
---------------------------------------
------------------- -- -
------------------ ---- ---- -------------------------- -----------
--
---------- -- -
-- ---- ---------- --------------------------- -
--------------------- ----- ------ ---- ------- ------ ----- -------------- -------- --------------------
- ---- -- ---- ---------- --------------------------- -
--------------------- ----- ------ ---- ------- ------ ----- --------------- -------- --------------------
- ---- -
--------------------- ----- ------ ---- ------- ------ ------ ---------
-
---
-
---
--总结
通过本篇文章的介绍，我们了解了如何使用 worldpay-envoy 包进行世界支付环境的处理，并学习了其中比较有代表性的 API。希望本文能够为前端开发者提供一些帮助和指导，让他们更好地完成自己的开发工作。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600671138dd3466f61ffe4e6