サブスクリプションとスケジュールで請求書アイテムのメタデータと期間のサポートを追加

新機能

We introduced a new way to customize the metadata and period fields for one-off invoice items generated by subscriptions and subscription schedules:.

• add_invoice_items の設定時に metadata を直接関連付けることができるため、後続の個別の API コールでこの情報を追加する必要がありません。

• デフォルトのサブスクリプション請求サイクルの日付を上書きするカスタム period.start と period.end の日付を指定できます。これにより、1 回限りの決済の収益認識期間を正確に制御できます。また、タイムスタンプインジケータ (サブスクリプションの場合は max_item_period_start と min_item_period_end、スケジュールの場合は phase_start と phase_end など) も含まれています。これにより、コンテキストに応じて、サブスクリプションの請求書期間やサブスクリプションスケジュールのフェーズの日付などの重要なタイムスタンプに日付を合わせることができます。

効果

次の API エンドポイントを使用して、add_invoice_items の metadata または period フィールドを指定します。

• サブスクリプションを作成または更新します。
• スケジュールを作成または更新します。
• schedule_detailsを指定して、プレビュー請求書を作成します。

変更点

アップグレード