前言
Mastercard Merchant Administration Web Services (MAWS) 是 Mastercard 的一项服务,旨在为商家及其伙伴提供一组服务,以管理支付卡商户。这项服务可以让用户以统一标准亚洲目的地为商户管理工具提供商务级别的数据可视化和报告、管理、结算和安全功能。npm 包 mastercard-maws 就是为了方便开发者使用 MAWS 服务而开发的一款 npm 包。在本文中,我们将分享如何使用 mastercard-maws 包,并介绍其功能和实现。
基本概念
在使用 npm 包 mastercard-maws 之前,需要了解一些基本概念:
Merchant ID
商家 ID 是每个商家特有的标识符。商家 ID 可以通过 Mastercard 的 MAWS UI 或者 API 获取到。
API Key 和 Shared Secret
用于身份验证和签名请求。可以在 Mastercard 的 MAWS UI 中生成。在使用 npm 包 mastercard-maws 时,需要将 API Key 和 Shared Secret 传递给 mastercard-maws 包。
签名
由 Shared Secret 和一组参数生成的密文,用于验证请求接口的合法性。
响应
MAWS 服务返回的结果,根据不同的接口,响应中的格式和数据结构也不同,但都是使用 XML 格式返回。在 mastercard-maws 中,我们将使用 xml2js 模块对响应进行解析和转换。
安装和配置 mastercard-maws
- 安装 npm 包:
npm install mastercard-maws
- 导入 npm 包
const MasterCardMAWS = require('mastercard-maws');
- 配置 API Key, Shared Secret, 和 Merchant ID
const options = { apiKey: '<your-api-key>', apiSecret: '<your-api-secret>', merchantId: '<your-merchant-id>', testMode: true, // 测试模式开启 version: '1.0', // 选择MAWS API版本 };
mastercard-maws 的使用示例
在本节中,我们将介绍如何使用 mastercard-maws 包的几个常见接口。
获取商户信息
-- -------------------- ---- ------- ----- ----------- - ------------------------------------ ------------------------- ----------- -- - ----------------- -- ------------ -- - ------------------- ---展开代码
获取接口使用限制信息
-- -------------------- ---- ------- ----- ---------- - ----------------------------------- --------------------- ----------------- -- - ----------------------- -- ------------ -- - ------------------- ---展开代码
获取未清算事务的列表
-- -------------------- ---- ------- ----- --------------------- - ---------------------------------------------- --------------------------------------- ---------------- ------ -- ----------------------- -- - ----------------------------- -- ------------ -- - ------------------- ---展开代码
发送退款请求
-- -------------------- ---- ------- ----- --------------------- - ---------------------------------------------- ----- ------------- - - -------------- -------------- ------- ----- ------- ----- -------- ------------- ---- --------- --------- -- ------------------------------------------------------ ---------------------- -- - ---------------------------- -- ------------ -- - ------------------- ---展开代码
结语
本文介绍了如何使用 npm 包 mastercard-maws 来调用 Mastercard Merchant Administration Web Services (MAWS) 服务。通过合理地选择和使用各种接口,我们可以轻松地管理和跟踪商户交易。望本文能够帮助读者更好地实现商户管理和数据报告。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600566dd81e8991b448e32f2