開発環境を設定する

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

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

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

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

学習内容

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

コードを記述することなく Stripe API を呼び出す方法
npm または yarn パッケージマネージャーを使用してサードパーティーの依存関係を管理する方法
最新の Stripe Node SDK v17.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",

Node.js のサーバー側 SDK をインストールする

最新バージョンの Stripe Node.js サーバー側 SDK は、v17.0.0 です。Node.js バージョン 12 以降をサポートします。

Node バージョンを確認する

Command Line

node --version

Node を初期化する

Command Line

npm init

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

ライブラリのインストールには、Node のパッケージマネージャーである npm を使用します。

Command Line
npm install stripe --save

npm を使用してライブラリをインストールすると、ライブラリはプロジェクトの package.json ファイルに自動的に依存関係として追加されます。以下に例を示します。

package.json
{
  "name": "stripe-node-example",
  "version": "1.0.0",
  "description": "A Stripe demo",
  "main": "index.js",
  "scripts": {
    "node ": "node create_price.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "",
  "license": "ISC",
  "dependencies": {
    "stripe": "^17.0.0"
  }
}

インストールの代替手段

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

これで、Node.js SDK がインストールされ、サブスクリプションの Product (商品) を作成し、いくつかの API リクエストに Price (価格) を関連付けられるようになりました。Node.js SDK は、チェーン可能なコールバックとして使用できる promise を返します。説明のため、この例では Product のレスポンスで返された商品 ID を渡して Price を作成します。

注

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

create_price.js
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

stripe.products.create({
  name: 'Starter Subscription',
  description: '$12/Month subscription',
}).then(product => {
  stripe.prices.create({
    unit_amount: 1200,
    currency: 'usd',
    recurring: {
      interval: 'month',
    },
    product: product.id,
  }).then(price => {
    console.log('Success! Here is your starter subscription product id: ' + product.id);
    console.log('Success! Here is your starter subscription price id: ' + price.id);
  });
});

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

Command Line

node create_price.js

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

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

参照情報

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