コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
AI に質問
アカウントを作成サインイン
導入方法
決済管理
売上管理
プラットフォームとマーケットプレイス
資金管理
開発者向けリソース
API & SDKヘルプ
概要
バージョン管理
変更ログ
    概要
    Clover
    Basil
    Acacia
    以前のバージョン
API バージョンのアップグレード
SDK バージョンをアップグレードする
Essentials
SDK
API
テスト
Stripe CLI
サンプルプロジェクト
ツール
Stripe ダッシュボード
ワークベンチ
開発者ダッシュボード
Stripe Shell
Visual Studio Code をご利用の場合
機能
ワークフロー
イベントの送信先
Stripe 健全性アラートファイルのアップロード
AI ソリューション
エージェントツールキット
モデルコンテキストプロトコルエージェントを使用した AI SaaS 請求ワークフローの構築
セキュリティとプライバシー
セキュリティ
Stripebot ウェブクローラー
プライバシー
Stripe を拡張する
Stripe Appsを構築する
Stripe アプリを使用する
パートナー
Partner Ecosystem
パートナー認定
アメリカ
日本語
ホーム開発者向けリソースChangelogBasil2025-03-31.basil

メモ

このページはまだ日本語ではご利用いただけません。より多くの言語で文書が閲覧できるように現在取り組んでいます。準備が整い次第、翻訳版を提供いたしますので、もう少しお待ちください。

最上位の税関連プロパティを、Invoice、Invoice Line Item、Credit Note Line Item の新しい税金モデルに置き換えます互換性に関わる変更

新規情報

請求書のライン項目と クレジットノートのライン項目に新しい 税金の概念が導入されます。この概念では、新しいタイプの税オブジェクトの追加に備えて、税データが含まれ、税オブジェクトの構造が統一されます。これにより、請求書の項目とクレジットノートのライン項目オブジェクトで最上位の税関連プロパティが置き換えられます。

また、請求書と クレジットノートのオブジェクトに、集約税情報用の新しい total_taxes プロパティが導入されています。

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

  • tax_rates と tax_amounts は、Invoice Line Item オブジェクトと Credit Note Line Item オブジェクトで使用できなくなりました。
  • total_tax_amounts は Invoice オブジェクトで使用できなくなりました。

影響

Invoice Line Item と Credit Note Line Item の税率 ID が新しい taxes プロパティに含まれるようになりました。

  • line_item.tax_rates[0] を line_item.taxes[0].tax_rate_details.tax_rate に置き換えます (line_item.taxes[0].type が tax_rate_details であることを確認した後)
  • line_item.tax_amounts[0].amount を line_item.taxes[0].amount に置き換えます

Invoice と Credit Note の税額合計が total_taxes に保存されるようになりました。

  • invoice.total_tax_amounts[0].amount を invoice.total_taxes[0].amount に置き換えます (invoice.total_taxes[0].type が tax_rate_details であることを確認した後)

変更点

パラメーター変更するリソースまたは エンドポイント
tax_amounts削除済み
CreditNoteCreditNoteLineItemInvoiceLineItem
amount_excluding_taxunit_amount_excluding_tax削除済み
CreditNoteLineItemInvoiceLineItem
tax_rates削除済み
InvoiceLineItem
taxtotal_tax_amounts削除済み
Invoice
total_taxes追加済み
CreditNoteInvoice
taxes追加済み
CreditNoteLineItemInvoiceLineItem

アップグレード

  1. Workbench で現在の API バージョンを表示します。
  2. SDK を使用している場合は、この API バージョンに対応する SDK バージョンにアップグレードします。
    • SDK を使用していない場合は、Stripe-Version: 2025-03-31.basil を含めるように API リクエストを更新してください。
  3. Webhook エンドポイントに使用する API バージョンをアップグレードします。
  4. 新しいバージョンに対して、実装内容をテストします。
  5. Connect を使用する場合は、Connect の実装内容をテストします。
  6. Workbench でアップグレードを実行します。バージョンをロールバックできるのは 72 時間以内です。

Stripe API のアップグレードについて、詳細をご確認ください。

関連する変更点

  • 最上位の price フィールドを、Invoice Item と Invoice Line Item の価格モデルに置き換え
  • 請求書の複数 (一部) 支払いのサポートを追加しました
  • 請求書の手動税額に jurisdiction level と taxability reason を追加
このページはお役に立ちましたか。
はいいいえ
  • お困りのことがございましたら 、サポートにお問い合わせください。
  • 変更ログをご覧ください。
  • ご不明な点がございましたら、お問い合わせください。
  • LLM は llms.txt を参照してください。
  • Powered by Markdoc