Stripe日記#03 番外編:アプデには気をつけて〜Upcoming Invoice API廃止〜

time 2025/05/15

はいどうもT山です〜
Stripe回の3回目は、Payment Links、Checkoutとかを実際に使ってみて…と思ってたんですが、
先日Stripeさんにアップデートが入りまして、それでちょっとバタバタしたのでそのことを書いていきたいと思います。
なので今回は番外編ですね。記憶が若いうちに書き残しておこうかなと思った次第です〜。

Contents

Upcoming Invoice APIが使えなくなる

アップデートの内容としては、既存のAPIが使えなくなる、というものです。
具体的にはUpcoming Invoice APIというもので、支払い予定の請求情報を取得できるAPIです。
いつ何にいくら支払う予定なのかわかるので、サブスクとかの定期支払い時に力を発揮してくれそうです。
Stripeはクーポン機能もあるので、そのクーポン使った上でいくら払うの？みたいなのもわかります。よく見かけるスマホ入会で動画配信サブスク◯ヶ月無料、とかもできそうですね。

それが使えなくなるとのこと。こちらで公式から発表されてました。
https://docs.stripe.com/changelog/basil/2025-03-31/invoice-preview-api-deprecations?locale=ja-JP
うん…ほんとこの「使えなくなる」っていう文字列のインパクト、でかいですよね…なかなかにドラスティックで3度見しちゃいましたもん:(；ﾞﾟ’ωﾟ’):
アイキャッチ画像にもしてるんですが、破壊的変更ってところがほんともう怖い:(；ﾞﾟ’ωﾟ’):
結論としては別APIが用意されているのでそっちを使えば今までと同様のことはできるっぽいです。よがっだー！！！

代わりにCreate Preview Invoice APIを使えばOK

それがこちらです。Create Preview Invoice APIというものですね。
https://docs.stripe.com/api/invoices/create_preview
同等のパラメータなり機能が用意されてるらしいです。
ただぱっとみCreateってなってたんで、え？何かデータ作っちゃうの？って訝しんだのは内緒です。
実際に試してみて、Upcoming Invoice APIと同じようなデータ取得できたので、ひとまず私の場合は大丈夫そうでした。

まぁね…直せば今までと同じことできるならええのよ。こっちはサービス使わせてもらってる立場ですしね。
ただ、調査段階で試しに使ってみてこのAPIでいけるなーってなって、いざ実装するぜって時に使えないのはなかなかのパニックでした。
おい使えないじゃん！過去の自分、適当過ぎやしないか！？って自分を呪うとこでした(^^;;

アプデ内容をメール通知してくれるっぽい

いやぁこんなタイミングでぶち当たること早々なかったのでいい経験にはなりましたがね、冷や汗もんでした((((；ﾟДﾟ)))))))
ただこう、公式サイトで告知するだけでなく、メールで連絡するとかもして欲しかったなとか。AWSはそういうのあるんですけどね。
と思って探してみたらこちらの記事で紹介されていました。2021年の記事みたいですが。
https://remoneko.wp-kyoto.net/stripe-developer-digest/

んですが、これは結論ダメでした(;_;)
公式サイトのページ下部にあるメールアドレス入力フォームに登録すれば受け取れる、って書いてあったので行ってみたんですが、そのフォームが見当たらない！
というかどんだけスクロールしても”ページ下部”にたどり着けない！（何を言ってるかわからないと思うが…以下略）
なんじゃこりゃあ！どうやって作ってんだ！すげぇ！でも入力フォームどこやねん…？
気になってお時間ある方は是非訪問してみてくださいw

ん〜でも本当にないのかな？普通に考えてありそうだよな〜っと思ってググったところ…ありましたよ！
https://go.stripe.global/dev-digest

何事もまずやってみないと！てなわけで早速メールアドレス登録しました！
今のところ特にメール送られてきてはいないので、今後の通知に期待ですね！