Slide 1
Slide 1 text
Stripeでの増税対応
JP_Stripes Fukuoka #5 2019.10.16
@gorou_178
Slide 2
Slide 2 text
No content
Slide 3
Slide 3 text
穴井 怜
株式会社イノベーター・ジャパン
@gorou_178
PHPer/コーヒー/ランニング
3
Slide 4
Slide 4 text
話すこと
▪ 増税対応で行ったこと
▪ Stripeの税率管理
Slide 5
Slide 5 text
増税対応
おこなった方✋
5
Slide 6
Slide 6 text
どんなことを
行いましたか？
6
Slide 7
Slide 7 text
増税対応でやったこと
▪ 前提
▪ tenpuというサービス
▪ 定額の定期課金（月額・年額）
▪ 税率変更のバッチを作成して10月1日0時に実行
Slide 8
Slide 8 text
どれくらい
工数がかかったか
8
Slide 9
Slide 9 text
工数 2日
9
Slide 10
Slide 10 text
増税対応でやったこと（内訳）
▪ Stripeの仕様調査、事例調査（0.5日）
▪ APIの調査、影響範囲調査（0.5日）
▪ 実装[バッチ作成]（0.5日）
▪ テスト、リリース、深夜バッチの実行を見守る（0.5日）
Slide 11
Slide 11 text
増税の
対応内容について
11
Slide 12
Slide 12 text
Stripeの定期課金
12
Slide 13
Slide 13 text
商品と料金プランと
定期課金
商品（Product）が料金プラン（Plan）を持
ち、この商品で定期課金（ Subscription）
を作成する。
定期課金は顧客（Customer）に紐付く
13
Slide 14
Slide 14 text
税率（tax_rate）
▪ 「税率」を複数作ることが可能（率の
変更は不可）
▪ 税率IDが発行される（txr_xxxx）
▪ 定期課金（Subscription）などに税
率IDを紐つける
Slide 15
Slide 15 text
料金プランと定期課金と税率
$subscription = Subscription::create([
'customer' => 'cus_xxxxxxxx' ,
'plan' => 'plan_xxxx',
'default_tax_rates[0]' => 'txr_xxxxxx'
]);
Slide 16
Slide 16 text
バッチで行ったこと
▪ 全顧客の定期課金の税率IDの更新
Slide 17
Slide 17 text
バッチで行ったこと
$subscription = Subscription::retrieve('sub_xxxxx');
$newSubscription = Subscription::update($subscription ->id, [
'default_tax_rates[0]' => 'txr_xxxxxx'
]);
Slide 18
Slide 18 text
バッチ作成で工夫したこと
▪ dry-runオプション
▪ 処理件数・対象者情報の出力
▪ たくさんログを出す
▪ 決済が行われる時間の確認
Slide 19
Slide 19 text
バッチ作成で工夫したこと
▪ dry-runオプション
▪ 処理件数・対象者情報の出力
▪ たくさんログを出す
▪ 決済が行われる時間の確認
Slide 20
Slide 20 text
https://qiita.com/neeton_iwasaki/items/273037825b70ac4136da
Slide 21
Slide 21 text
定期課金と請求（Invoice）
▪ 定期課金の情報を元に請求情報を作成
▪ 請求情報を元に実際の決済を行う
▪ 定期課金の情報を書き換えてもすでに作成された請求情報は
変わらない
▪ 請求情報を書き換えても定期課金の情報は変わらない
Slide 22
Slide 22 text
請求はいつ作られる？
22
Slide 23
Slide 23 text
No content
Slide 24
Slide 24 text
この間の状態の利用者がいる場合
個別の対応が必要
Slide 25
Slide 25 text
その他の対応方法
▪ webhookで行う方法がある
▪ webhookとは、指定したURLにイベントが発生したらリクエスト
をしてくれる機能
▪ StripeのSupportサイトにて対応方法が記載されている
▪ https://support.stripe.com/questions/2019-10-1
Slide 26
Slide 26 text
No content
Slide 27
Slide 27 text
このイベントのwebhookで税率更新
Slide 28
Slide 28 text
webhook更新のメリット
▪ 事前にリリースできる
▪ 深夜対応の必要がない
Slide 29
Slide 29 text
webhook更新のデメリット
▪ 決済が行われる1週間前まで税率がそのまま（不安）
▪ 契約変更など個別対応があった場合のフローの考慮
Slide 30
Slide 30 text
まとめ
▪ Stripeの増税対応はとても簡単にできるようになっている
▪ 定額の定期課金の場合、税率は税率IDの差し替えのみ
▪ webhookをうまく利用すれば、深夜対応しなくてすむ
Slide 31
Slide 31 text
ありがとう
ございました
31