设置开发环境
按语言快速启动
Stripe 的服务器端助手库(又名服务器端 SDK)和命令行接口 (CLI) 可以让您轻松与 Stripe 的 REST API 进行交互。从 Stripe CLI 开始,无需编写任何代码即可调用 Stripe API。使用 SDK 可以避免编写样板代码。要开始从您的环境发送请求,请选择一种语言,按照其快速入门指南进行。
在本快速指南中,您安装 Stripe CLI——这是一个必不可少的工具,可让您通过命令行访问您的 Stripe 集成。您还安装了 Stripe Ruby 服务器端 SDK,以便从用 Ruby 编写的应用程序访问 Stripe API。
所学内容
本快速指南中,您将学会如何:
- 如何在不编写代码的情况下调用 Stripe API
- 如何用 RubyGems 的 Bundler 管理第三方依赖
- 如何安装最新的 Stripe Ruby SDK v11.0.0
- 如何发送第一个 SDK 请求
设置 Stripe CLI
首先,创建 Stripe 账户或登录。
安装
在命令行中,使用一个安装脚本或为您的操作系统下载并提取一个有版本号的归档文件,完成 CLI 的安装。
身份验证
登录并验证您的 Stripe 用户账户,以生成一组_受限的密钥_。要了解更多,请查看 Stripe CLI 密钥和权限。
stripe login
在您的键盘上按 Enter 键,在浏览器中完成验证过程。
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 已安装完毕,您可以向创建产品发出一个 API 请求。
stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI"
在响应对象中查找产品标识符( id
中)。保存它以备下一步使用。
如果一切正常,命令行将显示以下响应。
{ "id":
, "object": "product","prod_LTenIrmp8Q67sa"
接下来,调用创建价格,附加一个 30 美元的价格。将 product
中的占位符替换为您的产品标识符(例如,prod_LTenIrmp8Q67sa
)。
stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product=
{{PRODUCT_ID}}
如果一切正常,命令行将显示以下响应。
{ "id":
, "object": "price","price_1KzlAMJJDeE9fu01WMJJr79o"
管理第三方依赖
建议用 RubyGems 命令行工具管理第三方依赖项,该工具允许您添加新的库并将其包含在您的 Ruby 项目中。检查是否已安装 RubyGems:
安装 RubyGems
gem --version
如果您收到 gem: command not found
,请从他们的下载页面下载 RubyGems。
安装 Ruby 服务器端 SDK
Stripe Ruby 服务器端 SDK 的最新版本是 v11.0.0。它支持 2.3+ 版 Ruby。
检查您的 Ruby 版本:
ruby -v
安装库
创建 gem 文件,然后用 RubyGems 安装生成的 gem。
将最新版 Stripe gem 添加到项目:
bundle add stripe
从您指定的来源安装所需的 gem:
bundle install
备选安装方式
运行您的第一个 SDK 请求
您现在已安装 Ruby SDK,可以通过几个 API 请求创建一个订阅 Product 并附加一个 Price。在该例中,我们创建价格时使用的是响应中返回的产品标识符。
require 'rubygems' require 'stripe' Stripe.api_key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc" 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` 到包含您刚刚保存的文件的目录,然后运行:
ruby create_price.rb
如果一切正常,命令行会显示以下响应。保存这些标识符,以便在构建集成时使用。
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb