開発環境を設定する
Stripe CLI とサーバー側 SDK についての理解を深めましょう。
Stripe のサーバー側 SDK およびコマンドラインインターフェイス (CLI) を使用することで、Stripe の REST API とやり取りできます。Stripe CLI で API を呼び出し、開発環境を効率化しましょう。
SDK を使用して、定型コードを記述しないようにします。環境からのリクエストの送信を開始するには、クイックスタートガイドにならって使用できる言語を選択します。
Chrome 拡張機能
このクイックスタートでは、Stripe CLI (Stripe 統合へのコマンドラインアクセスを可能にする重要なツール) をインストールします。また、Stripe Node.js サーバーサイド SDK を使用して、Node.js で記述されたアプリケーションから Stripe API にアクセスします。
学習内容
このクイックスタートでは以下について説明します。
- コードを記述することなく Stripe API を呼び出す方法
- npm または yarn パッケージマネージャーを使用してサードパーティーの依存関係を管理する方法
- 最新の Stripe Node SDK v18.0.0 をインストールする方法
- 最初の SDK リクエストを送信する方法
初期セットアップ
まず、Stripe アカウントを作成するかサインインします。
Stripe CLI を設定する
インストール
コマンドラインから、インストールスクリプトを使用するか、オペレーティングシステムのバージョン管理されたアーカイブファイルをダウンロードして展開し、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"
Node.js のサーバー側 SDK をインストールする
最新バージョンの Stripe Node.js サーバー側 SDK は、v18.0.0 です。Node.js バージョン 12 以降をサポートします。
Node バージョンを確認する
node --version
Node を初期化する
npm init
ライブラリをインストールする
ライブラリのインストールには、Node のパッケージマネージャーである npm を使用します。
npm install stripe --save
npm を使用してライブラリをインストールすると、ライブラリはプロジェクトの 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": "^18.0.0" } }
インストールの代替手段
Yarn: Node のもう 1 つのパッケージマネージャーである yarn を使用してライブラリをインストールできます。
yarn add stripe
最初の SDK リクエストを実行する
これで、Node.js SDK がインストールされ、サブスクリプションの Product (商品) を作成し、いくつかの API リクエストに Price (価格) を関連付けられるようになりました。Node.js SDK は、チェーン可能なコールバックとして使用できる promise を返します。説明のため、この例では Product のレスポンスで返された商品 ID を渡して Price を作成します。
const stripe = require('stripe')('sk_test_BQokikJOvBiI2HlWgH4olfQ2'); 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_
という名前で保存します。コマンドラインから、保存したファイルが含まれるディレクトリーに cd
で移動し、以下のコマンドを実行します。
node create_price.js
すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。実装を構築する際に使用できるように、これらの ID を保存します。
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb