開発環境を設定する
Stripe CLI とサーバー側 SDK についての理解を深めましょう。
Stripe のサーバー側 SDK およびコマンドラインインターフェイス (CLI) を使用することで、Stripe の REST API とやり取りできます。Stripe CLI で API を呼び出し、開発環境を効率化しましょう。
SDK を使用して、定型コードを記述しないようにします。環境からのリクエストの送信を開始するには、クイックスタートガイドにならって使用できる言語を選択します。
Chrome 拡張機能
このクイックスタートでは、Stripe システムへのコマンドラインアクセスを可能にするための必須ツールである、Stripe CLI をインストールします。Stripe .NET サーバー側 SDK をインストールして、C# で記述されたアプリケーションから Stripe API にアクセスすることもできます。
学習内容
このクイックスタートでは以下について説明します。
- コードを記述することなく Stripe API を呼び出す方法
- .NET Core CLI、NuGet CLI、またはパッケージマネージャーコンソールを使用してサードパーティーの依存関係を管理する方法
- 最新の Stripe .NET SDK v48.0.0 をインストールする方法
- 最初の SDK リクエストを送信する方法
初期セットアップ
まず、Stripe アカウントを作成するかサインインします。
Stripe CLI を設定する
インストール
コマンドラインから、インストールスクリプトを使用するか、オペレーティングシステムのバージョン管理されたアーカイブファイルをダウンロードして展開し、CLI をインストールします。
認証
Log in and authenticate your Stripe user Account to generate a set of restricted keys. To learn more, see Stripe CLI keys and permissions.
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"
.NET のサーバー側 SDK をインストールする
最新バージョンの Stripe .NET サーバー側 SDK は、v48.0.0 です。.NET Standard 2.0 以降、.NET Core 2.0 以降、.NET Framework 4.6.1 以降をサポートします。
ご利用の .NET SDK バージョンを確認します。
dotnet --list-sdks
ライブラリをインストールする
コマンドラインから新規プロジェクトを作成するには、.NET Core コマンドラインインターフェイス (CLI) を使用します。
dotnet new console
ライブラリをインストールするには、以下のコマンドを実行して、プロジェクトファイル (.
) にパッケージ参照を追加します。
dotnet add package Stripe.net
CLI を使用してライブラリをインストールすると、ライブラリはプロジェクトファイル (.
) に自動的に依存関係として追加されます。以下に例を示します。
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>net6.0</TargetFramework> <ImplicitUsings>enable</ImplicitUsings> <Nullable>enable</Nullable> </PropertyGroup> <ItemGroup> <PackageReference Include="Stripe.net" Version="48.0.0" /> </ItemGroup> </Project>
インストールの代替手段
最初の SDK リクエストを実行する
これで、.NET SDK がインストールされ、サブスクリプションの Product (商品) を作成し、いくつかの API リクエストに Price (価格) を関連付けられるようになりました。この例では、Product のレスポンスで返された商品 ID を使用して価格を作成しています。
using System; using Stripe; class Program { static void Main(string[] args) { StripeConfiguration.ApiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2"; var optionsProduct = new ProductCreateOptions { Name = "Starter Subscription", Description = "$12/Month subscription", }; var serviceProduct = new ProductService(); Product product = serviceProduct.Create(optionsProduct); Console.Write("Success! Here is your starter subscription product id: {0}\n", product.Id); var optionsPrice = new PriceCreateOptions { UnitAmount = 1200, Currency = "usd", Recurring = new PriceRecurringOptions { Interval = "month", }, Product = product.Id }; var servicePrice = new PriceService(); Price price = servicePrice.Create(optionsPrice); Console.Write("Success! Here is your starter subscription price id: {0}\n", price.Id); } }
コードをプロジェクトの Program.
ファイルに保存します。コマンドラインから、保存したファイルが含まれるディレクトリーに cd
で移動し、以下のコマンドを実行します。
dotnet run
すべて正常に機能する場合、コマンドラインに以下のレスポンスが表示されます。実装を構築する際に使用できるように、これらの ID を保存します。
Success! Here is your starter subscription product id: prod_0KxBDl589O8KAxCG1alJgiA6 Success! Here is your starter subscription price id: price_0KxBDm589O8KAxCGMgG7scjb