npm 包 braspag 使用教程

阅读时长 7 分钟读完

braspag 是一个基于 Node.js 的支付网关 API 。它提供了一个简单易用的 API ,让开发者可以轻松地与 Brasil Por Pagamentos S.A. 交互。

安装

braspag 可以通过 npm 安装:

使用

在您的文件中引入 braspag :

创建 API 实例

创建一个 braspag API 实例:

  • clientId (String): 给您分配的 API 客户端 ID
  • clientSecret (String): 给您分配的 API 客户端密钥
  • merchantId (String): 给您分配的商户 ID
  • environment (String): 指定 API 环境。可选值包括 braspag.ENVIRONMENT.SANDBOX 和 braspag.ENVIRONMENT.PRODUCTION。

创建 Token

在调用任何其他 API 方法之前,您需要获得一个访问令牌。以下是如何使用 getToken() 方法创建访问令牌:

创建支付订单

使用 createSale(data) 方法创建支付订单,data 是一个包含订单信息的对象:

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

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

createSale() 方法将返回订单数据。除非您的 Sale 不再是待定的,否则我们建议在您的系统中跟踪 Order Id 以进行后续查询。

查询支付订单

使用 getSale(orderId) 方法查询支付订单:

如果订单尚未被处理,您会收到一个 pending 状态。如果订单已经成功处理,您会收到表示订单状态的字符串。

取消支付订单

使用 cancelSale(orderId) 取消支付订单:

总结

braspag 是支付网关 API 的第一个版本。希望本文对你学习与使用 braspag 有所帮助。如需更多信息,请参见 braspag 文档

完整示例代码:

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

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

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

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

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

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

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

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

纠错
反馈