イベントの場所に基づく税チケット販売非公開プレビュー

イベントの税金計算はプライベートプレビューであり、最新の API バージョンに更新 する必要があります。変更ログ を調べて、変更に後方互換性があることを確認することができます。

必要に応じて、SDK プライベートパラメーターにアクセスできます。次の SDK のいずれかでカスタムリクエストを使用して、この機能に関連するプライベートエンドポイントを呼び出すこともできます。

• Ruby
• Python
• PHP
• Node
• Java
• .NET
• Go

チケットにStripe Taxを設定るときは、デフォルトのProduct Tax Codeをtxcd_20030000、General - Servicesに設定します。Event Tax Code のいずれもデフォルト製品税コードとして設定できません。

ダッシュボードまたは税務登録 API を使用して、テスト用の登録を追加できます。

サンドボックス環境では、Stripe Tax の計算に手数料は発生しません。税務登録を追加した後、本番環境で税金を計算すると手数料が発生します。

チケット販売の税金計算は、顧客の請求先住所や配送先住所ではなくイベント開催地に基づいて行われるため、一般的な税金計算とは異なります。

Stripe Tax は、税金計算 API を直接使用するか、PaymentIntents を使用したチケット販売のみをサポートします。Stripe Checkout やサブスクリプションなどの他の統合は使用できません。

既存の決済導入に対応する導入パスを選択します。

どちらの導入でも、納税場所を作成し、Tax 計算を実行する必要があります。

イベント会場の住所を指定して、税務拠点の作成のタイプperformanceを呼び出します。

販売タイプがAll Salesであるサポート対象国 の TaxCalculation の対象となる住所であれば、すべて使用できます。

国ごとに、その場所に必要な 住所の形式 が異なります。

curl https://api.stripe.com/v1/tax/locations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.basil" \
  -d type=performance \
  --data-urlencode "address[line1]"="Folsom and, Pearl St" \
  -d "address[city]"=Boulder \
  -d "address[state]"=CO \
  -d "address[postal_code]"=80302 \
  -d "address[country]"=US \
  -d description="Greenleaf Park"

レスポンスでは、納税場所の一意の識別子としてidが返されます。この値を保存して、この場所での売上に対する税金を計算 する取引で使用します。

{
  "id": "taxloc_yB7b4tVHRb",
  // ... other fields omitted
}

この例のデータベースエントリは次のとおりです。

所在地住所の検証エラー

納税場所作成リクエストでエラーが返された場合は、paramプロパティとmessageプロパティで具体的なガイダンスを確認してください。

住所が無効です

「この住所は納税場所として Stripe Tax によりサポートされていません。有効な住所を使用してください。」

住所を確認できませんでした。住所の要件については、サポートされている住所の形式をご覧ください。

サポート対象外の国または除外された地域

「この住所は納税場所として Stripe Tax によりサポートされていません。Stripe Tax によりサポートされている場所を使用してください。」

この国は サポート 対象外、または住所が 除外対象地域 にある。

チケットの売上税の計算には、次の情報が必要です。

• Stripe Tax の設定時に指定された事業所の所在地
• 場所の作成 レスポンスで返されるイベント開催地 ID
• 顧客の請求先住所 (B2B リバースチャージ の場合)
• 商品コード (チケット、商品など)。例: txcd_50010001:-- 遊興施設、娯楽施設、レクリエーション施設の入場--参加者。

顧客住所を収集する

1. 決済に Address Element を使用して住所フォームを組み込み、顧客から 必要な住所の詳細 を収集します。
2. Verify that the billing address is valid for Stripe Tax. Perform this validation directly on your integration to avoid incurring tax calculation fees in live mode for validation.
3. 回収と検証が完了するまで決済ボタンを無効にします。

商品のタイプ

Tax code には、次の所在地要件を設定できます。

• optional: パフォーマンスの場所を渡すことが「できます」。
• required: パフォーマンスの場所を渡す「必要があります」。
• not supported: 税コードは、公演場所に対応していません。

You txcd_50010001、Admission to Amusement, Entertainment and Recreation Venues – Participant を含む、すべてのチケット税コードを当社の 商品税金コードリファレンス ページで見つけることができます。

納税場所の適用

税金計算 API コール内で必要なすべてのデータを渡す必要があります。この例では、コロラド州ボルダーの Greenleaf Park の納税場所でイベントのチケットを購入するアイルランド在住の顧客の税金を計算します。

curl https://api.stripe.com/v1/tax/calculations \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.basil" \
  -d currency=usd \
  -d "line_items[0][amount]"=2500 \
  -d "line_items[0][reference]"="Outdoor concert - L1" \
  -d "line_items[0][tax_behavior]"=exclusive \
  -d "line_items[0][tax_code]"=txcd_50010001 \
  -d "line_items[0][performance_location]"=taxloc_yB7b4tVHRb \
  -d "customer_details[address][country]"=IE \
  -d "customer_details[address_source]"=billing

イベントチケット (T シャツなど) と一緒に項目を販売するには、税金計算リクエストに別の項目を追加し、正しい商品税金コードを選択します。これらのアイテムの税金は、イベントのパフォーマンスの場所ではなく、請求先住所または配送先住所に基づいて計算されます。パフォーマンスの場所は、これらの追加アイテムには適用されません。

計算結果を支払いに適用する

Calculation API コールは、イベントの納税場所における税金を計算します。このケースでは、コロラド州ボルダーのグリーンリーフパークです。

最上位の税金の内訳を使用して、請求されるすべての税金を表示できます。この場合のレスポンスは次のようになります。

{
  "id": "taxcalc_fQSaHNaU",
  "amount_total": 2697,
  // ... other fields omitted
  "tax_breakdown": [
    // ... other entries omitted
    {
      "amount": 125,
      "inclusive": false,
      "tax_rate_details": {
        // ... other entries omitted
        "country": "US",
        "state": "CO",
        "percentage_decimal": "5.0", // This is just an example. The Stripe Tax calculation API returns the correct tax rate.
        "tax_type": "admissions_tax"
      },
      "taxability_reason": "standard_rated",
      "taxable_amount": 2500
    }
  ]
}

calculation オブジェクトには ID が含まれています。4 つの入力パラメータ (ビジネスの所在地、顧客の住所、イベントの場所、商品タイプ) のいずれかが変更されるたびに、新しい計算を実行する必要があります。

最新の計算 ID を保存して、後で税取引を確定します。これは、コンプライアンスに準拠したレポート作成に必要です。

決済インターフェイスでは、Tax Calculation API コールのレスポンスの tax_breakdown オブジェクトに基づいて、次の例のような税金をプレビューとして表示できます。

2025 年 1 月 1 日 (月) にローズボウルで行われる 2023 カレッジフットボールローズボウルゲーム

課税計算エラー

課税計算リクエストがエラーを返した場合は、パラメータ とメッセージ プロパティを確認してください。

納税地が不明

納税地が不明です。有効な納税地を使用してください。

納税地idが Stripe アカウントでアクセス可能な納税地に属していません。課税地はアカウント専用で、連結するアカウント間やプラットフォームで共有することはできません。連結アカウントに代わって Connect プラットフォームとして API コールを行う場合は、プラットフォームではなく連結アカウント用に納税地を作成してください。

課税コードには、納税地が必要です

課税コード txcd_50010001 には、履行タイプに対応した納税地が必要です。

課税計算には、発券に必要な履行場所が欠けています。商品課税コードを変更するか、履行場所を含める必要があります。

課税コードが納税地に対応していません

課税コード txcd_99999999 は、履行タイプの納税地に対応していません。

リクエストに履行場所を含めましたが、商品タックスコードは履行場所に対応していません。商品税コードを変更するか、履行場所を削除する必要があります。

支払いは、税金計算の amount_total を使用して作成されます。

支払いが成功すると、税取引を作成できます。この記録は、レポート作成と法令遵守のために使用します。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-05-28.preview" \
  -d amount=2697 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]"=true \
  -d "hooks[inputs][tax][calculation]"=
{{CALCULATION_ID}}