★★★ お知らせ ★★★

◆ Cassandra Dayに登壇 6/1(木) ◆
6月1日開催のイベント Cassandra Day - Tokyo に当社のエンジニアが登壇します！
今回「Cassandra適用のポイントと実案件での苦労話」と題して、RDBMSでは実現困難であった顧客要件をCassandraで簡単に実現できる実例を踏まえて、その適用のポイントをわかりやすく解説します。
⇒ イベント詳細はこちらから

◆ 6月のPS Liveは決済サービスStripeのデモ！◆
決済サービスのStripeでサブスクリプションの支払い機能を作ってみた
Stripeの機能の一部を切り出して、簡単なサブスクリプションを作るとどうなるのかを、デモをまじえてご紹介します。
⇒ 詳細はこちらから

◆【セミナー開催】可視化ツールGrafana～初めてのダッシュボード作成◆
デモンストレーション付き！
本セミナーでは、売上データを用いて、4種類のパネル作成方法をお見せします。
⇒ お申込みはこちらから

◆ エンジニア業務環境アンケート結果 ◆
エンジニアが自分の働き方にどういったことで満足していて、不満を感じているのか、働きたい会社像として何を求めているのか、業務環境調査を実施しました。ぜひご覧ください。
⇒ アンケート結果はこちらから

こんにちは、サイオステクノロジーの佐藤陽です。
今回はStripeで作成したサブスクリプションが持つ、商品の個数情報を更新する方法についてご紹介します。

1 はじめに
2 想定されるユースケース
3 結論
4 環境
5 検証
- 5.1 事前準備
- 5.2 更新処理
  - 5.2.1 Update Subscription API
    - 5.2.1.1 間違いパターン
    - 5.2.1.2 正しいパターン
6 まとめ

はじめに

StripeにはBillingと呼ばれるサービスが存在しており、サブスクリプションの仕組みを簡単に構築できます。

無料トライアルや、日割り計算など複雑な計算を担ってくれる頼もしいサービスですね。

今回はそんなサブスクリプションの内容を更新する方法についてご紹介します。
「そんなの簡単じゃないの？」って思われるかもしれないですが、少しはまってしまったので備忘録としてご紹介します。

想定されるユースケース

今回の実装がどういったユースケースの実現に役に立つかというと

例えば、

お菓子を毎月届けてくれるサブスクリプションサービス
各お菓子毎に価格が異なる
お菓子ごとに数量変更が可能

といった感じでしょうか。

このケースで、購入するお菓子の内容を変更したい！という場合の実装方法です。

結論

急いでる方向けに結論だけ言いますと

更新時にSubscription ItemのIdを指定して更新を行う

といった点がポイントです。

環境

今回の環境です

Postman
Stripe API(2022-08-01)

検証

事前準備

StripeのProductおよびPriceを3種類作成しておきます。

せっかくので先ほどの商品モデルを使いまわしましょう

価格や、請求サイクルなどは何でもOKです。

ポテチ 300円/月
キャンディ400/月
どら焼き 500/月

次にポテチとキャンディを含んだサブスクリプションを作成しておきます。

サブスクリプション
- ポテチ(×2)
- キャンディ(×1)

更新処理

事前準備したサブスクリプションの内容を以下のような形に変更したいと思います。

ポテチは数量変更
キャンディは除外
どら焼きは新規追加

といった感じですね。

※ここで各PriceIdや、SubscriptionIdはこの後利用するのでどこかに控えておいてください。

Update Subscription API

間違いパターン

さて、まず私が誤って行ったパターンを紹介します。
興味のない人は、この後の正解パターンをご確認ください。

商品情報を変更するので、Update Subscriptionのitems.priceのパラメータを使用します。

Postmanで実行するとこんな感じですね。

実行すると、400番エラーが返ってきてしまいました。

{
    "error": {
        "message": "Cannot add multiple subscription items with the same plan: price_{ポテチのpriceId}",
        "param": "plan",
        "request_log_url": "https://dashboard.stripe.com/test/logs/req_0R3OdGpBTXAjCE?t=1679275957",
        "type": "invalid_request_error"
    }
}

ポテチは既に登録されてるから登録できません。

といったニュアンスです。
数量変更ではなく、新規に2個を追加しようとしまっているようです。

ここでポイントなのが