コンテンツにスキップ
アカウント作成/サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成サインイン
概要決済を受け付ける構築済みのシステムをアップグレード
オンライン決済
概要ユースケースを見つけるManaged Payments を使用する継続課金
対面決済
決済手段
決済業務
残高と売上処理にかかる期間領収書返金とキャンセル
高度な連携システム
決済以外の機能

メモ

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

税金の徴収

Stripe Tax を使用して、Elements とのカスタム統合で税金を計算して徴収する方法をご紹介します。

金額を計算して表示する

Stripe Tax: 税率やルールを定義することなく取引の税金を自動的に計算する有料プロダクトです。手数料は、税金の計算と納付を登録している勤務地を 1 カ所以上追加した後にのみ適用されます。

税金を徴収するように Checkout Session を設定する

税金の徴収を開始するには、以下を行います。

  1. Checkout Session の作成時に automatic_tax[enabled]=true を渡します。
  2. 各項目に tax_code を指定するか、ダッシュボード で事前設定の税金コードを設定します。
  3. ライン項目ごとに tax_behavior を指定するか、ダッシュボード でデフォルトの税金処理を設定します。

このコードは、Stripe Tax、税金コード、税金処理を使用して税金を自動計算できるようにします。次に、Stripe Taxは税金コードと税金処理を使用して税金を自動的に計算します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][product_data][tax_code]"=txcd_99999999 \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][tax_behavior]"=exclusive \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d return_url={{RETURN_URL}} \
  -d "automatic_tax[enabled]"=true

税コード

税金コードは、商品を税率に関連付けます。税金コードのリストから商品に適した税金コードを選択します。商品がどの税金コードとも一致しない場合は、General コードのいずれかを使用できます。

税金処理

税金処理 によって、顧客への税金の表示方法が決まります。

  • 外税: 商品価格に税金を含めません。税金は独立した金額として追加されます。
  • 内税: 商品価格に税額を含めます。

オプションPayment Element で税務用住所の詳細を収集する

税金住所の詳細は支払い Element で直接徴収することができます。支払い Element を使用して税金住所の詳細を収集することは、次のユースケースに適しています。

  • 完全なアドレス回収は必要ありません。
  • Tax 回収目的でのみ住所回収が必要です。

この機能は、国と郵便番号の入力フィールドを支払い Element 内の各支払い方法フォームに統合します。Stripe Tax の要件に基づいて Tax 計算に必要な最小限の住所フィールドのみが収集されます。

顧客の完全な住所の税率と必要最小限の住所フィールドを使用する税率が異なる場合があります。地域ごとの考慮事項がビジネスに適用される場合は、住所 Element を使用して顧客の完全な住所を徴収し、税金を計算する必要があります。

Checkout Session を作成するときに、billing_address_collection=auto を設定して、請求先住所を自動的に収集します。

shipping_address_collectionパラメーターを含めないでください。このパラメーターを指定すると、Tax住所の詳細はBilling住所ではなく配送先住所に基づいて収集されます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][product_data][tax_code]"=txcd_99999999 \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][tax_behavior]"=exclusive \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  -d return_url={{RETURN_URL}} \
  -d "automatic_tax[enabled]"=true \
  -d billing_address_collection=auto

支払い Element を使用して税金住所の詳細を収集する場合、税金計算は、次のシナリオで次のように動作します。

オプションレスポンスを確認する

各決済の計算された税金は、以下のように確認できます。

税金をレンダリングする

useCheckout フックを使用して、決済フォームに税額を表示します。

import React from 'react';
import {useCheckout} from '@stripe/react-stripe-js';

const CheckoutForm = () => {
  const checkoutState = useCheckout();
  if (checkoutState.type === 'loading') {
    return (
      <div>Loading...</div>
    );
  } else if (checkoutState.type === 'error') {
    return (
      <div>Error: {checkoutState.error.message}</div>
    );
  }
  const {checkout} = checkoutState;
  return (
    <div>
      <h2>Checkout Summary</h2>
      <pre>
        {JSON.stringify(checkout.lineItems, null, 2)}
      </pre>
      <h3>Totals</h3>
      <pre>
        Subtotal: {checkout.total.subtotal.amount}
        {/* Make sure you use the appropriate tax amount type (taxInclusive and/or taxExclusive) for your integration */}
        Tax: {checkout.total.taxExclusive.amount}
        Total: {checkout.total.total.amount}
      </pre>
    </div>
  )
};

顧客の納税者番号を収集する

顧客の Tax ID と法的事業名を 請求書 に表示することは一般的な要件であり、この要件を満たすには、Tax ID の収集を有効にします。このガイドでは、Elements が Checkout Sessions API に導入されていることを前提としています。まだ導入されていない場合は、クイックスタートガイド を参照してください。

免責条項

Checkout Sessions API は事業の Tax ID を収集するように設計されています。これは、特定の管轄区域では個人の Tax ID に似た形式になる場合があります。この機能を使用する際には、このフィールドに指定された事業の Tax ID のみを提供する必要があります。

Tax ID の収集を有効にする
サーバー側

新しい顧客

新規顧客の Tax ID 収集を有効にするには、Checkout Session を作成する際に、tax_id_collection[enabled] を true に設定します。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

既存の顧客

既存の顧客と Checkout Session を作成して、決済中に収集された Tax ID 情報を追加します。このセッションでは、事業名が顧客の 名前 として保存され、収集された Tax ID が customer.tax_ids に追加されます。

Checkout Session の作成時に、customer_update.name を auto に設定すると、セッションの詳細を使用して、顧客の既存の name を自動的に更新できます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

既存の顧客の住所を保存していない場合は、決済時に入力された請求先または配送先住所を使用して、顧客の所在地を評価できます。請求先住所を使用するには、customer_update.address を auto に設定します。このパラメーターを auto に設定すると、顧客の以前に保存した住所が決済時に入力された住所に置き換えられます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[address]"=auto \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

既存の顧客の配送先住所を保存する場合は、決済時に入力された配送先住所を使用して、所在地を評価できます。配送先住所を使用するには、customer_update.shipping を auto に設定します。このパラメーターを auto に設定すると、以前に保存した顧客の配送先住所が決済時に入力された住所に置き換えられます。

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d ui_mode=custom \
  -d customer=
"{{CUSTOMER_ID}}"
 \
  -d "line_items[0][price]"=
"{{PRICE_ID}}"
 \
  -d "line_items[0][quantity]"=1 \
  -d "tax_id_collection[enabled]"=true \
  -d "customer_update[name]"=auto \
  -d "customer_update[shipping]"=auto \
  -d "shipping_address_collection[allowed_countries][0]"=DE \
  -d mode=payment \
  --data-urlencode return_url="https://example.com/return"

この例では、Tax ID 収集が有効化された payment モードでセッションを作成します。サブスクリプションの場合は、mode を subscription に設定して同じ変更を行います。

Tax ID Element をレンダリングする
クライアント側
プレビュー

Stripe の Tax ID Element を使用して Tax ID を収集します。

App.jsx
import {useMemo} from 'react',
import {loadStripe} from '@stripe/stripe-js';
import {CheckoutProvider, TaxIdElement} from '@stripe/react-stripe-js/checkout';

const stripePromise = loadStripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx'
, {
  betas: [
    'custom_checkout_tax_id_1',
  ],
});

const App = () => {
  const fetchClientSecret = useMemo(() => {
    return fetch('/create-checkout-session', {method: 'POST'})
      .then((res) => res.json())
      .then((data) => data.clientSecret)
  }, []);

  return (
    <CheckoutProvider
      stripe={stripePromise}
      options={{
        clientSecret: fetchClientSecret,
      }}
    >
      <TaxIdElement />
    <CheckoutProvider>
  );
};

セッション後に顧客の Tax ID の詳細を取得する

Checkout は、生成された Session (セッション) オブジェクトに提供された納税者番号を含めます。各セッションの完了後に、Checkout は checkout.session.completed イベントを送信します。これは Webhook エンドポイントでリッスンできます。納税者番号を Session オブジェクトから取得する場合は、セッションの customer_details.tax_ids 配列から取得できます。

{
  "object": {
    "id": "cs_test_a1dJwt0TCJTBsDkbK7RcoyJ91vJxe2Y",
    "object": "checkout.session",
    ...
    "customer": "cus_id_of_new_customer",
    "customer_details": {
      ...
      "tax_ids": [
        {
          "type": "eu_vat",
          "value": "FRAB123456789"
        }
      ]
    },
    ...
    "tax_id_collection": {
      "enabled": true
    },
    ...
  }
}

Checkout はさらに、セッションに Customer (顧客) オブジェクトが関連付けられている場合、収集された納税者番号と企業名をこのオブジェクトに保存します。決済時に収集された納税者番号は、Customer の customer.tax_ids 配列からアクセスできます。また、owner.type パラメーターを customer に、owner.customer を Customer’s ID に指定することで、Customer に保存されたすべての納税者番号を Tax ID リソースで取得することもできます。新しい納税者番号のすべてに関連付けられている企業の正式名称が含まれ、Checkout はそれを顧客の name プロパティに保存します。このようにすることで、収集された法人名がその顧客のサブスクリプションの請求書に常に表示されることになります。

実装内容をテストする

テスト環境では、サポートされている納税者番号タイプの正しい形式で英数字の文字列を入力できます (eu_vat の場合は DE123456789 など)。納税者番号のサンプルの一覧については、Stripe の顧客の納税者番号に関するガイドをご覧ください。また、テスト用納税者番号を使用して、さまざまな確認ステータスのフローをテストすることもできます。

検証

Checkout セッションの際に、Stripe は入力された納税者番号が正しい形式であること (有効かどうかではなく) を確認します。決済時に収集された顧客情報の有効性を確保する責任はお客様にあります。そのサポートとして、Stripe ではヨーロッパの付加価値税 (EU VAT) およびイギリスの付加価値税 (GB VAT) 番号を、政府データベースと照らし合わせる非同期の検証を自動的に行います。Stripe が実行する検証の詳細、およびそれらの検証のステータスを使用する方法をご確認ください。

お客様が Stripe Tax を使用していて、顧客が納税者番号を入力した場合、納税者番号が有効かどうかにかかわらず、納税者番号が必要な数値形式に準拠している限り、Stripe Tax は適用法に従ってリバースチャージまたはゼロレートを適用します。

サポートされる納税者番号の種類

Checkout Session は、特定の地域で以下の Tax ID を収集します。

国列挙値説明例
税金計算への影響
アイスランドis_vatIcelandic VAT123456はい
アイルランドeu_vatEuropean VAT numberIE1234567ABはい
アゼルバイジャンaz_tinAzerbaijan Tax Identification Number0123456789はい
アラブ首長国連邦ae_trnUnited Arab Emirates TRN123456789012345はい
アルバaw_tinAruba Tax Identification Number12345678はい
アルバニアal_tinAlbania Tax Identification NumberJ12345678Nはい
アルメニアam_tinArmenia Tax Identification Number02538904はい
アンゴラao_tinAngola Tax Identification Number5123456789いいえ
イギリスeu_vatNorthern Ireland VAT numberXI123456789はい
イギリスgb_vatUnited Kingdom VAT numberGB123456789はい
イタリアeu_vatEuropean VAT numberIT12345678912はい
インドin_gstIndian GST number12ABCDE3456FGZHはい
ウガンダug_tinUganda Tax Identification Number1014751879はい
ウクライナua_vatUkrainian VAT123456789はい
ウズベキスタンuz_tinUzbekistan TIN Number123456789いいえ
ウズベキスタンuz_vatUzbekistan VAT Number123456789012はい
ウルグアイuy_rucUruguayan RUC number123456789012はい
エクアドルec_rucEcuadorian RUC number1234567890001いいえ
エジプトeg_tinEgyptian Tax Identification Number123456789はい
エストニアeu_vatEuropean VAT numberEE123456789はい
エチオピアet_tinEthiopia Tax Identification Number1234567890はい
オーストラリアau_abnAustralian Business Number (AU ABN)12345678912はい
オーストリアeu_vatEuropean VAT numberATU12345678はい
オマーンom_vatOmani VAT NumberOM1234567890はい
オランダeu_vatEuropean VAT numberNL123456789B12はい
カーボベルデcv_nifCape Verde Tax Identification Number (Número de Identificação Fiscal)213456789いいえ
カザフスタンkz_binKazakhstani Business Identification Number123456789012はい
カナダca_bnCanadian BN123456789いいえ
カナダca_gst_hstCanadian GST/HST number123456789RT0002はい
カナダca_pst_bcCanadian PST number (British Columbia)PST-1234-5678いいえ
カナダca_pst_mbCanadian PST number (Manitoba)123456-7いいえ
カナダca_pst_skCanadian PST number (Saskatchewan)1234567いいえ
カナダca_qstCanadian QST number (Québec)1234567890TQ1234はい
カメルーンcm_niuCameroon Tax Identification Number (Numéro d'Identifiant fiscal Unique)M123456789000Lいいえ
カンボジアkh_tinCambodia Tax Identification Number1001-123456789はい
ギニアgn_nifGuinea Tax Identification Number (Número de Identificação Fiscal)123456789はい
キプロスeu_vatEuropean VAT numberCY12345678Zはい
ギリシャeu_vatEuropean VAT numberEL123456789はい
キルギスkg_tinKyrgyzstan Tax Identification Number12345678901234いいえ
クロアチアeu_vatEuropean VAT numberHR12345678912はい
ケニアke_pinKenya Revenue Authority Personal Identification NumberP000111111Aいいえ
コスタリカcr_tinCosta Rican tax ID1-234-567890いいえ
コンゴ民主共和国(キンシャサ)cd_nifCongo (DR) Tax Identification Number (Número de Identificação Fiscal)A0123456Mいいえ
サウジアラビアsa_vatSaudi Arabia VAT123456789012345はい
ザンビアzm_tinZambia Tax Identification Number1004751879いいえ
ジョージアge_vatGeorgian VAT123456789はい
シンガポールsg_gstSingaporean GSTM12345678Xはい
ジンバブエzw_tinZimbabwe Tax Identification Number1234567890いいえ
スイスch_vatSwitzerland VAT numberCHE-123.456.789 MWSTはい
スウェーデンeu_vatEuropean VAT numberSE123456789123はい
スペインes_cifSpanish NIF number (previously Spanish CIF number)A12345678いいえ
スペインeu_vatEuropean VAT numberESA1234567Zはい
スリナムsr_finSuriname FIN Number1234567890はい
スロバキアeu_vatEuropean VAT numberSK1234567891はい
スロベニアeu_vatEuropean VAT numberSI12345678はい
セネガルsn_nineaSenegal NINEA Number12345672A2いいえ
セルビアrs_pibSerbian PIB number123456789いいえ
タイth_vatThai VAT1234567891234はい
タジキスタンtj_tinTajikistan Tax Identification Number123456789はい
タンザニアtz_vatTanzania VAT Number12345678Aはい
チェコ共和国eu_vatEuropean VAT numberCZ1234567890はい
チリcl_tinChilean TIN12.345.678-Kはい
デンマークeu_vatEuropean VAT numberDK12345678はい
ドイツeu_vatEuropean VAT numberDE123456789はい
トルコtr_tinTurkish Tax Identification Number0123456789はい
ナイジェリアng_tinNigerian Tax Identification Number12345678-0001いいえ
ニュージーランドnz_gstNew Zealand GST number123456789はい
ネパールnp_panNepal PAN Number123456789はい
ノルウェーno_vatNorwegian VAT number123456789MVAはい
バーレーンbh_vatBahraini VAT Number123456789012345はい
バハマbs_tinBahamas Tax Identification Number123.456.789いいえ
バルバドスbb_tinBarbados Tax Identification Number1123456789012いいえ
ハンガリーeu_vatEuropean VAT numberHU12345678はい
バングラデシュbd_binBangladesh Business Identification Number123456789-0123はい
フィリピンph_tinPhilippines Tax Identification Number123456789012はい
フィンランドeu_vatEuropean VAT numberFI12345678はい
フランスeu_vatEuropean VAT numberFRAB123456789はい
ブルガリアeu_vatEuropean VAT numberBG0123456789はい
ブルキナファソbf_ifuBurkina Faso Tax Identification Number (Numéro d'Identifiant Fiscal Unique)12345678Aはい
ベナンbj_ifuBenin Tax Identification Number (Identifiant Fiscal Unique)1234567890123はい
ベラルーシby_tinBelarus TIN Number123456789はい
ペルーpe_rucPeruvian RUC number12345678901はい
ベルギーeu_vatEuropean VAT numberBE0123456789はい
ポーランドeu_vatEuropean VAT numberPL1234567890はい
ボスニア・ヘルツェゴビナba_tinBosnia and Herzegovina Tax Identification Number123456789012はい
ポルトガルeu_vatEuropean VAT numberPT123456789はい
マルタeu_vatEuropean VAT numberMT12345678はい
メキシコmx_rfcMexican RFC numberABC010203AB9いいえ
モーリタニアmr_nifMauritania Tax Identification Number (Número de Identificação Fiscal)12345678いいえ
モルドバmd_vatMoldova VAT Number1234567はい
モロッコma_vatMorocco VAT Number12345678はい
モンテネグロme_pibMontenegro PIB Number12345678いいえ
ラオスla_tinLaos Tax Identification Number123456789-000いいえ
ラトビアeu_vatEuropean VAT numberLV12345678912はい
リトアニアeu_vatEuropean VAT numberLT123456789123はい
リヒテンシュタインli_vatLiechtensteinian VAT number12345はい
ルーマニアeu_vatEuropean VAT numberRO1234567891はい
ルクセンブルグeu_vatEuropean VAT numberLU12345678はい
ロシアru_innRussian INN1234567891はい
ロシアru_kppRussian KPP123456789はい
北マケドニアmk_vatNorth Macedonia VAT NumberMK1234567890123はい
南アフリカza_vatSouth African VAT number4123456789はい
台湾tw_vatTaiwanese VAT12345678はい
韓国kr_brnKorean BRN123-45-67890はい