# Connect で明細書表記を設定する

Connect を使用した支払いにおける明細書表記の仕組みについて説明します。

明細書表記は、銀行明細書上で請求や支払いの記述に使用されるもので、銀行やカードネットワークが顧客に明細書を理解していただくために必要な情報が含まれています。[明細書表記の要件](https://docs.stripe.com/get-started/account/statement-descriptors.md)を参照して理解を深めてください。

## 連結アカウントに対する静的なコンポーネントの設定

明細書表記には、静的コンポーネントと、オプションで動的部分が含まれます。静的コンポーネントは以下のいずれかを指します。

- 明細書表記の全体が静的である ([settings.payments.statement_descriptor](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor))。
- 明細書表記の前半が静的であり ([settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-card_payments-statement_descriptor_prefix))、後半は支払いによって動的に設定される。

`card_payments` ケイパビリティを持つプラットフォームと連結アカウントでは、明細書表記と、必要に応じて明細書表記のプレフィックスを設定する必要があります。どちらの値も、5 文字以上にしてください。指定した支払いに対して、[支払いタイプ](https://docs.stripe.com/connect/charges.md)に基づき、プラットフォームまたは連結アカウントの明細書表記が適用されます。

明細書表記は以下のいずれかの方法で設定されます。

- [アカウントの作成または更新](https://docs.stripe.com/api/accounts.md) API コールの発生時
- Stripe のホスティング登録またはオンラインのアカウント登録の間
- Stripe ダッシュボードまたは Express ダッシュボードの全機能を利用して

*Stripe がホストするダッシュボードを利用* (Platforms can provide connected accounts with access to the full Stripe Dashboard or the Express Dashboard. Otherwise, platforms build an interface for connected accounts using embedded components or the Stripe API)できる連結アカウントは、それぞれの明細書表記の設定を更新できます。

[アカウントの作成](https://docs.stripe.com/api/accounts/create.md)エンドポイントを呼び出す際に、アカウントの明細書表記とプレフィックスを事前入力できます。Stripe のホスティング登録または埋め込みユーザ登録時に、`settings.payments.statement_descriptor` が設定されていない場合、Stripe は次の文字列を連結して生成します。

1. `business_profile.name`
1. “doing business as”
1. `business_profile.url`
1. 法人名 (`individual.first_name` + `individual.last_name` または `company.name`)。

`settings.payments.statement_descriptor_prefix` が事前入力されていない場合、Stripe は明細書表記の最初の 10 文字を使用して設定します。

必要な情報が入手できない場合、Stripe のホスティング登録または埋め込みユーザ登録によって、アカウントは独自の明細書表記とプレフィックスを設定するように求められます。

Stripe ダッシュボードの全機能にアクセスできないアカウントを登録した後、[update account (アカウント更新)](https://docs.stripe.com/api/accounts/update.md) エンドポイントを呼び出して、その `settings.payments.statement_descriptor` と `settings.card_payments.statement_descriptor_prefix` を更新できます。

プラットフォームがアカウント登録を行うアカウントについては、明細書表記を設定する必要があります。

#### コントローラープロパティを使用した場合

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "controller[stripe_dashboard][type]=none" \
  -d "controller[fees][payer]=application" \
  -d "controller[losses][payments]=application" \
  -d "controller[requirement_collection]=application" \
  -d country=US \
  -d business_type=company \
  -d "business_profile[name]=Runners Club" \
  -d "capabilities[card_payments][requested]=true" \
  -d "capabilities[transfers][requested]=true" \
  -d "settings[payments][statement_descriptor]=RUNNERS CLUB"
```

#### アカウントタイプを使用した場合

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d type=custom \
  -d country=US \
  -d business_type=company \
  -d "business_profile[name]=Runners Club" \
  -d "capabilities[card_payments][requested]=true" \
  -d "capabilities[transfers][requested]=true" \
  -d "settings[payments][statement_descriptor]=RUNNERS CLUB"
```

アカウントの `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 文字のみが送信されます。

顧客の明細書では、次の支払いタイプに対してプラットフォームアカウントの[静的コンポーネント](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account)が使用されます。

- `on_behalf_of` を使用しないデスティネーション支払い
- `on_behalf_of` を指定しない支払いと送金別方式

顧客の明細書では、次の支払いタイプに対して連結アカウントの[静的コンポーネント](https://docs.stripe.com/connect/statement-descriptors.md#set-the-static-component-for-a-connected-account)が使用されます。

- ダイレクト支払い
- `on_behalf_of` によるデスティネーション支払い
- `on_behalf_of` を指定した支払いと送金別方式

連結アカウントから静的コンポーネントを使用するには、アカウントに `card_payments` ケイパビリティが必要です。

> API バージョン `2019-02-19` 以降では、`/v1/charges` の [`statement_descriptor`](https://docs.stripe.com/api/charges/create.md#create_charge-statement_descriptor) パラメーターは動的コンポーネントとして扱われます。これは、`statement_descriptor_suffix` を提供するのと同等です。
> 
> `statement_descriptor_suffix` と `statement_descriptor` の両方を指定した場合は、`statement_descriptor_suffix` のみが使用されます。
> 
> `2019-02-19` より前の API バージョンでは、`/v1/charges` の明細書表記パラメーターは無視され、プラットフォームの静的な明細書表記が使用されます。

明細書表記とともに、事業者に関する追加情報も送信されて、顧客の明細書に表示されます (住所、メールアドレス、電話番号、URL など)。追加情報のデフォルト値は、アカウントの [business_profile](https://docs.stripe.com/api/accounts/object.md#account_object-business_profile) のサポートプロパティです。サポートフィールドが指定されていない場合は、プラットフォームのサポートフィールドが使用されます。プラットフォームのサポートフィールドが指定されていない場合は、代わりにアカウントの会社情報が使用されます。

### on_behalf_of の動作

`on_behalf_of` が設定されている支払いの場合、明細書表記と事業情報は、まず指定されたアカウントから探します。その情報が設定されていない場合は、プラットフォームの情報が使用されます。

- 支払いに動的コンポーネントがある場合、連結アカウントの [settings.card_payments.statement_descriptor_prefix](https://docs.stripe.com/api/accounts/object.md#account_object-settings-payments-statement_descriptor_prefix) 静的コンポーネントが使用されます。連結アカウントに明細書表記のプレフィックスが設定されていない場合は、代わりにプラットフォームの明細書表記のプレフィックスが使用されます。
- 連結アカウントのビジネスプロフィール情報が設定されていない場合は、代わりにプラットフォームの情報が使用されます (最初にプラットフォームのビジネスプロフィール、次にプラットフォームの会社情報が使用されます)。たとえば、連結アカウントに `support_phone` が設定されていない場合、プラットフォームの `support_phone` または会社の電話番号が使用されます。

連結アカウントの静的な明細書表記を使用する支払いで動的なサフィックスを使用する場合は、明細書表記全体が意図したとおりに表示されるように、連結アカウントにプレフィックスを設定することをお勧めします。

#### コントローラープロパティを使用した場合

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "controller[stripe_dashboard][type]=none" \
  -d "controller[fees][payer]=application" \
  -d "controller[losses][payments]=application" \
  -d "controller[requirement_collection]=application" \
  -d country=US \
  -d business_type=company \
  -d "capabilities[card_payments][requested]=true" \
  -d "capabilities[transfers][requested]=true" \
  -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB"
```

#### アカウントタイプを使用した場合

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d type=custom \
  -d country=US \
  -d business_type=company \
  -d "capabilities[card_payments][requested]=true" \
  -d "capabilities[transfers][requested]=true" \
  -d "settings[card_payments][statement_descriptor_prefix]=RUNCLUB"
```

静的なプレフィックスは 2 ～ 10 文字で指定する必要があります。カードネットワークは、明細書表記全体の最初の 22 文字のみ (静的なプレフィックスと動的なサフィックスを結合する `*` 記号とスペースを含む) を受け取ります。

明細書表記とプレフィックスの両方を設定して、支払いの明細書表記を柔軟に設定できます。カード支払いに明細書表記が設定され、プレフィックスが設定されていない場合、Stripe は必要に応じてアカウントの明細書表記を切り詰めてプレフィックス値を設定します。

## 連結アカウントの支払いに使用される動的なサフィックスの設定

動的なサフィックスは、PaymentIntents [statement_descriptor_suffix](https://docs.stripe.com/api/payment_intents/object.md?api-version=preview) パラメータを使用したカード支払いでのみサポートされます。[動的サフィックス](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic)の詳細を確認するか、[ダッシュボード](https://dashboard.stripe.com/settings/public)で連結された明細書表記をご覧ください。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d "statement_descriptor_suffix=Custom suffix"
```

## 日本語の明細書表記を設定する

日本の連結アカウントには、漢字とカナの明細書表記の静的なコンポーネントを設定することをお勧めします。日本の連結アカウントを作成する際に、すべての表記とそれに対応するプレフィックスを設定できます。

#### コントローラープロパティを使用した場合

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "controller[stripe_dashboard][type]=none" \
  -d "controller[fees][payer]=application" \
  -d "controller[losses][payments]=application" \
  -d "controller[requirement_collection]=application" \
  -d country=JP \
  -d business_type=company \
  -d "capabilities[card_payments][requested]=true" \
  -d "capabilities[transfers][requested]=true" \
  -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \
  -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \
  -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \
  -d "settings[payments][statement_descriptor]=example descriptor" \
  -d "settings[payments][statement_descriptor_kanji]=漢字明細" \
  -d "settings[payments][statement_descriptor_kana]=カナメイサイ"
```

#### アカウントタイプを使用した場合

```curl
curl https://api.stripe.com/v1/accounts \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d type=custom \
  -d country=JP \
  -d business_type=company \
  -d "capabilities[card_payments][requested]=true" \
  -d "capabilities[transfers][requested]=true" \
  -d "settings[card_payments][statement_descriptor_prefix]=example prefix" \
  -d "settings[card_payments][statement_descriptor_prefix_kanji]=漢字プリフィックス" \
  -d "settings[card_payments][statement_descriptor_prefix_kana]=カナプリフィックス" \
  -d "settings[payments][statement_descriptor]=example descriptor" \
  -d "settings[payments][statement_descriptor_kanji]=漢字明細" \
  -d "settings[payments][statement_descriptor_kana]=カナメイサイ"
```

カード支払いを作成するときに、[payment_method_options[card][statement_descriptor_suffix_kanji]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kanji) および [payment_method_options[card][statement_descriptor_suffix_kana]](https://docs.stripe.com/api/payment_intents/create.md?api-version=preview#create_payment_intent-payment_method_options-card-statement_descriptor_suffix_kana) を使用して動的な漢字とカナのサフィックスを設定できます。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=jpy \
  -d "payment_method_types[]=card" \
  -d "statement_descriptor_suffix=example descriptor" \
  -d "payment_method_options[card][statement_descriptor_suffix_kanji]=漢字サフィックス" \
  -d "payment_method_options[card][statement_descriptor_suffix_kana]=カナサフィックス"
```

詳細については、[日本語の明細書表記](https://docs.stripe.com/get-started/account/statement-descriptors.md#set-japanese-statement-descriptors)をご覧ください。