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

通常、VAT と売上税は、顧客の場所ではなく、イベントの場所に基づいて、入場料を請求する場所 (コンサート、会議、美術館、スポーツイベントのチケットなど) に適用されます。アメリカでは、州や地方の売上税に加え、特定の地方税 (エンターテイメント税や娯楽税など) が適用される場合があります。

Stripe SDK を更新する

この新機能はプライベートプレビュー版機能であり、最新の API バージョンに更新する必要があります。SDK と API のバージョンをアップグレードするには、API アップグレードガイドに従い、ライブラリーを最新バージョンにアップグレードします。変更ログを調べて、変更に後方互換性があることを確認してください。

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

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

Stripe Tax を設定する

When you set up Stripe Tax for tickets, set the default product tax code to txcd_20030000, General - Services. You can’t set any of the event tax codes as the default product tax code.

テスト登録を追加するには、以下のようにします。

1. ダッシュボードの税務登録ページで、登録を追加 をクリックします。
2. 次の推奨登録を追加します。
   1. アメリカ - コロラド、売上税
   2. アメリカ - コロラド州、ボルダー入場税

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

ほとんどの場合、税金の計算は取引先 (通常は顧客の配送先住所または請求先住所) に基づいて行われます。ただし、チケット売上の税金計算はイベントの場所に基づいて行われます。次の手順で、イベントの場所を基に税金を計算する方法を説明します。

決済フローを設計する

Stripe Tax は、Stripe Tax Calculation API を使用したチケット販売のみに対応しています。つまり、Payment Element の実装、または Tax Calculation API との直接連携のみ可能ということです。Stripe Checkout や Stripe サブスクリプションなど、他のプロダクトとの連携はできません。

決済システムに応じて、以下の 2 つの導入パスから選択できます。

どの導入を選択する場合でも、納税場所を作成して税金を計算する必要があります。これは、どちらの導入パスでも同じように機能します。

Tax Location API を使用してイベントの場所を作成する

チケット販売のそれぞれに、税金の場所を作成してデータベースに保存し、税金を計算するタイミングを指定する必要があります。この例では、アメリカのコロラド州ボルダーにある公園であるグリーンリーフパークを表す、タイプ performance の納税場所を作成します。

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
}

たとえば、データベーススキーマは次のようになります。

税金計算

Stripe Tax でチケット売上の税金を計算するには、次の 4 つの情報が必要です。

• ビジネスの所在地 (本社の住所): 以前設定された、税金設定で指定した住所です
• イベントの場所 (タイプ performance の納税場所): 前のセクションで作成した場所です
• 顧客の場所 (請求先住所): これは B2B リバースチャージのため重要です
• 商品のタイプ (チケット、商品など): txcd_50010001 - 娯楽、エンターテイメント、レクリエーション施設への入場料 - 参加者、などです。

顧客の住所の収集

顧客の住所を収集するには、Address Element を使用して、顧客に住所の入力を求める住所フォームを決済フローに組み込むことをお勧めします。必要な住所情報の詳細をご覧ください。

請求先住所が Stripe Tax の有効な住所であることを確認する必要があります。Stripe Tax で住所を検証して、税金の計算を作成できます。ただし、本番環境の各計算には手数料がかかるため、可能な限り多くの検証をシステムで直接実行することをお勧めします。

住所を収集して検証する前に、決済ボタンを無効にしてください。住所を入力し、Stripe で住所が確認されたら、決済ボタンを有効にして税金の計算を実行できます。税金計算は、適用される税金の「プレビュー」です。

商品のタイプ

You can find all ticket tax codes on our product tax code reference page, including txcd_50010001, Admission to Amusement, Entertainment and Recreation Venues – Participant.

納税場所を使用して税金を計算する

Tax Calculation 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

計算エンドポイントが customer_tax_location_invalid エラーコードを返す場合には、入力した住所が正確で抜けなどがないかを確認するよう顧客に要請します。

計算結果を把握し、決済につなげる

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

支払いを作成する

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