设置您的开发环境

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

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

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

Chrome 扩展程序

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

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

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

所学内容

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

如何在不编写代码的情况下调用 Stripe API
如何用 RubyGems 的 Bundler 管理第三方依赖
如何安装最新的 Stripe Ruby SDK v15.0.0
如何发送第一个 SDK 请求

设置 Stripe CLI

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

安装

在命令行中，使用一个安装脚本或为您的操作系统下载并提取一个有版本号的归档文件，完成 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",

管理第三方依赖

建议用 RubyGems 命令行工具管理第三方依赖项，该工具允许您添加新的库并将其包含在您的 Ruby 项目中。检查是否已安装 RubyGems：

安装 RubyGems

Command Line

gem --version

如果您收到 gem: command not found，请从他们的下载页面下载 RubyGems。

安装 Ruby 服务器端 SDK

Stripe Ruby 服务器端 SDK 的最新版本是 v15.0.0。它支持 2.3+ 版 Ruby。

检查您的 Ruby 版本：

Command Line

ruby -v

安装库

创建 gem 文件，然后用 RubyGems 安装生成的 gem。

将最新版 Stripe gem 添加到项目：

Command Line
bundle add stripe

从您指定的来源安装所需的 gem：

Command Line

bundle install

备选安装方式

运行您的第一个 SDK 请求

您现在已安装 Ruby SDK，可以通过几个 API 请求创建订阅产品并附加价格。在此示例中，我们使用响应中返回的产品标识符来创建价格。

注意

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

create_price.rb
require 'rubygems'
require 'stripe'
Stripe.api_key = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"

starter_subscription = Stripe::Product.create(
  name: 'Starter Subscription',
  description: '$12/Month subscription',
)

starter_subscription_price = Stripe::Price.create(
  currency: 'usd',
  unit_amount: 1200,
  recurring: {interval: 'month'},
  product: starter_subscription['id'],
)

puts "Success! Here is your starter subscription product id: #{starter_subscription.id}"
puts "Success! Here is your starter subscription price id: #{starter_subscription_price.id}"

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

Command Line

ruby create_price.rb

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

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

另见

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