# Recibos por correo electrónico Envía automáticamente recibos y facturas pagadas. # Checkout Sessions API You can manually or automatically send customized email receipts or [paid invoices](https://docs.stripe.com/payments/advanced/receipts.md#customizing-receipts-embedded-components). Learn more about [receipts for payments](https://docs.stripe.com/receipts.md). ## Automatically send receipts Para activar los recibos automáticos, activa la opción **Pagos correctos** en la [configuración de los correos electrónicos a los clientes](https://dashboard.stripe.com/settings/emails). Solo se envían recibos cuando el pago se ha realizado correctamente. No se envían recibos en caso de pagos rechazados o rechazados. ## Personaliza recibos Modifica el aspecto y las funciones de tus recibos con las siguientes opciones de personalización: - **Marca**: modifica el logotipo y los colores en la [configuración de la marca](https://dashboard.stripe.com/settings/branding). El límite superior de tamaño para un archivo de imagen de logotipo personalizado es de 512 KB. Lo ideal es que el logotipo sea una imagen cuadrada que supere los 128 x 128 píxeles. Se admiten archivos JPG, PNG y GIF. - **Información pública**: especifica la información pública que quieres incluir, como tu número de contacto o la dirección de tu sitio web, en la [configuración de datos públicos](https://dashboard.stripe.com/settings/public). Para mostrar texto personalizado, usa el atributo [payment_intent_data.description](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-payment_intent_data-description) en la [Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md). Algunos ejemplos incluyen: - Descripción de los bienes o servicios proporcionados - Código de autorización - Información de suscripción - Políticas de cancelaciones Puedes ver una vista previa en tiempo real de tu recibo de correo electrónico en la página Configuración de imagen de marca del Dashboard. Para enviar un recibo de prueba, coloca el cursor sobre la imagen de vista previa, haz clic en **Enviar recibo de prueba** e introduce tu dirección de correo electrónico. > Los recibos extraen datos del objeto `Charge` generado cuando se confirma el PaymentIntent. Para actualizar los datos del recibo, como `description`, después de generar el cargo, debes [actualizar el cargo](https://docs.stripe.com/api/charges/update.md). Los cambios en un PaymentIntent confirmado no aparecen en los recibos. ## Automatically send paid invoices Además de los recibos normales, puedes configurar Checkout Session para que genere facturas pagadas como prueba de pago. Las facturas contienen más información que los recibos. En el caso de las suscripciones, Stripe genera las facturas automáticamente, pero para los pagos únicos, debes activarlas. > La creación de facturas para pagos únicos a través de la [API Checkout Sessions](https://docs.stripe.com/api/checkout/sessions.md) no es una función de [Invoicing](https://stripe.com/invoicing) y tiene un precio aparte. Revisa [este artículo de soporte](https://support.stripe.com/questions/pricing-for-post-payment-invoices-for-one-time-purchases-via-checkout-and-payment-links) para obtener más información. Para generar facturas, selecciona **Pagos realizados** en la sección **Notificar a los clientes por correo electrónico sobre** dentro de la [configuración de correos electrónicos a los clientes](https://dashboard.stripe.com/settings/emails). A continuación, establece [invoice_creation[enabled]](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-invoice_creation-enabled) en `true` al crear una Checkout Session. ```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=elements \ --data-urlencode "return_url=https://example.com" ``` Después de que se complete el pago, Stripe envía un resumen de la factura con enlaces para descargar la factura en PDF y el recibo de la factura a la dirección de correo electrónico que proporciona el cliente durante el proceso de pago. > Las facturas correspondientes a los métodos de pago con notificación diferida pueden tardar más en enviarse, ya que las emitimos una vez que el pago se ha completado con éxito, y no al finalizar la sesión de proceso de compra. Estos métodos de pagos incluyen [adeudo directo Bacs](https://docs.stripe.com/payments/bacs-debit/accept-a-payment.md), [Transferencias bancaria](https://docs.stripe.com/payments/bank-transfers/accept-a-payment.md), [Boleto](https://docs.stripe.com/payments/boleto/accept-a-payment.md), [débitos canadienses autorizados previamente](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), [adeudo directo SEPA](https://docs.stripe.com/payments/sepa-debit/accept-a-payment.md), y [ACH Direct Debit](https://docs.stripe.com/payments/ach-direct-debit/accept-a-payment.md). ![Captura de pantalla de la factura en PDF que los clientes pueden descargar desde el correo electrónico de resumen de la factura](https://b.stripecdn.com/docs-statics-srv/assets/invoice.9e44668032383601eeec362f38293b7a.png) The downloadable invoice PDF ![Captura de pantalla del recibo de la factura que los clientes pueden descargar desde el correo electrónico de resumen de la factura](https://b.stripecdn.com/docs-statics-srv/assets/invoice_receipt.4f120ee7363f8e7728fa553a8a24aae3.png) The downloadable invoice receipt ![Captura de pantalla del correo electrónico de resumen de la factura que envía Stripe](https://b.stripecdn.com/docs-statics-srv/assets/email.560c2666905531b907f7fcd4f1a0a6dd.png) El correo electrónico del cliente con enlaces a la factura en PDF y el recibo También puedes ver la factura en el [Dashboard](https://dashboard.stripe.com/invoices) o acceder a ella mediante programación escuchando el evento [invoice.paid](https://docs.stripe.com/api/events/types.md#event_types-invoice.paid) a través de un [destino de evento](https://docs.stripe.com/event-destinations.md). Puedes usar el hash `invoice_data` dentro de `invoice_creation` para personalizar aún más la factura generada por la sesión de Checkout. ```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=elements \ --data-urlencode "return_url=https://example.com" ``` Review [invoice best practices](https://docs.stripe.com/invoicing/customize.md) 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 Al utilizar Checkout Sessions, el idioma del recibo y la factura está determinado por varios factores: > #### Usa la API Accounts v2 para representar a los clientes > > La API Accounts v2 suele estar disponible para los usuarios de Connect y en vista previa pública para otros usuarios de Stripe. Si tienes acceso a la vista previa de Accounts v2, debes especificar [vista previa](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) en tu código. > > Para solicitar acceso a la vista previa de Accounts v2, > > En la mayoría de los casos de uso, recomendamos [modelar a tus clientes como objetos Cuenta](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) configurados por el cliente en lugar de usar objetos [Cliente](https://docs.stripe.com/api/customers.md). - If you set a customer, we use the language specified in the [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) attribute of a customer-configured `Account` or the [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) attribute of a `Customer`, if available. - If you set a customer without any preferred locales, we apply the [language setting](https://dashboard.stripe.com/settings/emails) from the Dashboard. - If you don’t set a customer at all, the language defaults to the browser locale of the user opening the Checkout Session URL. # Payment Intents API Con los pagos que utilizan *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) y la [API Payment Intents](https://docs.stripe.com/api/payment_intents.md), puedes enviar recibos personalizados por correo electrónico de forma manual o automática. Más información sobre los [recibos de los pagos](https://docs.stripe.com/receipts.md). ## Envía recibos de forma automática To enable automated receipts, toggle **Successful payments** on in your [customer emails settings](https://dashboard.stripe.com/settings/emails). Only a successful payment triggers a receipt. Failed or declined payments don’t send a receipt. Opcionalmente, puedes especificar un [receipt_email](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-receipt_email) cuando creas un *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). Si lo haces, Stripe envía un recibo a esa dirección además de la dirección de correo electrónico del cliente y cualquier [destinatario adicional](https://docs.stripe.com/invoicing/send-email.md#additional-email-recipients) configurado para el cliente. No enviamos un recibo a una dirección de correo electrónico incluida en el [PaymentMethod billing_details](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-billing_details-email) de un pago. ```curl curl https://api.stripe.com/v1/payment_intents \ -u "<>:" \ -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" ``` El recibo muestra el importe, la [información pública de tu empresa](https://dashboard.stripe.com/settings/public) y cualquier valor en el parámetro `description` de la petición. Los recibos de pagos únicos solo incluyen esta información. No puedes añadir partidas individuales adicionales. Para activar un recibo automático después de que se complete un pago, actualiza el [receipt_email](https://docs.stripe.com/api/payment_intents/confirm.md#confirm_payment_intent-receipt_email) del PaymentIntent. ## Personaliza recibos Modifica el aspecto y las funciones de tus recibos con las siguientes opciones de personalización: - **Marca**: modifica el logotipo y los colores en la [configuración de la marca](https://dashboard.stripe.com/settings/branding). El límite superior de tamaño para un archivo de imagen de logotipo personalizado es de 512 KB. Lo ideal es que el logotipo sea una imagen cuadrada que supere los 128 x 128 píxeles. Se admiten archivos JPG, PNG y GIF. - **Información pública**: especifica la información pública que quieres incluir, como tu número de contacto o la dirección de tu sitio web, en la [configuración de datos públicos](https://dashboard.stripe.com/settings/public). Para mostrar texto personalizado, utiliza el atributo [description](https://docs.stripe.com/api/payment_intents/create.md#create_payment_intent-description) en el [PaymentIntent](https://docs.stripe.com/api/payment_intents/object.md). Algunos ejemplos incluyen: - Descripción de los bienes o servicios proporcionados - Código de autorización - Información de suscripción - Políticas de cancelaciones Puedes ver una vista previa en tiempo real de tu recibo de correo electrónico en la página Configuración de imagen de marca del Dashboard. Para enviar un recibo de prueba, coloca el cursor sobre la imagen de vista previa, haz clic en **Enviar recibo de prueba** e introduce tu dirección de correo electrónico. > Los recibos extraen datos del objeto `Charge` generado cuando se confirma el PaymentIntent. Para actualizar los datos del recibo, como `description`, después de generar el cargo, debes [actualizar el cargo](https://docs.stripe.com/api/charges/update.md). Los cambios en un PaymentIntent confirmado no aparecen en los recibos. ## Envía automáticamente facturas pagadas La [API Payment Intents](https://docs.stripe.com/payments/payment-intents.md) no puede generar facturas. Usa Stripe Billing para [crear directamente la factura](https://docs.stripe.com/invoicing/integration/quickstart.md). ## Localización Cuando se usa la API Payment Intents, el idioma del recibo viene determinado por varios factores: > #### Usa la API Accounts v2 para representar a los clientes > > La API Accounts v2 suele estar disponible para los usuarios de Connect y en vista previa pública para otros usuarios de Stripe. Si tienes acceso a la vista previa de Accounts v2, debes especificar [vista previa](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) en tu código. > > Para solicitar acceso a la vista previa de Accounts v2, > > En la mayoría de los casos de uso, recomendamos [modelar a tus clientes como objetos Cuenta](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) configurados por el cliente en lugar de usar objetos [Cliente](https://docs.stripe.com/api/customers.md). - If you set a customer, we use the language specified in the [defaults.locales](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-defaults-locales) attribute of a customer-configured `Account` or the [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales) attribute of a `Customer`, if available. - If you set a customer without any preferred locales, or if you don’t set a customer at all, we apply the [language setting](https://dashboard.stripe.com/settings/emails) from the Dashboard.