最上位の価格フィールドを、Invoice Item と Invoice Line Item の価格モデルに置き換えます。互換性に関わる変更

新規情報

インボイスアイテムと請求書の項目に新しい多態性料金の概念が導入されます。この概念には、価格に関連するすべてのデータが含まれ、新しい料金体系オブジェクト タイプの追加に備えて料金体系オブジェクト(PriceとPlan)の構造が統合されます。また、単価データも料金体系に移行します。

この変更により互換性が失われる理由

• price フィールドと plan フィールドは、Invoice Item と Invoice Line Item では使用できなくなりました。
• unit_amount と unit_amount_decimal は、Invoice Item と Invoice Line Item の新しい pricing コンセプトに移行します。

影響

Invoice Item および Invoice Line Item の price と plan への参照を、すべて pricing フィールドに置き換えます。

• invoice_item.price.id ではなく、invoice_item.pricing.type が price_details であることを確認してから invoice_item.pricing.price_details.price を使用します。
• Invoice Item を作成または更新するときは、price の代わりに pricing パラメーターを使用します (たとえば、price パラメーターを渡す代わりに pricing.price を設定します)
• 単位額には、unit_amount または unit_amount_decimal ではなく pricing.unit_amount_decimal を使用します
• Invoice Item を作成または更新するときは、unit_amount ではなく unit_amount_decimal パラメーターを使用します

変更点

アップグレード