Settings API を使用して Stripe Tax を設定する

税金設定を行い、アカウントで税金を計算する準備が整っているかを確認する方法をご紹介します。

Stripe Tax Settings API では、Stripe ダッシュボードを使用せずに、税金の計算に必要な設定を取得して構成できます。

Connect プラットフォーム: プラットフォームでは、この API を使用して、連結アカウントが Stripe Tax を使用するように設定したり、アカウントが適切に設定されているかどうかを確認できます。
直接の使用: この API を使用して Stripe Tax を設定したり、適切に設定されているかどうかを確認することができます。

Stripe Tax を使用する準備が整っているかを確認する

Stripe Tax を有効にできるかどうかを評価する必要がある場合は、この確認を実行します。Stripe の公式ライブラリを使用して、Stripe API にアクセスします。tax.settings オブジェクトを取得します。

Stripe ダッシュボードを使用して税金設定を更新したとき、または新しい必須の税金設定が導入されたときにトリガーされる tax.settings.updated Webhook イベントをリッスンすることも可能です。Webhook エンドポイントを追加する方法については、Webhook を本番環境に移行するをご覧ください。

API または Webhook イベントが取得したレスポンスの tax.settings オブジェクトで status として "active" が返された場合は、Stripe Tax を使用する準備ができています。defaults.tax_code と defaults.tax_behavior の設定は、各 API コールの商品または価格で指定されていない場合にのみ必要です。

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": null,
    "tax_behavior": null
  },
  "head_office": {
    "address": {
      "country": "DE"
    }
  },
  "livemode": false,
  "status": "active",
  "status_details": {
    "active": {}
  }
}

レスポンスの tax.settings オブジェクトの status で "pending" が返される場合は、Stripe Tax を使用する準備ができていません。status_details[pending][missing_fields] には、未入力の必須フィールドの一覧が含まれます。

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": null,
    "tax_behavior": null
  },
  "head_office": null,
  "livemode": false,
  "status": "pending",
  "status_details": {
    "pending": {
      "missing_fields": ["head_office"]
    }
  }
}

設定を構成する

Stripe Tax の設定がすべて自社のインターフェイスで管理されている場合、このステップを完了してください。

設定の更新の呼び出しを通じて設定を変更できます。本社所在地、事前設定の税コード、税金処理を指定して呼び出しを実行します。

更新後の tax.settings オブジェクトには本社、事前設定の税コード、デフォルトの税金処理が含まれるため、Stripe Tax を有効にできます。

{
  "object": "tax.settings",
  "defaults": {
    "tax_code": "txcd_10000000",
    "tax_behavior": "inclusive"
  },
  "head_office": {
    "address": {
      "country": "DE"
    }
  },
  "livemode": false,
  "status": "active",
  "status_details": {
    "active": {}
  }
}

検証とエラー

税コードは、使用できる税コードを示している必要があり、税金処理は inclusive、exclusive、または inferred_by_currency に設定されている必要があります (設定した後は null に設定できません)。head_office には、サポート対象の住所が含まれている必要があります。

head_office[address] には、line1、line2、city、state、postal_code、country のフィールドがあります。以下の表は、サポートされる住所の形式を説明したものです。

住所のサンプル	説明	サポート対象
`line1`: 27 Fredrick Ave `city`: Brothers `state`: OR `postal_code`: 97712 `country`: US	完全な住所完全な住所には最低でも line1 (番地または私書箱)、市区町村、郵便番号、国が含まれます。この住所は、アメリカ郵政公社の住所データベースで最も近い住所または街区と照合されます。一致するものが見つからない場合は、5 桁の郵便番号の地理的な中央位置 (住所の平均的な場所) がフォールバックとして使用されます。
9 桁の郵便番号: `postal_code`: 97712-4918 `country`: US 5 桁の郵便番号: `postal_code`: 97712 `country`: US	国と郵便番号 5 桁または 9 桁の郵便番号を指定すると、Stripe のシステムでは最初の 5 桁のみが税金の計算に使用されます。税金は地理的な中央位置で計算され、5 桁の郵便番号区域内の住所の平均的な場所が反映されます。これがお客様の事業に適しているかどうかをご確認ください。
`state`: OR `country`: US	国と州 Stripe は、ISO 国コードと州コードのみを使用してアメリカの顧客の税金を計算することはできません。
`country`: US	国 Stripe は、ISO 国コードのみを使用してアメリカの顧客の税金を計算することはできません。

上記のいずれかの住所形式を使用して、本社所在地が一貫して認識されるようにしてください。国のフィールドは常に有効な ISO 国コードである必要があります。

メモ

ここに掲載されている検証とエラーは、設定フェーズに含まれています。構築済みの Stripe システムで API を呼び出す際には、その他のエラーが表示されることもあります。

参照情報

Registrations API を使用して、納税登録を管理する