顧客の住所を収集

Stripe Tax では、税金を自動的に計算するために顧客の場所が必要とされます。この要件は、有効な登録がない場合にも適用されます。このガイドでは、顧客から住所を収集する方法について説明します。

Checkout と Payment Links

Checkout は、Payment Links で作成された住所を含む、顧客の住所の収集を処理します。

請求処理、 サブスクリプション、およびカスタムの支払いの組み込み

Payment Links または Checkout を使用していない場合、顧客の住所を収集する責任はお客様にあります。

• Customer オブジェクトの country フィールドと postal_code の両方のフィールドを収集し設定します。
• 2 文字の国コード (ISO 3166-1 alpha-2) を使用します。
• 顧客を作成または更新の際に、tax[validate_location]=“immediately” を設定して、後の customer_tax_location_invalid エラーを防ぎます。
• ほとんどのアクティビティーは非同期で発生するため、サブスクリプションの Webhook イベントをリッスンします。

請求書の確定エラー

Stripe Tax で請求書を確定するには、顧客の場所を認識しておく必要があります。顧客のデフォルトの支払い方法を更新 / 削除した場合、あるいは顧客を作成 / 更新する際に tax[validate_location]="immediately" を指定しなかった場合、場所の詳細が不足または無効になる可能性があります。

顧客の場所が認識されていない場合、サブスクリプションの請求書は引き続き自動的に確定されますが、税金は計算されません。これにより、以下の影響が生じます。

• Subscription (サブスクリプション) と Invoice (請求書) の automatic_tax[enabled] パラメーターが false に変わります。
• Invoice[automatic_tax][disabled_reason] パラメーターが finalization_requires_location_inputs に変わります。
• Subscription[automatic_tax][disabled_reason] が requires_location_inputs に変わります。
• サブスクリプションにスケジュールが設定されている場合、現在のフェーズと default_settings の automatic_tax[enabled] を false に設定します。また、両方の disabled_reason を requires_location_inputs に設定します。
• invoice.updated と customer.subscription.updated イベントを送信して、これらの変更をシステムに通知します。
  • スケジュールが設定されている場合、subscription_schedule.updated Webhook も送信されます。
• 請求書は税金の計算や徴収を行わずに確定されます。税額は記載されません。
• Stripe は通常どおり、請求書の回収方法に従って支払いを回収します。

Stripe ダッシュボードで税金の自動計算が設定されていないサブスクリプションを確認するには、Subscription ページにアクセスし、税金の自動計算が無効のオプションで表示を絞り込みます。今後これらのサブスクリプションの自動税金計算を有効にするには、有効な顧客の場所が少なくとも 1 つあることを確認し、Stripe Tax ダッシュボードで税金の自動計算を有効にします。

税金が自動的に無効になる例外

有効な顧客の場所を指定せずに API またはダッシュボードで確定すると、Stripe はエラーを返し、請求書を draft ステータスのまま維持します。API には、code が customer_tax_location_invalid の HTTP 400 エラーが返されます。

同様に、サブスクリプションのないスタンドアロンの請求書を自動確定する際に、顧客の場所が有効でなければ請求書は下書きのままになります。Stripe は請求書の last_finalization_error[code] を customer_tax_location_invalid に指定して、invoice.finalization_failed イベントを送信します。

customer_tax_location_invalid エラーから回復する方法は、顧客の住所を収集しているかどうかによって異なります。

• 顧客の住所がわかる場合、または収集できる場合は、顧客を更新して請求書を手動で確定します。
  1. Update the customer に tax[validate_location]=“immediately” を指定して、新しい住所が有効であることを確認します。
  2. 請求書を確定します。
• 顧客の住所がわからない場合、または収集できない場合は、請求書とそのサブスクリプションに対して Stripe Tax を無効にし、請求書を手動で確定します。
  1. 影響を受ける請求書を更新して、automatic_tax[enabled]=false に指定します。
  2. 影響を受けるサブスクリプションを更新して、automatic_tax[enabled]=false に設定します。
  3. 請求書を確定する。