What Changed
これまで、サブスクリプションは作成日に顧客へ課金されていました。今回の変更により、POST /subscriptions で固定の課金日を設定する任意パラメータを2つ指定できるようになりました。
payment_cycle: 課金日を指定します。anchor_date（YYYY-MM-DD）を渡すか、月次ならday_of_month（1〜31）、週次ならday_of_week（1が月曜日、7が日曜日）、年次ならmonthとday_of_monthを使います。timezoneにはAsia/TokyoなどのIANA識別子を指定します。省略した場合は、加盟店のデフォルトのタイムゾーンが適用されます。proration_logic: 初回サイクルの課金方法を指定します。prorataでは、課金日までの日数分の日割り金額を即時に課金し、課金日以降は全額を課金します。noneでは、加入時には課金せず、課金日に全額を課金します。課金日までは、サブスクリプションがawaitingステータスのままになります。なお、payment_cycleを指定してproration_logicを省略した場合は、noneが使われます。
課金日が当日または過去の日付であれば、全額が即時に課金されます。課金は、該当するタイムゾーンの9:00に実行されます。
また、サブスクリプションオブジェクトで started_at、proration_logic、payment_cycle も返されるようになりました。status フィールドには、新たに awaiting が返される場合があります。
Developer Impact
既存のサブスクリプションや、payment_cycle を含まないリクエストはこれまでどおり動作します。毎月1日など、すべての加入者に同じ日に課金したい場合は、新規サブスクリプションのリクエストに payment_cycle を追加します。サブスクリプションのステータスを参照している場合は、新しい awaiting ステータスに対応してください。