# メールの領収書と支払い済みの請求書

支払いと返金の領収書を自動的に送信します。

# ホスト型ページ

> This is a ホスト型ページ for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/receipts?payment-ui=stripe-hosted.

カスタマイズしたメール領収書または[支払い済みの請求書](https://docs.stripe.com/payments/checkout/receipts.md#paid-invoices)を手動または自動で送信できます。詳細は[支払いの領収書](https://docs.stripe.com/receipts.md)をご覧ください。

## 領収書を自動的に送信する

領収書の自動送信を有効にするには、[顧客へのメール設定](https://dashboard.stripe.com/settings/emails)で、**支払い成功**をオンにします。領収書は支払いが成功した場合にのみ送信されます。支払いが失敗または拒否された場合、領収書は送信されません。

## 領収書をカスタマイズする

領収書のデザインと機能を、以下のカスタマイズオプションで変更します。

- **ブランディング**: ロゴと色を[ブランディング設定](https://dashboard.stripe.com/settings/branding)で変更します。カスタムロゴの画像ファイルサイズの上限は 512KB です。理想的には、128 x 128 ピクセルより大きい正方形のロゴ画像を使用してください。サポートされるファイル形式は、JPG、PNG、GIF です。
- **公開情報**: [公開情報の設定](https://dashboard.stripe.com/settings/public)で、電話番号やウェブサイトアドレスなど、含める公開情報を指定します。

カスタムテキストを表示するには、[Checkout セッション](https://docs.stripe.com/api/checkout/sessions/object.md) の [payment_intent_data.description](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-description) 属性を使用します。たとえば、次のようなものがあります。

- 提供された商品またはサービスの説明
- 認証コード
- サブスクリプション情報
- キャンセルポリシー

メール領収書のリアルタイムのプレビューは、ダッシュボードのブランディング設定ページで確認できます。テストの領収書を送信するには、プレビュー画像の上にマウスを合わせて**テスト領収書を送信**をクリックし、メールアドレスを入力します。

> 領収書は、PaymentIntent の確定時に生成された `Charge` オブジェクトからデータを取得します。Charge が生成された後に `description` 値などの領収書データを更新するには、[Charge を更新](https://docs.stripe.com/api/charges/update.md)する必要があります。確定済みの PaymentIntent への変更は、領収書には表示されません。

## 支払い済みの請求書を自動的に送信する

Checkout では、通常の領収書のほかに、支払いの証明として支払い済みの請求書を生成できます。請求書には領収書より多くの情報が記載されます。サブスクリプションの場合は Stripe が請求書を自動的に生成しますが、1 回限りの支払いの場合はお客様が有効にする必要があります。

> [Checkout Sessions API](https://docs.stripe.com/api/checkout/sessions.md) を使用した、1 回限りの支払いに対する請求書の作成は、[Invoicing](https://stripe.com/invoicing) の機能ではないため別途料金がかかります。詳細については、[こちらのサポート記事](https://support.stripe.com/questions/pricing-for-post-payment-invoices-for-one-time-purchases-via-checkout-and-payment-links)をご覧ください。

請求書を生成するには、はじめに[顧客へのメール設定](https://dashboard.stripe.com/settings/emails)で、**顧客へのメール内容**として**支払い成功**を選択します。次に、Checkout セッションの作成時に、[invoice_creation[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation-enabled) を `true` に設定します。

> `payment_intent_data[capture_method]` を `manual` に設定した場合、`invoice_creation` の有効化には対応できません。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d mode=payment \
  -d "invoice_creation[enabled]=true" \
  -d "line_items[0][price]={{ONE_TIME_PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  --data-urlencode "success_url=https://example.com"
```

支払いが完了した後、Stripe は、請求書の PDF と請求書の領収書をダウンロードするリンクが記載された請求書のサマリーを、顧客が購入時に指定したメールアドレスに送信します。

> 支払い通知が遅延する決済方法の場合、請求書の送信に時間がかかることがあります。これは決済セッションが完了した時点ではなく支払いが正常に完了した後で請求書が送信されるためです。こうした決済方法には [Bacs ダイレクトデビット](https://docs.stripe.com/payments/bacs-debit/accept-a-payment.md)、[銀行振込](https://docs.stripe.com/payments/bank-transfers/accept-a-payment.md)、[Boleto](https://docs.stripe.com/payments/boleto/accept-a-payment.md)、[カナダの事前承認デビット](https://docs.stripe.com/payments/acss-debit/accept-a-payment.md)、[コンビニ決済](https://docs.stripe.com/payments/konbini/accept-a-payment.md)、[OXXO](https://docs.stripe.com/payments/oxxo/accept-a-payment.md)、[Pay by Bank](https://docs.stripe.com/payments/pay-by-bank/accept-a-payment.md)、[SEPA ダイレクトデビット](https://docs.stripe.com/payments/sepa-debit/accept-a-payment.md)、[ACH Direct Debit](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md) などがあります。
![顧客が請求書のサマリーメールからダウンロードできる、請求書 PDF のスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/invoice.9e44668032383601eeec362f38293b7a.png)

ダウンロード可能な請求書 PDF
![顧客が請求書のサマリーメールからダウンロードできる、請求書に対する領収書のスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/invoice_receipt.4f120ee7363f8e7728fa553a8a24aae3.png)

ダウンロード可能な請求書の領収書
![Stripe が送信する請求書サマリーメールのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/email.560c2666905531b907f7fcd4f1a0a6dd.png)

請求書 PDF および領収書へのリンクを記載した顧客へのメール

請求書は、[ダッシュボード](https://dashboard.stripe.com/invoices)で表示することも、[イベントの送信先](https://docs.stripe.com/event-destinations.md)を介して [invoice.paid](https://docs.stripe.com/api/events/types.md#event_types-invoice.paid) イベントをリッスンしてプログラムでアクセスすることもできます。

`invoice_creation` 内で `invoice_data` ハッシュを使用して、Checkout セッションで生成された請求書をさらにカスタマイズできます。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d mode=payment \
  -d "invoice_creation[enabled]=true" \
  -d "invoice_creation[invoice_data][description]=Invoice for Product X" \
  -d "invoice_creation[invoice_data][metadata][order]=order-xyz" \
  -d "invoice_creation[invoice_data][account_tax_ids][0]=DE123456789" \
  -d "invoice_creation[invoice_data][custom_fields][0][name]=Purchase Order" \
  -d "invoice_creation[invoice_data][custom_fields][0][value]=PO-XYZ" \
  -d "invoice_creation[invoice_data][rendering_options][amount_tax_display]=include_inclusive_tax" \
  -d "invoice_creation[invoice_data][footer]=B2B Inc." \
  -d "line_items[0][price]={{ONE_TIME_PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  --data-urlencode "success_url=https://example.com"
```

お住まいの地域の[請求書のベストプラクティス](https://docs.stripe.com/invoicing/customize.md)を確認して、顧客から正しい情報を収集していることを確認します。顧客の請求先住所、配送先住所、電話番号、納税者番号などの情報が請求書に表示されます。

## 現地の言語への変更

Checkout セッションを使用する場合、領収書と請求書の言語はいくつかの要因によって決まります。

> #### Accounts v2 API を使用した顧客の表現
> 
> Accounts v2 API では、Connect ユーザーには一般提供され、その他の Stripe ユーザーには公開プレビューで提供されます。Accounts v2 プレビューの一部である場合は、コードで[プレビューバージョン](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning)を指定する必要があります。
> 
> Accounts v2 プレビューへのアクセスをリクエストするには、
> 
> ほとんどのユースケースでは、[Customer](https://docs.stripe.com/api/customers.md) オブジェクトを使用するのではなく、[顧客を顧客設定の Account オブジェクトとしてモデル化する](https://docs.stripe.com/connect/use-accounts-as-customers.md)ことをお勧めします。

- 顧客を設定する場合、顧客設定の `Account` の [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) 属性、または `Customer` の [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) 属性 (利用可能な場合) で指定された言語が使用されます。
- 優先ロケールを指定せずに顧客を設定すると、ダッシュボードの [言語設定](https://dashboard.stripe.com/settings/emails) が適用されます。
- 顧客をまったく設定しない場合、言語のデフォルトは Checkout Session URL を開くユーザーのブラウザーロケールになります。


# 埋め込み型ページ

> This is a 埋め込み型ページ for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/checkout/receipts?payment-ui=embedded-form.

カスタマイズしたメール領収書または[支払い済みの請求書](https://docs.stripe.com/payments/checkout/receipts.md#paid-invoices-embedded-form)を手動または自動で送信できます。詳細は[支払いの領収書](https://docs.stripe.com/receipts.md)をご覧ください。

## 領収書を自動的に送信する

領収書の自動送信を有効にするには、[顧客へのメール設定](https://dashboard.stripe.com/settings/emails)で、**支払い成功**をオンにします。領収書は支払いが成功した場合にのみ送信されます。支払いが失敗または拒否された場合、領収書は送信されません。

## 領収書をカスタマイズする

領収書のデザインと機能を、以下のカスタマイズオプションで変更します。

- **ブランディング**: ロゴと色を[ブランディング設定](https://dashboard.stripe.com/settings/branding)で変更します。カスタムロゴの画像ファイルサイズの上限は 512KB です。理想的には、128 x 128 ピクセルより大きい正方形のロゴ画像を使用してください。サポートされるファイル形式は、JPG、PNG、GIF です。
- **公開情報**: [公開情報の設定](https://dashboard.stripe.com/settings/public)で、電話番号やウェブサイトアドレスなど、含める公開情報を指定します。

カスタムテキストを表示するには、[Checkout セッション](https://docs.stripe.com/api/checkout/sessions/object.md) の [payment_intent_data.description](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-description) 属性を使用します。たとえば、次のようなものがあります。

- 提供された商品またはサービスの説明
- 認証コード
- サブスクリプション情報
- キャンセルポリシー

メール領収書のリアルタイムのプレビューは、ダッシュボードのブランディング設定ページで確認できます。テストの領収書を送信するには、プレビュー画像の上にマウスを合わせて**テスト領収書を送信**をクリックし、メールアドレスを入力します。

> 領収書は、PaymentIntent の確定時に生成された `Charge` オブジェクトからデータを取得します。Charge が生成された後に `description` 値などの領収書データを更新するには、[Charge を更新](https://docs.stripe.com/api/charges/update.md)する必要があります。確定済みの PaymentIntent への変更は、領収書には表示されません。

## 支払い済みの請求書を自動的に送信する

Checkout では、通常の領収書のほかに、支払いの証明として支払い済みの請求書を生成できます。請求書には領収書より多くの情報が記載されます。サブスクリプションの場合は Stripe が請求書を自動的に生成しますが、1 回限りの支払いの場合はお客様が有効にする必要があります。

> [Checkout Sessions API](https://docs.stripe.com/api/checkout/sessions.md) を使用した、1 回限りの支払いに対する請求書の作成は、[Invoicing](https://stripe.com/invoicing) の機能ではないため別途料金がかかります。詳細については、[こちらのサポート記事](https://support.stripe.com/questions/pricing-for-post-payment-invoices-for-one-time-purchases-via-checkout-and-payment-links)をご覧ください。

請求書を生成するには、はじめに[顧客へのメール設定](https://dashboard.stripe.com/settings/emails)で、**顧客へのメール内容**として**支払い成功**を選択します。次に、Checkout セッションの作成時に、[invoice_creation[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation-enabled) を `true` に設定します。

> `payment_intent_data[capture_method]` を `manual` に設定した場合、`invoice_creation` の有効化には対応できません。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d mode=payment \
  -d "invoice_creation[enabled]=true" \
  -d "line_items[0][price]={{ONE_TIME_PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com"
```

支払いが完了した後、Stripe は、請求書の PDF と請求書の領収書をダウンロードするリンクが記載された請求書のサマリーを、顧客が購入時に指定したメールアドレスに送信します。

> 支払い通知が遅延する決済方法の場合、請求書の送信に時間がかかることがあります。これは決済セッションが完了した時点ではなく支払いが正常に完了した後で請求書が送信されるためです。こうした決済方法には [Bacs ダイレクトデビット](https://docs.stripe.com/payments/bacs-debit/accept-a-payment.md)、[銀行振込](https://docs.stripe.com/payments/bank-transfers/accept-a-payment.md)、[Boleto](https://docs.stripe.com/payments/boleto/accept-a-payment.md)、[カナダの事前承認デビット](https://docs.stripe.com/payments/acss-debit/accept-a-payment.md)、[コンビニ決済](https://docs.stripe.com/payments/konbini/accept-a-payment.md)、[OXXO](https://docs.stripe.com/payments/oxxo/accept-a-payment.md)、[Pay by Bank](https://docs.stripe.com/payments/pay-by-bank/accept-a-payment.md)、[SEPA ダイレクトデビット](https://docs.stripe.com/payments/sepa-debit/accept-a-payment.md)、[ACH Direct Debit](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md) などがあります。
![顧客が請求書のサマリーメールからダウンロードできる、請求書 PDF のスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/invoice.9e44668032383601eeec362f38293b7a.png)

ダウンロード可能な請求書 PDF
![顧客が請求書のサマリーメールからダウンロードできる、請求書に対する領収書のスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/invoice_receipt.4f120ee7363f8e7728fa553a8a24aae3.png)

ダウンロード可能な請求書の領収書
![Stripe が送信する請求書サマリーメールのスクリーンショット](https://b.stripecdn.com/docs-statics-srv/assets/email.560c2666905531b907f7fcd4f1a0a6dd.png)

請求書 PDF および領収書へのリンクを記載した顧客へのメール

請求書は、[ダッシュボード](https://dashboard.stripe.com/invoices)で表示することも、[イベントの送信先](https://docs.stripe.com/event-destinations.md)を介して [invoice.paid](https://docs.stripe.com/api/events/types.md#event_types-invoice.paid) イベントをリッスンしてプログラムでアクセスすることもできます。

`invoice_creation` 内で `invoice_data` ハッシュを使用して、Checkout セッションで生成された請求書をさらにカスタマイズできます。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d mode=payment \
  -d "invoice_creation[enabled]=true" \
  -d "invoice_creation[invoice_data][description]=Invoice for Product X" \
  -d "invoice_creation[invoice_data][metadata][order]=order-xyz" \
  -d "invoice_creation[invoice_data][account_tax_ids][0]=DE123456789" \
  -d "invoice_creation[invoice_data][custom_fields][0][name]=Purchase Order" \
  -d "invoice_creation[invoice_data][custom_fields][0][value]=PO-XYZ" \
  -d "invoice_creation[invoice_data][rendering_options][amount_tax_display]=include_inclusive_tax" \
  -d "invoice_creation[invoice_data][footer]=B2B Inc." \
  -d "line_items[0][price]={{ONE_TIME_PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com"
```

お住まいの地域の[請求書のベストプラクティス](https://docs.stripe.com/invoicing/customize.md)を確認して、顧客から正しい情報を収集していることを確認します。顧客の請求先住所、配送先住所、電話番号、納税者番号などの情報が請求書に表示されます。

## 現地の言語への変更

Checkout セッションを使用する場合、領収書と請求書の言語はいくつかの要因によって決まります。

> #### Accounts v2 API を使用した顧客の表現
> 
> Accounts v2 API では、Connect ユーザーには一般提供され、その他の Stripe ユーザーには公開プレビューで提供されます。Accounts v2 プレビューの一部である場合は、コードで[プレビューバージョン](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning)を指定する必要があります。
> 
> Accounts v2 プレビューへのアクセスをリクエストするには、
> 
> ほとんどのユースケースでは、[Customer](https://docs.stripe.com/api/customers.md) オブジェクトを使用するのではなく、[顧客を顧客設定の Account オブジェクトとしてモデル化する](https://docs.stripe.com/connect/use-accounts-as-customers.md)ことをお勧めします。

- 顧客を設定する場合、顧客設定の `Account` の [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) 属性、または `Customer` の [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) 属性 (利用可能な場合) で指定された言語が使用されます。
- 優先ロケールを指定せずに顧客を設定すると、ダッシュボードの [言語設定](https://dashboard.stripe.com/settings/emails) が適用されます。
- 顧客をまったく設定しない場合、言語のデフォルトは Checkout Session URL を開くユーザーのブラウザーロケールになります。


## See also

- [顧客にメールを送信する](https://docs.stripe.com/invoicing/send-email.md)
- [顧客へのメールを自動送信する](https://docs.stripe.com/billing/revenue-recovery/customer-emails.md)
