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

イベントの税金計算はプライベートプレビューであり、最新の 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 やサブスクリプションなどの他の統合は使用できません。

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

どちらの連携でも、公演場所を作成し、税計算を実行する必要があります。

公演場所 タイプ 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 プロパティで具体的なガイダンスを確認してください。

住所が無効です

The address is not supported by Stripe Tax for a tax location. Please use a valid address.

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

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

The address is not supported by Stripe Tax for a tax location. Please use a location that is supported by Stripe Tax.

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

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

• Stripe Tax の設定時に指定された事業所の所在地
• 場所の作成応答で返される公演場所 ID
• 顧客の請求先住所 (B2B リバースチャージ の場合)
• 商品コード (チケット、商品など)。例: txcd_50010001–-Admission to Amusement, Entertainment and Recreation Venues--Participant。

顧客住所を収集する

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. 回収と検証が完了するまで決済ボタンを無効にします。

商品のタイプ

税コード には、次の所在地要件を設定できます。

• optional: 公演場所を渡すことが できます。
• required: 公演場所を渡す 必要があります。
• not supported: 税コードが公演場所に対応していません。

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

公演場所を適用する

税計算 API コール内で必要なすべてのデータを渡す必要があります。この例では、アイルランドに拠点を置く顧客が、コロラド州ボルダーのグリーンリーフ公園にある公演場所でイベントのチケットを購入した場合の税金を計算します。

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 カレッジフットボールローズボウルゲーム

課税計算エラー

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

納税地が不明

Unknown tax location being passed. Please use a valid tax location.

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

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

Tax code txcd_50010001 requires a tax location to be passed of the type performance.

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

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

Tax code txcd_99999999 does not support a tax location with the type performance 。

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

支払いは、税金計算の 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}}"