開発環境を設定する

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

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

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

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

学習内容

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

コードを記述することなく Stripe API を呼び出す方法
仮想環境と pip パッケージマネージャーを使用してサードパーティーの依存関係を管理する方法
最新の Stripe Python SDK v11.0.0 をインストールする方法
最初の SDK リクエストを送信する方法

初期セットアップ

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

Stripe CLI を設定する

インストール

コマンドラインから、インストールスクリプトを使用するか、オペレーティングシステムのバージョン管理されたアーカイブファイルをダウンロードして展開し、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",

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

サードパーティーの依存関係の管理には、venv モジュールを使用することをお勧めします。venv を使用すると、新規ライブラリを追加し、Python 3 プロジェクトに含めることができます。

Windows (cmd.exe) の場合:

Command Line
python3 -m venv env
.\env\Scripts\activate.bat

GNU/Linux または MacOS (bash) の場合:

Command Line
python3 -m venv env
source env/bin/activate

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

最新バージョンの Stripe Python サーバー側 SDK は、v11.0.0 です。Python バージョン 3.6 以降に対応します。

Python バージョンを確認する

Command Line

python3 --version

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

Python のパッケージマネージャーである PyPi からライブラリをインストールします。

Command Line
pip3 install --upgrade stripe

次に、requirements.txt ファイルに以下のバージョンを指定します。

requirements.txt

stripe>=11.0.0

インストールの代替手段

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

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

注

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

create_price.py
import 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(
  unit_amount=1200,
  currency="usd",
  recurring={"interval": "month"},
  product=starter_subscription['id'],
)

# Save these identifiers
print(f"Success! Here is your starter subscription product id: {starter_subscription.id}")
print(f"Success! Here is your starter subscription price id: {starter_subscription_price.id}")

ファイルを create_price.py という名前で保存します。コマンドラインから、保存したファイルが含まれるディレクトリーに cd で移動し、以下のコマンドを実行します。

Command Line

python3 create_price.py

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

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

参照情報

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