Stripeでは、ドキュメント内にシンプルな実装サンプルを言語・ライブラリ別に表示・ダウンロードできる「クイックスタート」を複数用意しています。
サンプルコードを解説付きで閲覧できるだけでなく、サンプルコードをまるごとダウンロードして、手元で動かすこともできます。
サンプルアプリの例
サンプルアプリは、複数のユースケースで公開されています。
1回きりの注文・決済のクイックスタート
ECサイトなど、1回きりの注文を処理するサンプルです。
Stripe.js / iOS SDK / Android SDKなどを利用した、埋め込み型決済フォーム（Elements）と、リダイレクト型決済（Checkout）の2種類が選べます。
サブスクリプション申し込みのクイックスタート
サブスクリプション申し込みについても、サンプルアプリが用意されています。
こちらは現時点（2022/10）ではリダイレクト型決済（Checkout）のサンプルのみです。
請求書業務の組み込みクイックスタート
kintoneやBubble、AWSなどで業務アプリを組み込みする場合の「請求書発行フロー」もサンプルが用意されています。
こちらはバックエンドのコードのみがDLできます。
Webhookのクイックスタート
Stripeの組み込み開発で重要度の高いWebhookですが、こちらもサンプルがDLできます。
Stripe CLIと組み合わせることで、ローカル環境で簡単にWebhookをテスト・開発できます。
クイックスタートで、サンプルアプリを起動する方法
ドキュメントサイトで、[クイックスタート]ページを見つけた場合、そのカテゴリ・製品についてのサンプルアプリをDLできます。
まずはクイックスタートページに移動しましょう。
クイックスタートページでは、「決済フォームの種類」「フロントエンドのフレームワーク」「バックエンドの言語」を選択できます。
言語やフレームワークを変更すると、右側のサンプルコードも変化します。
手元で試したい構成が決まれば、[アプリ全体をダウンロード]ボタンをクリックしましょう。
クリックすると、ZIPファイルでサンプルアプリがダウンロードできます。
VSCodeなどのIDEで開くと、README.mdにセットアップ方法が記載されています。
今回はバックエンドにPHPを選択しましたので、README.mdの指示に従ってライブラリインストールとサーバーの起動を行います。
% composer install
Loading composer repositories with package information
Info from https://repo.packagist.org: #StandWithUkraine
Updating dependencies
Lock file operations: 1 install, 0 updates, 0 removals
- Locking stripe/stripe-php (v8.12.0)
Writing lock file
Installing dependencies from lock file (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
- Downloading stripe/stripe-php (v8.12.0)
- Installing stripe/stripe-php (v8.12.0): Extracting archive
Generating autoload files
% php -S 127.0.0.1:4242 --docroot=public
[Fri Oct 7 19:03:51 2022] PHP 8.1.9 Development Server (http://127.0.0.1:4242) started
http://localhost:4242/checkout.htmlにアクセスすると、サンプルページが表示されました。
このように、最小限の構成ではありますが、簡単にStripeを組み込むサンプルアプリ・コードを手に入れることができます。
クイックスタートで、コード単位の解説も
クイックスタートを利用するメリットは、もう１つあります。
それは、ドキュメントサイト側でコードの細かい解説が読めることです。
ダッシュボードやAPIで事前に設定が必要な値も、ページ上で作成してしまうことができます。
クイックスタートで、Stripe組み込みの第一歩をはじめよう
Stripeのドキュメントサイトでは、このようにサンプルアプリとそのコード解説も見る・試すことができます。
「APIの種類が多くて、なにからはじめてよいか迷う」場合や、「今まで使ったことのないAPIを触る必要がでた」場合などに、ぜひこのクイックスタートをご活用ください。
[PR] Stripe開発者向け情報をQiitaにて配信中！
- [Stripe Updates]：開発者向けStripeアップデート紹介・解説
- ユースケース別のStripe製品や実装サンプルの紹介
- Stripeと外部サービス・OSSとの連携方法やTipsの紹介
- 初心者向けのチュートリアル(予定)
など、Stripeを利用してオンラインビジネスを始める方法について週に２〜３本ペースで更新中です。