開発環境を設定する
Stripe CLI とサーバー側 SDK についての理解を深めましょう。
Stripe のサーバー側 SDK およびコマンドラインインターフェイス (CLI) を使用することで、Stripe の REST API とやり取りできます。Stripe CLI で API を呼び出し、開発環境を効率化しましょう。
SDK を使用して、定型コードを記述しないようにします。環境からのリクエストの送信を開始するには、クイックスタートガイドにならって使用できる言語を選択します。
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 をインストールします。
認証
ログインして 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 のインストールが完了し、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"
サードパーティーの依存関係を管理する
サードパーティーの依存関係の管理には、RubyGems コマンドラインツールを使用することをお勧めします。RubyGems を使用すると、新規ライブラリを追加し、Ruby プロジェクトに含めることができます。以下のコマンドを実行して、RubyGems がインストールされているかどうかを確認してください。
RubyGems をインストールする
gem --version
gem: command not found
と返される場合は、ダウンロードページから RubyGems をダウンロードしてください。
Ruby のサーバー側 SDK をインストールする
最新バージョンの Stripe Ruby サーバー側 SDK は、v15.0.0 です。Ruby バージョン 2.3 以降をサポートします。
Ruby バージョンを確認する
ruby -v
ライブラリをインストールする
gem ファイルを作成し、RubyGems で bundler を使用して、生成された gem をインストールします。
最新バージョンの Stripe gem をプロジェクトに追加します。
bundle add stripe
必要な gem を指定されたソースからインストールします。
bundle install
インストールの代替手段
依存関係として追加: 最新バージョンのライブラリを gem 依存関係として追加します。
source 'https://rubygems.org' gem 'rails' gem 'stripe'
グローバルなインストール: RubyGems を使用してグローバルにライブラリをインストールします。
gem install stripe
手動インストール: ソースから gem を構築し、以下を実行してライブラリをインストールします。
gem build stripe.gemspec
最初の SDK リクエストを実行する
これで、Ruby SDK がインストールされ、サブスクリプションの Product (商品) を作成し、いくつかの API リクエストに Price (価格) を関連付けられるようになりました。この例では、Product のレスポンスで返された商品 ID を使用して価格を作成しています。
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_
という名前で保存します。コマンドラインから、保存したファイルが含まれるディレクトリーに 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