開発環境を設定する
Stripe CLI と主要な SDK について理解しましょう。
Stripe’s server-side SDKs and command-line interface (CLI) allow you to interact with Stripe’s REST APIs. Start with the Stripe CLI to streamline your development environment and make API calls.
SDK を使用して、定型コードを記述しないようにします。環境からのリクエストの送信を開始するには、クイックスタートガイドにならって使用できる言語を選択します。
このクイックスタートでは、Stripe システムへのコマンドラインアクセスを可能にするための必須ツールである、Stripe CLI をインストールします。Stripe Ruby サーバー側 SDK をインストールして、Ruby で記述されたアプリケーションから Stripe API にアクセスすることもできます。
学習内容![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
このクイックスタートでは以下について説明します。
- コードを記述することなく Stripe API を呼び出す方法
- RubyGems で bundler を使用してサードパーティーの依存関係を管理する方法
- 最新の Stripe Ruby SDK v12.0.0 をインストールする方法
- 最初の SDK リクエストを送信する方法
Stripe CLI を設定する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
まず、Stripe アカウントを作成するかサインインします。
インストール![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
コマンドラインから、インストールスクリプトを使用するか、オペレーティングシステムのバージョン管理されたアーカイブファイルをダウンロードして展開し、CLI をインストールします。
認証![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
ログインして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)
設定を確定![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
CLI のインストールが完了し、Create a product (商品作成) API への単一の API リクエストを作成できるようになりました。
stripe products create \ --name="My First Product" \ --description="Created with the Stripe CLI"
レスポンスオブジェクトの id
内で商品 ID を探し、次のステップのために保存しておきます。
すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。
{ "id":
, "object": "product","prod_LTenIrmp8Q67sa"
次に、Create a price (価格作成) API を呼び出して、30 USD の価格を関連付けます。product
のプレースホルダーを商品 ID (例: prod_
) に入れ替えます。
stripe prices create \ --unit-amount=3000 \ --currency=usd \ --product=
{{PRODUCT_ID}}
すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。
{ "id":
, "object": "price","price_1KzlAMJJDeE9fu01WMJJr79o"
サードパーティーの依存関係を管理する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
サードパーティーの依存関係の管理には、RubyGems コマンドラインツールを使用することをお勧めします。RubyGems を使用すると、新規ライブラリを追加し、Ruby プロジェクトに含めることができます。以下のコマンドを実行して、RubyGems がインストールされているかどうかを確認してください。
RubyGems をインストールする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
gem --version
gem: command not found
と返される場合は、ダウンロードページから RubyGems をダウンロードしてください。
Ruby のサーバー側 SDK をインストールする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
最新バージョンの Stripe Ruby サーバー側 SDK は、v12.0.0 です。Ruby バージョン 2.3 以降をサポートします。
Ruby バージョンを確認する
ruby -v
ライブラリをインストールする![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
gem ファイルを作成し、RubyGems で bundler を使用して、生成された gem をインストールします。
最新バージョンの Stripe gem をプロジェクトに追加します。
bundle add stripe
必要な gem を指定されたソースからインストールします。
bundle install
インストールの代替手段![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
最初の SDK リクエストを実行する![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
これで、Ruby SDK がインストールされ、サブスクリプションの Product (商品) を作成し、いくつかの API リクエストに Price (価格) を関連付けられるようになりました。この例では、Product のレスポンスで返された商品 ID を使用して価格を作成しています。
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_
という名前で保存します。コマンドラインから、保存したファイルが含まれるディレクトリーに cd
で移動し、以下のコマンドを実行します。
ruby create_price.rb
すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。実装を構築する際に使用できるように、これらの ID を保存します。
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb