# メール領収書

領収書と支払い済みの請求書を自動的に送信します。

# Checkout Sessions API

> This is a Checkout Sessions API for when payment-ui is embedded-components. View the full page at https://docs.stripe.com/payments/advanced/receipts?payment-ui=embedded-components.

カスタマイズしたメールの領収書または[支払い済みの請求書](https://docs.stripe.com/payments/advanced/receipts.md#customizing-receipts-embedded-components)は、手動または自動で送信できます。[決済の領収書](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 Session では、通常の領収書のほかに、決済の証明として支払い済みの請求書を生成できます。請求書には領収書より多くの情報が記載されます。サブスクリプションの場合は 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 Session の作成時に [invoice_creation [enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation-enabled) を `true` に設定してください。

```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=elements \
  --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 Session で生成された請求書をさらにカスタマイズできます。

```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=elements \
  --data-urlencode "return_url=https://example.com"
```

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

## ローカライゼーション

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

> #### 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 を開くユーザーのブラウザーロケールになります。


# Payment Intents API

> This is a Payment Intents API for when payment-ui is elements. View the full page at https://docs.stripe.com/payments/advanced/receipts?payment-ui=elements.

*Elements* (A set of UI components for building a web checkout flow. They adapt to your customer's locale, validate input, and use tokenization, keeping sensitive customer data from touching your server) と [Payment Intents API](https://docs.stripe.com/api/payment_intents.md) を使用した支払いでは、カスタムのメール領収書を手動または自動で送信できます。[支払いの領収書](https://docs.stripe.com/receipts.md)についての詳細は、こちらのドキュメントをご覧ください。

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

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

*PaymentIntent* (The Payment Intents API tracks the lifecycle of a customer checkout flow and triggers additional authentication steps when required by regulatory mandates, custom Radar fraud rules, or redirect-based payment methods)の作成時にオプションで[receipt_email](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-receipt_email)を指定できます。その場合、Stripe は顧客のメールアドレスと顧客に設定されている[追加のメールアドレス受取人](https://docs.stripe.com/invoicing/send-email.md#additional-email-recipients)に加えて、そのアドレスに領収書を送信します。決済の [PaymentMethod billing_details](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-billing_details-email) に含まれるメールアドレスに領収書は送信されません。

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  --data-urlencode "description=Thanks for your purchase!" \
  --data-urlencode "receipt_email=Sent.in.addition.to.customer.email.addresses@example.com"
```

領収書には、金額、貴社の[公開している事業情報](https://dashboard.stripe.com/settings/public)、リクエストの `description` パラメーターの値が表示されます。1 回限りの支払いの領収書には、この情報のみが含まれます。ラインアイテムを追加することはできません。

支払いの完了後に自動的に領収書をトリガーするには、PaymentIntent の [receipt_email](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-receipt_email) を更新します。

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

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

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

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

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

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

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

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

[Payment Intents API](https://docs.stripe.com/payments/payment-intents.md) では請求書を生成できません。Stripe Billing を使用して、直接[請求書を作成](https://docs.stripe.com/invoicing/integration/quickstart.md)してください。

## 地域に合わせた対応

Payment Intents API を使用する場合、領収書の言語はいくつかの要因によって決まります。

> #### 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) が適用されます。