# 邮件收据和已付账单 自动发送付款和退款收据。 # 完整托管页面 > 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 Session](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` 对象拉取数据。要在生成收款后更新收据数据，如 `description`，必须[更新 Charge](https://docs.stripe.com/api/charges/update.md)。对已确认 PaymentIntent 的更改不会体现在收据上。 ## 自动发送已付账单 除普通收据外，Checkout 还可以生成已付账单作为支付凭证。账单比收据包含的信息多一些。对于订阅，Stripe 会自动生成账单，但对于一次性付款，您需要启用它们。 > 通过 [Checkout Sessions API](https://docs.stripe.com/api/checkout/sessions.md) 创建一次性付款账单不属于 [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`。 > 如果您将 `payment_intent_data[capture_method]` 设置为 `manual`，那不支持 `invoice_creation`。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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)、[Konbini](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 直接借记](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 "<>:" \ -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 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 预览版的访问权限， > > 在大多数应用场景下，我们建议[将您的客户建模为客户配置的 Account 对象](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)，而不是使用 [Customer](https://docs.stripe.com/api/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-page. View the full page at https://docs.stripe.com/payments/checkout/receipts?payment-ui=embedded-page. 您可以手动或自动发送定制的电子邮件收据或[已付款账单](https://docs.stripe.com/payments/checkout/receipts.md#paid-invoices-embedded-page)。了解有关[付款收据](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 Session](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` 对象拉取数据。要在生成收款后更新收据数据，如 `description`，必须[更新 Charge](https://docs.stripe.com/api/charges/update.md)。对已确认 PaymentIntent 的更改不会体现在收据上。 ## 自动发送已付账单 除普通收据外，Checkout 还可以生成已付账单作为支付凭证。账单比收据包含的信息多一些。对于订阅，Stripe 会自动生成账单，但对于一次性付款，您需要启用它们。 > 通过 [Checkout Sessions API](https://docs.stripe.com/api/checkout/sessions.md) 创建一次性付款账单不属于 [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`。 > 如果您将 `payment_intent_data[capture_method]` 设置为 `manual`，那不支持 `invoice_creation`。 ```curl curl https://api.stripe.com/v1/checkout/sessions \ -u "<>:" \ -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)、[Konbini](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 直接借记](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 "<>:" \ -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 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 预览版的访问权限， > > 在大多数应用场景下，我们建议[将您的客户建模为客户配置的 Account 对象](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)，而不是使用 [Customer](https://docs.stripe.com/api/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)