npm 包 moip-sdk 使用教程

阅读时长 7 分钟读完

前言

随着电子商务行业的飞速发展,支付服务也变得越来越重要。Moip是一家来自巴西的电子支付服务提供商,提供了不同的支付方式,如信用卡、信用卡分期、银行转账、在线转账等等。Moip提供了REST API和SDK,你可以使用它们来集成Moip支付服务。

本文将介绍如何使用npm包moip-sdk来调用Moip API,包括安装、初始化和实际使用。

安装

使用npm包管理器安装moip-sdk:

上述命令会将moip-sdk安装到你的项目中,并将其添加到DevDependencies中。

初始化

在你的项目中,你需要提供你的鉴权数据。你可以使用Moip Sandbox环境进行测试。下面是一个示例初始化脚本:

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

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

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

上述代码将引入moip-sdk,设置鉴权数据,初始化客户端并使用Sandbox环境。

实际使用

现在我们已经完成了初始化,让我们看一下如何使用实际API。我们将使用API来注册一个新客户和创建一个订单。

注册一个新客户

为了注册一个新的客户,你需要使用moip.Customer.create()方法,并传递客户数据。下面是一个示例:

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

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

上述代码将创建一个名为John Doe的客户。在创建客户时,你需要传递客户数据。客户数据是一个包含客户个人信息和地址信息的对象。客户地址是一个必填字段,你需要提供至少一个地址。

创建一个订单

订单是Moip支付服务中的核心部分。有了一个客户,你可以创建一个订单并将其分配给该客户。在创建订单时,你需要指定金额、货币、支付方式和其它相关信息。下面是一个示例:

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

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

上述代码将创建一个Moip订单。你需要为订单指定金额、货币、支付方式和其它信息。订单金额是一个必填项,你需要提供至少一个项目(包括其详细信息和价格)。支付方式是另一个必填字段。你可以选择使用CREDIT_CARD、BOLETO或ONLINE_BANK_TRANSFER支付方式。

结论

通过moip-sdk,你可以方便地使用Moip支付服务。在本文中,我们介绍了如何使用npm包moip-sdk,并演示了如何注册新客户和创建订单。希望这篇文章对你有所帮助。

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

纠错
反馈