Connect で明細書表記を設定する
明細書表記は、銀行明細書上で請求や支払いの記述に使用されるもので、銀行やカードネットワークが顧客に明細書を理解していただくために必要な情報が含まれています。明細書表記の要件を参照して理解を深めてください。
連結アカウントに対する静的なコンポーネントの設定
明細書表記には、静的コンポーネントと、オプションで動的部分が含まれます。静的コンポーネントは以下のいずれかを指します。
- 明細書表記の全体が静的である (settings.payments.statement_descriptor)。
- 明細書表記の前半が静的であり (settings.card_payments.statement_descriptor_prefix)、後半は支払いによって動的に設定される。
card_payments
ケイパビリティを持つプラットフォームと連結アカウントでは、明細書表記と、必要に応じて明細書表記のプレフィックスを設定する必要があります。どちらの値も、5 文字以上にしてください。指定した支払いに対して、支払いタイプに基づき、プラットフォームまたは連結アカウントの明細書表記が適用されます。
明細書表記は以下のいずれかの方法で設定されます。
- アカウントの作成または更新 API コールの発生時
- Stripe のホスティング登録またはオンラインのアカウント登録の間
- Stripe ダッシュボードまたは Express ダッシュボードの全機能を利用して
Stripe ダッシュボードまたは Express ダッシュボードの全機能を利用できる連結アカウントは、それぞれの明細書表記の設定を更新できます。
create account (アカウント作成) エンドポイントを呼び出す際に、アカウントの明細書表記とプレフィックスを事前入力できます。Stripe のホスティング登録またはオンラインのアカウント登録時に settings.payments.statement_descriptor
または settings.card_payments.statement_descriptor_prefix
が設定されていない場合、Stripe はアカウント登録時に提供された情報に基づいてこれを設定します。十分な情報を利用できない場合、Stripe は連結アカウントに対して、アカウント登録時に自社の明細書表記を設定するように求めます。
Stripe ダッシュボードの全機能にアクセスできないアカウントを登録した後、update account (アカウント更新) エンドポイントを呼び出して、その settings.payments.statement_descriptor
と settings.card_payments.statement_descriptor_prefix
を更新できます。
プラットフォームがアカウント登録を行うアカウントについては、明細書表記を設定する必要があります。
API バージョン 2023-10-16 には、明細書表記の更新に関する新しいロジックが追加されています。
- アカウントの
business_profile.name
、business_profile.url
、または会社や個人の名前が変更され、既存の明細書表記が優先度の低いデータに基づく場合、Stripe は優先度の高い値に一致するように明細書表記を自動的にリセットします。たとえば、明細書表記が URL に基づいて自動的に設定されている場合にbusiness_profile.name
を設定または更新すると、Stripe はビジネスプロフィール名と一致するように明細書表記をリセットします。明細書表記がbusiness_profile.name
に基づいて自動で設定されている場合、お客様が会社または個人の名前を設定または更新しても明細書表記はリセットされません。これは、business_profile.name
のほうが優先順位が高いためです。優先順位は、business_profile.name
、business_profile.url
、次に会社または個人の名前の順になります。 - アカウントの明細書表記全体を更新すると、以前の明細書表記プレフィックスが手動で設定されたものであっても、プレフィックスは更新後の明細書表記の短縮版へと自動で設定されます。
明細書表記の使用方法
支払いを処理する銀行またはカードネットワークに、明細書表記全体が提供されます。カード決済に関する、明細書表記全体の最初の 22 文字のみが送信されます。
以下の支払いタイプについては、連結アカウントの静的なコンポーネントが顧客の明細書に使用されます。
- ダイレクト支払い
on_behalf_of
を指定したデスティネーション支払いon_behalf_of
を指定した支払いと送金別方式
注意
API バージョンが 2019-02-19
より前の場合、プラットフォームは on_behalf_of
を指定した /v1/charges
リクエストに静的なコンポーネントを提供します。
連結アカウントで静的なコンポーネントを使用するには、card_payments ケイパビリティが必要です。
以下の支払いタイプについては、プラットフォームアカウントの静的なコンポーネントが顧客の明細書に使用されます。
on_behalf_of
を指定しないデスティネーション支払いon_behalf_of
を指定しない支払いと送金別方式
顧客の明細書に表示される追加情報は、静的なコンポーネント (サポート部門のアドレスや電話番号など) を提供するアカウントからも提供されます。連結アカウントでこの情報が提供されていない場合、on_behalf_of
支払いではプラットフォームアカウントの情報が使用されます。
連結アカウントの静的な明細書表記を使用する支払いで動的なサフィックスを使用する場合は、明細書表記全体が意図したとおりに表示されるようにプレフィックスを設定できます。
静的なプレフィックスは 2 ~ 10 文字で指定する必要があります。カードネットワークは、明細書表記全体の最初の 22 文字のみ (静的なプレフィックスと動的なサフィックスを結合する *
記号とスペースを含む) を受け取ります。
支払い時に明細書表記を柔軟に設定できるように、statement_descriptor
および statement_descriptor_prefix
を設定します。
カード支払いで明細書表記が設定され、プレフィックスが設定されていない場合、Stripe は必要に応じてアカウントの明細書表記を切り詰めて、プレフィックス値を設定します。
連結アカウントの支払いに使用される動的なサフィックスの設定
動的なサフィックスは、statement_descriptor_suffix
パラメーターを使用するカード支払いのみでサポートされます。詳細については、動的なサフィックスをご覧いただくか、ダッシュボードで、結合された明細書表記 (プレフィックス* サフィックス) をご確認ください。
日本語の明細書表記を設定する
日本の連結アカウントには、漢字とカナの明細書表記の静的コンポーネントを設定することをお勧めします。
日本の Custom の連結アカウントを作成するときに、すべての表記とそれに対応するプレフィックスを次のように設定できます。
カード支払いを作成するときに、payment_method_options[card][statement_descriptor_suffix_kanji]
および payment_method_options[card][statement_descriptor_suffix_kana]
を使用して動的な漢字とカナのサフィックスを設定できます。
詳細については、日本語の明細書表記をご覧ください。