# 明細書表記

明細書表記の仕組みをご紹介します。

連結アカウントの明細書表記の設定については、[連結アカウントの明細書表記を設定](https://docs.stripe.com/connect/statement-descriptors.md)をご覧ください。

明細書表記は、銀行明細書上で請求や支払いを説明します。明確で正確な明細書表記を使用することで、チャージバックや不審請求の申請を減らすことができます。銀行やカードネットワークでは、顧客が明細書を理解できるように特定の情報を含めることが求められており、明細書表記はこの情報を提供します。

Stripe アカウント[を設定する](https://docs.stripe.com/get-started/account/set-up.md#public-business-information)際、すべての顧客のカード利用明細に表示される単一の明細書表記 (静的な明細書表記) を設定できます。カード請求については、アカウントに関連付けられた静的なプレフィックスに加えて、各決済に関連付けられた動的なサフィックスを含む明細書表記を作成することもできます。これにより、銀行またはカード利用明細に表示する商品、サービス、または決済の詳細を指定できます。

大半の銀行はこの情報を一貫して表示しますが、一部の銀行では表示が不正確であったり、まったく表示されないこともあります。

## 明細書表記の要件

完全な明細書表記 (1 つの静的な表記またはプレフィックスとサフィックスの組み合わせ) は、次の要件を満たす必要があります。

- アルファベットのみを含む。
- 5 ～ 22 文字を含む。
- 最低でも 1 文字を含む (プレフィックスとサフィックスを使用する場合、それぞれに 1 文字以上が必要)。
- 特殊文字 (`<`、`>`、`\`、`'` `"` `*`) を含まない。
- 商号 (DBA) を反映している。
- 共通の規約または共通のウェブサイト URL を複数含む。ウェブサイト URL が顧客の明細書に明確で正確な取引の説明を提供する場合には、ウェブサイト URL だけでもかまいません。

ダッシュボードで短縮表記とも呼ばれる静的なプレフィックスは、2 ～ 10 文字である必要があります。残りの文字は、動的なサフィックスに割り当てられます。

## 固定の明細書表記またはプレフィックスを設定する

[ダッシュボード](https://dashboard.stripe.com/settings/business-details)で固定の明細書表記または短縮明細書表記のプレフィックスを設定します。この値は、カード以外の請求または決済について、すべての顧客の利用明細に表示されます。

以下の場合には、静的な明細書表記で十分です。

- お客様のビジネスで提供する商品やサービスが 1 つのみの場合。
- 顧客が、お客様とのすべての取引で静的な値を把握している場合。
- お客様がすべての取引に同じ明細書表記を使用することを希望する場合。

カード支払いにおいて以下の場合には、動的なサフィックスを静的なプレフィックスに追加することを検討します。

- ビジネスで複数の商品やサービスを提供している場合。
- 顧客が、お客様とのすべての取引で使用される単一の値を理解できない可能性がある場合。
- 明細書表記で取引固有の詳細を提供したい場合。

カード以外の請求の明細書表記と、カード決済の短縮明細書表記のプレフィックスの両方を設定できます。

固定の明細書表記を設定し、プレフィックスを設定しない場合、Stripe は固定の明細書表記をカード決済のプレフィックスとして使用します。10 文字を超える場合は、文字数制限に収まるように切り詰めます。

## 動的なサフィックスを設定する

動的なサフィックスは、カード支払いのみでサポートされています。サフィックスを使用して取引の詳細を指定すると、顧客は明細書を見て取引を明確に理解できます。サフィックスには、プレフィックス、`*` 記号、およびスペースが連結され、顧客に表示される完全な明細書表記を構成します。

連結された明細書表記の長さは、`*` 記号とスペースを含めて 22 文字以内にします。たとえば、プレフィックスが `RUNCLUB` (7 文字) の場合、動的なサフィックスに含めることができるのは最大 13 文字で、`9-22-19 10K` (11 文字)、`OCT MARATHON` (12 文字) などになります。この場合、生成される明細書表記は、`RUNCLUB* 9-22-19 10K` または `RUNCLUB* OCT MARATHON` になります。

`PaymentIntent` の [statement_descriptor_suffix](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-statement_descriptor_suffix) パラメータにサフィックスを指定します:

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d "automatic_payment_methods[enabled]=true" \
  -d "statement_descriptor_suffix=example descriptor"
```

*Checkout* (A low-code payment integration that creates a customizable form for collecting payments. You can embed Checkout directly in your website, redirect customers to a Stripe-hosted payment page, or create a customized checkout page with Stripe Elements) を使用する場合は、`CheckoutSession` の [payment_intent_data.statement_descriptor_suffix](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-statement_descriptor_suffix) パラメータにサフィックスを指定します。

## デフォルトの明細書表記を上書きする

### 1 回限りの決済

カード以外の決済の固定の明細書表記は、`PaymentIntent` の作成時に [statement_descriptor](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-statement_descriptor) の値を指定して上書きできます。

カード決済では、`statement_descriptor` は指定できません。指定できるのは `statement_descriptor_suffix` のみです。

### サブスクリプションと請求書

Stripe はサブスクリプション決済を自動的に作成するため、関連付けられた `PaymentIntent` では `statement_descriptor` または `statement_descriptor_suffix` を設定できません。サブスクリプションまたは請求書の決済でデフォルトの明細書表記を上書きするには、次のいずれかを行います。

- `Invoice` を更新して、[statement_descriptor](https://docs.stripe.com/api/invoices/update.md#update_invoice-statement_descriptor) を指定します。
- `statement_descriptor` は、`Product` を[作成](https://docs.stripe.com/api/products/create.md#create_product-statement_descriptor)または[更新](https://docs.stripe.com/api/products/update.md#update_product-statement_descriptor)するときに指定します。

> #### 請求書の更新
> 
> 通常、確定済みの[サブスクリプション請求書](https://docs.stripe.com/billing/invoices/subscription.md)は編集できません。サブスクリプション請求書にカスタムの明細書表記を追加するには、`Subscription` の [collection_method](https://docs.stripe.com/api/subscriptions/create.md#create_subscription-collection_method) を `send_invoice` に設定します。また、`Invoice` の [auto_advance](https://docs.stripe.com/api/invoices/update.md#update_invoice-auto_advance) を false に設定する必要がある場合もあります。

サブスクリプション決済の作成時、Stripe は次の優先順位で明細書表記を選択します。

1. `Invoice` で定義されている。
2. `Product` で定義されたもの。これには、請求書に含まれる `Plan` または `Price` に関連付けられた `Product` も含まれます。`Subscription` に複数の項目が含まれる場合、Stripe はカスタムの明細書表記が設定されている [items.data](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items-data) 配列の最初の項目を使用します (`Invoice` の `lines.data` 配列ではありません)。
3. 決済方式のデフォルトの明細書表記。

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

日本の企業は、漢字とカナの明細書表記を設定することができます。混乱やチャージバックを減らすために、明確で理解しやすい明細書表記を提供することは重要です。サポートされている 3 種類のすべてのスクリプト (漢字、カナ、アルファベット) で明細書表記を設定することをお勧めします。

アカウントの [静的](https://docs.stripe.com/get-started/account/statement-descriptors.md#static) な漢字とカナの明細書表記と短縮表記 (プレフィックス) は、[ダッシュボード](https://dashboard.stripe.com/settings/business-details) で変更できます。

カード決済では、[動的サフィックス](https://docs.stripe.com/get-started/account/statement-descriptors.md#dynamic)を `PaymentIntents` と `CheckoutSessions` で漢字とカナに設定できます。カード会員に表示される完全な明細書表記は、`statement_descriptor_suffix` と同様に、短縮明細書表記のプレフィックスと区切り文字を連結して計算されます。

次の例は、`PaymentIntent` で漢字とカナのサフィックスを設定する方法を示しています。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=jpy \
  -d "automatic_payment_methods[enabled]=true" \
  -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#requirements)と共通していますが、次の表は、漢字とカナの表記に関する追加の要件を示しています。

|  | 漢字 | カナ |
| --- | --- | --- |
| 最大合計長 | 17 | 22 |
| プレフィックスの最小長 | 1 | 2 |
| プレフィックスの最大長 | 10 | 10 |
| サポートされている文字のタイプ | 漢字、カナ、アルファベット | カナ |
| 検証規則 | `< > \ ' " * ＊`は使用できません | カナ、スペース、ダッシュ、ドットのみを使用できます |

> 合計の長さは、静的な表記または連結された表記 (プレフィックス + 区切り文字 + サフィックス) のいずれかの長さです。最大長を超える表記は切り詰められます。

### カード発行会社の動作

日本語の明細書表記は、以下の両方が該当する場合に限り利用できます。

- カードが、日本で発行された Visa または Mastercard である。
- 支払いが、日本の企業によって処理される、または日本の企業の代理で処理される。

適用される料金については、大半のカード発行会社はアルファベットではなく日本語の明細書表記を使用します。ただし、カード保有者の明細書に漢字、カナ、アルファベットのどれが表示されるかは、カード発行会社によって決定されます。

API レスポンスの [calculated_statement_descriptor](https://docs.stripe.com/api/charges/object.md#charge_object-calculated_statement_descriptor) は、常にアルファベットの明細書表記ですが、カード発行会社が日本語の明細書表記を使用できないというわけではありません。

### 明細書表記が表示されるタイミング

漢字とカナの明細書表記は、支払いのキャプチャー時にカード発行会社に送信されます。そのため、カード保有者の明細書に表示されるまでに通常は数日間かかります。その間は、一時的な明細書表記がカード保有者に表示されることがあります。

- **Visa、Mastercard:** 英語の明細書表記。
- **JCB、ダイナースクラブ、ディスカバーカード:** アカウントのデフォルトの明細書表記