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

除非适用法律要求或书面同意，否则根据许可证分发的软件均按“原样”分发，不带任何明示或暗示的保证或条件。请参阅许可证，了解许可证下管理权限和限制的特定语言。