開発環境を設定する

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

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

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

Chrome 拡張機能

Stripe (Elements や Checkout など) を使用して、ご自身のウェブサイトで決済の実装を構築することをお勧めします。次に、Chrome 拡張機能を設定して、ユーザーが購入を完了する準備ができたら、この決済ページにユーザーを誘導します。

この方法は、拡張機能内で直接決済を処理しようとするよりも安全で保守が簡単です。

このクイックスタートでは、Stripe CLI (Stripe 統合へのコマンドラインアクセスを可能にする重要なツール) をインストールします。また、Stripe Java サーバーサイド SDK を使用して、Java で記述されたアプリケーションから Stripe API にアクセスします。

学習内容

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

コードを記述することなく Stripe API を呼び出す方法
Maven または Gradle を使用してサードパーティーの依存関係を管理する方法
最新の Stripe Java SDK v30.0.0 をインストールする方法
最初の SDK リクエストを送信する方法

初期セットアップ

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

Stripe CLI を設定する

インストール

コマンドラインから、インストールスクリプトを使用するか、オペレーティングシステムのバージョン管理されたアーカイブファイルをダウンロードして展開し、CLI をインストールします。

homebrew で Stripe CLI をインストールするには、以下を実行します。

Command Line
brew install stripe/stripe-cli/stripe

このコマンドを Linux バージョンの Homebrew で実行すると失敗しますが、代替手段を使用するか、Linux タブの指示に従ってこれを完了させることは可能です。

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",

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

サードパーティーの依存関係の管理には、Maven または Gradle を使用することをお勧めします。これらは、新規ライブラリを追加して、Java プロジェクトに含めるのに役立ちます。

プロジェクトを初期化する

Maven を使用してプロジェクトを作成する場合は、How do I make my first Maven project? (最初の Maven プロジェクトの作成方法) (英語) を参照してください。
Gradle でプロジェクトを作成する場合は、Building Java Applications Sample (Java アプリケーションの構築サンプル) (英語) を参照してください。

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

最新バージョンの Stripe Java サーバー側 SDK は、v30.0.0 です。Java バージョン 1.8 以降をサポートします。

Java バージョンを確認する:

Command Line

java -version

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

Maven を使用する場合は、プロジェクトの pom.xml ファイルに以下を配置します。

pom.xml
<dependency>
  <groupId>com.stripe</groupId>
  <artifactId>stripe-java</artifactId>
  <version>30.0.0</version>
</dependency>

Gradle を使用する場合は、build.gradle ファイルの dependencies ブロック内に次の行を貼り付けます。

build.gradle

implementation 'com.stripe:stripe-java:30.0.0'

インストールの代替手段

手動インストール: 次の JAR を使用して stripe-java を手動でインストールできます。Stripe JAR (.jar) をダウンロードします。

Google Gson 用の Gson JAR (.jar) をダウンロードします。

Proguard: ProGuard を使用している場合は、proguard.cfg ファイルに以下を追加して、ライブラリを除外するようにしてください。

proguard.cfg

-keep class com.stripe.** { *; }

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

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

Note

このサンプルでは、サンドボックス環境の Stripe ユーザーアカウントが使用するデフォルトキーを使用しています。お客様のみこの値を確認できます。

CreatePrice.java
package com.stripe.sample;

import com.stripe.Stripe;
import com.stripe.exception.StripeException;
import com.stripe.model.Product;
import com.stripe.param.ProductCreateParams;
import com.stripe.param.PriceCreateParams;
import com.stripe.model.Price;

public class Server {
    public static void main(String[] args) throws StripeException {
        Stripe.apiKey = "sk_test_BQokikJOvBiI2HlWgH4olfQ2";


        ProductCreateParams productParams =
            ProductCreateParams.builder()
                .setName("Starter Subscription")
                .setDescription("$12/Month subscription")
                .build();
        Product product = Product.create(productParams);
        System.out.println("Success! Here is your starter subscription product id: " + product.getId());

        PriceCreateParams params =
            PriceCreateParams
                .builder()
                .setProduct(product.getId())
                .setCurrency("usd")
                .setUnitAmount(1200L)
                .setRecurring(
                    PriceCreateParams.Recurring
                        .builder()
                        .setInterval(PriceCreateParams.Recurring.Interval.MONTH)
                        .build())
                .build();
        Price price = Price.create(params);
        System.out.println("Success! Here is your starter subscription price id: " + price.getId());
    }
}

ファイルを CreatePrice.java という名前で保存します。Maven または Gradle の IDE のプロジェクトから、サンプルを実行します。たとえば、Run 'CreatePrice.main()' のようにして実行します。

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

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

参照情報

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