メール領収書

You can manually or automatically send customized email receipts or paid invoices. Learn more about receipts for payments.

Automatically send receipts

To enable automated receipts, toggle Successful payments on in your Customer emails settings. Receipts are only sent for a successful payment. Receipts aren’t sent for failed or declined payments.

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

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

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

カスタムテキストを表示するには、Checkout セッション の payment_intent_data.description 属性を使用します。たとえば、次のようなものがあります。

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

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

Automatically send paid invoices

In addition to ordinary receipts, you can configure the Checkout Session to generate paid invoices as proof of payment. Invoices have more information than receipts. For subscriptions, Stripe generates invoices automatically, but for one-time payments, you need to enable them.

To generate invoices, select Successful payments under Email customers about in your Customer emails settings. Then, set invoice_creation[enabled] to true when creating a Checkout Session.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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=custom \
  --data-urlencode return_url="https://example.com"

After the payment completes, Stripe sends an invoice summary with links to download the invoice PDF and invoice receipt to the email address your customer provides during checkout.

The downloadable invoice PDF

The downloadable invoice receipt

The customer email with links to the invoice PDF and receipt

You can also view the invoice in the Dashboard or access it programmatically by listening to the invoice.paid event through an event destination.

You can use the invoice_data hash inside invoice_creation to further customize the invoice generated by the Checkout Session.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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=custom \
  --data-urlencode return_url="https://example.com"

Review invoice best practices for your region to make sure you’re collecting the right information from your customers. Information like the customer’s billing and shipping addresses, phone number, and tax ID appear on the resulting invoice.

Localization

When using Checkout Sessions, the language of the receipt and invoice is determined by several factors:

• If you set a Customer, their preferred locale is used if available.
• If you set a Customer without any preferred locales, we apply the language setting from the Dashboard.