web payments quickstart

網路支付快速入門

使用 Square 網路支付 SDK 的快速入門

• 網路支付 SDK 概述。
• API 文件。

入門

首先克隆這個儲存庫。

git clone https://github.com/square/web-payments-quickstart
cd web-payments-quickstart

安裝 Node.js，其中將包含npm 。如果您使用nvm來管理節點版本，則此儲存庫包含一個.nvmrc檔案。

然後，要安裝依賴項，請執行：

npm install

運行開發伺服器。

npm run dev

最後，開啟http://localhost:3000。

證書

在接受付款之前，您需要設定開發人員憑證（可以在開發人員儀表板中找到）。

將.env.example複製到.env.sandbox

cp .env.example .env.sandbox

使用開發人員儀表板中的沙盒存取權杖定義SQUARE_ACCESS_TOKEN 。

 SQUARE_ACCESS_TOKEN =eX@mpl3_t0k3n

重新啟動伺服器以使用此新值。

請記住：不要將您的訪問令牌新增至 git！

發展

設定

為該專案做出貢獻時，您將需要使用.nvmrc定義的 Node 版本。您可以使用 nvm 安裝正確的版本：

nvm install $( cat .nvmrc )

按照上面的「入門」說明安裝相依性並驗證本機伺服器是否正常啟動。

測試

您可以使用npm test來執行所有 linter、測試和建置（如 CI）。

棉絨

您可以使用npm run lint來運行所有 linter。

ESLint

ESLint 分析程式碼以發現並修復問題。我們使用 eslint-plugin-square 進行開箱即用的配置。

npm run lint:eslint

自動修復警告和錯誤

ESLint 有時可以使用其 --fix 選項自動修復警告和錯誤。

npm run lint:eslint --fix

更漂亮

Prettier 是一個固執己見的程式碼格式化程式。我們使用 @square/prettier-config 來表達這些意見。

npm run lint:prettier

修復程式碼風格問題

如果在執行npm run lint:prettier後收到類似「在上述文件中發現程式碼樣式問題。忘記執行 Prettier？」之類的警告，您可以讓 Prettier 修復它們。

npm run lint:prettier:fix

持續集成

GitHub Actions 用於我們的 CI/CD 工作流程。有關詳細信息，請參閱.github/workflows 。

執照

版權所有 2021 Square, Inc.

根據 Apache 許可證 2.0 版（“許可證”）獲得許可；除非遵守許可證，否則您不得使用此文件。您可以在以下位置取得許可證副本：

http://www.apache.org/licenses/LICENSE-2.0

除非適用法律要求或書面同意，否則根據許可證分發的軟體均以「原樣」分發，不帶任何明示或暗示的保證或條件。請參閱許可證，了解許可證下管理權限和限制的特定語言。