设置您的开发环境

熟悉 Stripe CLI 和我们的服务器端 SDK。

复制页面

您可以通过 Stripe 的服务器端 SDK 和命令行接口 (CLI) 与 Stripe 的 REST API 进行交互。从 Stripe CLI 开始，简化您的开发环境并进行 API 调用。

使用 SDK 可以避免编写样板代码。要开始从您的环境发送请求，请选择一种语言，按照其快速入门指南进行。

Chrome 扩展程序

建议您在自己的网站上构建与 Stripe 的支付集成（例如 Elements 或 Checkout）。然后，设置您的 Chrome 扩展程序，在用户准备好完成购买时使他们转至此支付页面。

这种方法比尝试直接在扩展中处理付款更安全、更易于维护。

在本快速指南中，您将安装 Stripe CLI— 这是一种重要工具，可让您通过命令行访问 Stripe 集成。您还需要安装 Stripe Node.js 服务器端 SDK，以从用 Node.js 编写的应用程序访问 Stripe API。

所学内容

本快速指南中，您将学会如何：

如何在不编写代码的情况下调用 Stripe API
如何用 npm 或 yarn 包管理工具管理第三方依赖
如何安装最新的 Stripe Node SDK v18.0.0
如何发送第一个 SDK 请求

初始设置

首先，创建 Stripe 账户或登录。

设置 Stripe CLI

安装

在命令行中，使用一个安装脚本或为您的操作系统下载并提取一个有版本号的归档文件，完成 CLI 的安装。

要用 homebrew 安装 Stripe CLI，请运行：

Command Line
brew install stripe/stripe-cli/stripe

如果您在 Linux 版本的 homebrew 上运行该命令，则此命令将失败，但您可以使用此替代方法或按照 Linux 选项卡上的说明进行操作。

Command Line
brew install stripe-cli

验证身份

登录并验证您的 Stripe 用户账户，以生成一组_受限密钥_。要了解更多，请查看 Stripe CLI 密钥和权限。

Command Line

stripe login

在您的键盘上按 Enter 键，在浏览器中完成验证过程。

Output
Your pairing code is: enjoy-enough-outwit-win
This pairing code verifies your authentication with Stripe.
Press Enter to open the browser or visit https://dashboard.stripe.com/stripecli/confirm_auth?t=THQdJfL3x12udFkNorJL8OF1iFlN8Az1 (^C to quit)

确认设置

现在，CLI 已安装完毕，您可以向 Create a product 发出一个 API 请求。

Command Line
stripe products create \
--name="My First Product" \
--description="Created with the Stripe CLI"

在响应对象中查找产品标识符（ id 中）。保存它以备下一步使用。

如果一切正常，命令行将显示以下响应。

{
  "id": "prod_LTenIrmp8Q67sa"
,
  "object": "product",

接下来，调用 Create a price，附加一个 30 美元的价格。将 product 中的占位符替换为您的产品标识符（例如，prod_LTenIrmp8Q67sa）。

Command Line
stripe prices create \
  --unit-amount=3000 \
  --currency=usd \
  --product={{PRODUCT_ID}}

如果一切正常，命令行将显示以下响应。

{
  "id": "price_1KzlAMJJDeE9fu01WMJJr79o"
,
  "object": "price",

安装 Node.js 服务器端 SDK

Stripe Node.js 服务器端 SDK 的最新版本是 v18.0.0。它支持 12+ 版 Node.js。

检查您的 Node 版本：

Command Line

node --version

初始化 Node

Command Line

npm init

安装库

从 npm 安装库，这是一个 Node 软件包管理工具：

Command Line
npm install stripe --save

用 npm 安装库后，该库将作为依赖项自动添加到您的项目的 package.json 文件中。例如：

package.json
{
  "name": "stripe-node-example",
  "version": "1.0.0",
  "description": "A Stripe demo",
  "main": "index.js",
  "scripts": {
    "node ": "node create_price.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "stripe": "^18.0.0"
  }
}

备选安装方式

运行您的第一个 SDK 请求

现在您已安装 Node.js SDK，可以通过几个 API 请求创建订阅产品并附加价格。Node.js SDK 返回承诺，可以用作可链式回调。为了演示，在此示例中我们传递产品响应中返回的产品标识符来创建价格。

注意

该示例为您的沙盒环境使用的是您的 Stripe 用户账户的默认密钥。只有您可以看到这些值。

create_price.js
const stripe = require('stripe')('sk_test_BQokikJOvBiI2HlWgH4olfQ2');

stripe.products.create({
  name: 'Starter Subscription',
  description: '$12/Month subscription',
}).then(product => {
  stripe.prices.create({
    unit_amount: 1200,
    currency: 'usd',
    recurring: {
      interval: 'month',
    },
    product: product.id,
  }).then(price => {
    console.log('Success! Here is your starter subscription product id: ' + product.id);
    console.log('Success! Here is your starter subscription price id: ' + price.id);
  });
});

将文件另存为 create_price.js。从命令行，cd 到包含您刚刚保存的文件的目录，然后运行：

Command Line

node create_price.js

如果一切正常，命令行将显示以下响应。保存这些标识符，以便在构建集成时使用。

Command Line
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6
Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb

另见

快速入门到此结束。有关处理您刚创建的产品的付款的几种不同方式，请参阅下面的链接。