開発環境を設定する

Stripe CLI とサーバー側 SDK についての理解を深めましょう。

Stripe のサーバー側 SDK およびコマンドラインインターフェイス (CLI) を使用することで、Stripe の REST API とやり取りできます。Stripe CLI で API を呼び出し、開発環境を効率化しましょう。

SDK を使用して、定型コードを記述しないようにします。環境からのリクエストの送信を開始するには、クイックスタートガイドにならって使用できる言語を選択します。

このクイックスタートでは、Stripe システムへのコマンドラインアクセスを可能にするための必須ツールである、Stripe CLI をインストールします。Stripe Ruby サーバー側 SDK をインストールして、Ruby で記述されたアプリケーションから Stripe API にアクセスすることもできます。

学習内容

このクイックスタートでは以下について説明します。

コードを記述することなく Stripe API を呼び出す方法
RubyGems で bundler を使用してサードパーティーの依存関係を管理する方法
最新の Stripe Ruby SDK v13.0.0 をインストールする方法
最初の SDK リクエストを送信する方法

Stripe CLI を設定する

まず、Stripe アカウントを作成するかサインインします。

インストール

コマンドラインから、インストールスクリプトを使用するか、オペレーティングシステムのバージョン管理されたアーカイブファイルをダウンロードして展開し、CLI をインストールします。

homebrew で Stripe CLI をインストールするには、以下を実行します。

Command Line
brew install stripe/stripe-cli/stripe

This command fails if you run it on the Linux version of homebrew, but you can use this alternative or follow the instructions on the Linux tab.

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 への単一の API リクエストを作成できるようになりました。

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

レスポンスオブジェクトの id 内で商品 ID を探し、次のステップのために保存しておきます。

すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。

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

次に、Create a price (価格作成) API を呼び出して、30 USD の価格を関連付けます。product のプレースホルダーを商品 ID (例: prod_LTenIrmp8Q67sa) に入れ替えます。

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

すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。

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

サードパーティーの依存関係を管理する

サードパーティーの依存関係の管理には、RubyGems コマンドラインツールを使用することをお勧めします。RubyGems を使用すると、新規ライブラリを追加し、Ruby プロジェクトに含めることができます。以下のコマンドを実行して、RubyGems がインストールされているかどうかを確認してください。

RubyGems をインストールする

Command Line

gem --version

gem: command not found と返される場合は、ダウンロードページから RubyGems をダウンロードしてください。

Ruby のサーバー側 SDK をインストールする

最新バージョンの Stripe Ruby サーバー側 SDK は、v13.0.0 です。Ruby バージョン 2.3 以降をサポートします。

Ruby バージョンを確認する

Command Line

ruby -v

ライブラリをインストールする

gem ファイルを作成し、RubyGems で bundler を使用して、生成された gem をインストールします。

最新バージョンの Stripe gem をプロジェクトに追加します。

Command Line
bundle add stripe

必要な gem を指定されたソースからインストールします。

Command Line

bundle install

インストールの代替手段

最初の SDK リクエストを実行する

これで、Ruby SDK がインストールされ、サブスクリプションの Product (商品) を作成し、いくつかの API リクエストに Price (価格) を関連付けられるようになりました。この例では、Product のレスポンスで返された商品 ID を使用して価格を作成しています。

注

このサンプルでは、Stripe ユーザーアカウントのテスト環境用のデフォルトキーを使用します。これらの値はご自身のみ表示できます。

create_price.rb
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 で移動し、以下のコマンドを実行します。

Command Line

ruby create_price.rb

すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。実装を構築する際に使用できるように、これらの ID を保存します。

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

参照情報

クイックスタートは以上です。以下のリンクでは、作成した商品の支払いを処理する方法をいくつか紹介しています。