# Usar Boleto con facturas Descubre cómo usar Boleto con facturas > #### Usa la API Accounts v2 para representar a los clientes > > La API Accounts v2 suele estar disponible para usuarios Connect y en versión preliminar pública para otros usuarios de Stripe. Si eres parte de la versión preliminar Accounts v2, debes especificar una [versión preliminar](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) en tu código. > > Para solicitar el acceso a la versión preliminar Accounts v2, > > Para la mayoría de los casos de uso, te recomendamos que[modeles a tus clientes como objetos Account configurados por el cliente](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) en lugar de usar objetos [Customer](https://docs.stripe.com/api/customers.md). Infórmate sobre cómo configurar [Boleto](https://docs.stripe.com/payments/boleto.md) como *método de pago* (PaymentMethods represent your customer's payment instruments, used with the Payment Intents or Setup Intents APIs). Boleto es un vale con un número que los *Customers* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) pueden obtener en un cajero automático, un banco, el portal en línea de un banco o una agencia autorizada. ## Habilitar correos electrónicos de Boleto Antes de que comiences con tu integración, ve a **Gestionar pagos que requieren confirmación** en la [configuración de suscripciones y correos electrónicos](https://dashboard.stripe.com/settings/billing/automatic) y habilita **Enviar un enlace alojado por Stripe para que los clientes confirmen sus pagos cuando sea necesario**. ## Decidir el método de cobro Puedes definir el método de cobro en el Dashboard o en la [API](https://docs.stripe.com/api/invoices/create.md#create_invoice-collection_method). Para las facturas, puedes elegir enviar una factura o cobrarle a tu cliente automáticamente. Si usas la API, los valores `send_invoice` y `charge_automatically` determinan el método de cobro. | | Enviar la factura | Cobrar automáticamente | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Cuándo usar | - Tu cliente no ha definido su método de pago preferido para pagar facturas o suscripciones. En este caso, lo conveniente es darle la opción de usar una tarjeta de crédito o Boleto. - Te faltan datos importantes del cliente que se necesitan para usar Boleto (nombre completo, dirección e identificación fiscal). | - Tu cliente ya ha elegido pagar sus facturas o suscripciones con Boleto. - Tienes los datos del cliente necesarios para crear una factura que utilice Boleto (nombre completo, dirección e identificación fiscal). | | Experiencia del cliente | - Tu cliente debe volver a ingresar sus datos personales (nombre completo, dirección e identificación fiscal) cada vez que envías una nueva factura o en cada período nuevo del servicio de suscripción. Este método de cobro no tiene en cuenta el método de pago predeterminado asociado a ese cliente. | - Tu cliente tiene configurado Boleto como método de pago predeterminado. El cliente recibe un correo electrónico con un vale de Boleto cada vez que le envías una factura o hay un período de servicio de suscripción. | | Fechas límite y vencimiento | - La factura debe contener una fecha de vencimiento. - Stripe crea el Boleto, independientemente de la fecha de vencimiento de la factura, tan pronto como tu cliente ingresa los datos necesarios. Debido a que cada Boleto tiene su propia fecha de vencimiento (el valor predeterminado es 3 días), la fecha de vencimiento de la factura y la fecha de vencimiento del Boleto no necesariamente coincidirán. El Boleto puede vencer antes o después de la factura. | - La factura no tiene fecha de vencimiento. - Stripe crea Boleto cuando el comerciante crea la factura con una fecha de vencimiento seleccionada (el valor predeterminado es 3 días). | ## Crear un cliente Crea un cliente por cada empresa o usuario nuevo al que le quieras facturar. Al crear un cliente nuevo, define un [perfil básico de cliente](https://docs.stripe.com/payments/boleto/set-up-invoices.md#customer-profile) que te ayude a generar facturas más útiles y habilita Smart Retries (si eres usuario de [Invoicing Plus](https://stripe.com/invoicing/pricing)). Después de configurar el cliente, podrás emitir facturas únicas o crear *suscripciones* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis). > Antes de crear un nuevo cliente, asegúrate de que el cliente no exista en el Dashboard. Si creas varias entradas de clientes para el mismo cliente, puedes tener problemas más adelante, por ejemplo, cuando necesites conciliar el historial de transacciones o coordinar los métodos de pago guardados. #### Dashboard Puedes crear y administrar clientes en la [página Clientes](https://dashboard.stripe.com/customers) cuando no quieras usar código para crear clientes o si quieres facturarle a un cliente de forma manual con una factura por única vez. También puedes crear un cliente en el Dashboard cuando se crea la factura. ### Crear un cliente Cuando creas un cliente nuevo, puedes definir los datos de facturación y de la cuenta, como el **correo electrónico**, el **nombre** y el **país**. También puedes establecer la moneda y el idioma preferidos del cliente, además de cualquier otro dato relevante. Para crear un cliente, sigue estos pasos: 1. Verifica que el cliente no exista. 1. En la página **Clientes**, haz click en **Agregar cliente** o presiona la tecla **N**. 1. Como mínimo, ingresa el **nombre** y el **correo electrónico de la cuenta** de tu cliente. 1. En el cuadro de diálogo, haz click en **Agregar cliente**. ### Editar un cliente Para editar el perfil de un cliente, sigue estos pasos: 1. En la página **Clientes**, busca el cliente que quieras modificar y haz click en su nombre. 1. En la página de datos de la cuenta, haz click en **Acciones** > **Editar información**. 1. Modifica el perfil del cliente. 1. Haz click en **Actualizar cliente**. ### Eliminar un cliente Para eliminar un cliente, sigue estos pasos: 1. En la página **Clientes**, busca el cliente que quieras eliminar. 1. Haz click en la casilla que se encuentra al lado del nombre del cliente y luego en **Eliminar**. También puedes ir a la página de datos del cliente y seleccionar **Acciones** > **Eliminar cliente**. #### API Antes de crear un nuevo cliente, verifica que no exista ese cliente. Por ejemplo, especifica una dirección de correo electrónico a la API para [enumerar todos los clientes](https://docs.stripe.com/api/customers/list.md). ```curl curl -G https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={EMAIL_ADDRESS} ``` Aprende a crear un cliente nuevo que use el método de pago Boleto. Consulta [crear un cliente](https://docs.stripe.com/api/customers/create.md) para ver más detalles. #### Enviar una factura por correo electrónico ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=joao@exemplo.com" \ -d "description=My first test customer" ``` #### Cobrar a los clientes automáticamente ### Configurar el cliente Para crear un cliente con `name`, `email` y `description`, agrega este código: ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ -d "name=João da Silva" \ --data-urlencode "email=joao@exemplo.com" \ -d "description=My first test customer" ``` ### Crear el método de pago Boleto Para crear el método de pago Boleto, agrega este código: ```curl curl https://api.stripe.com/v1/payment_methods \ -u "<>:" \ -d type=boleto \ -d "boleto[tax_id]=000.000.000-00" \ -d "billing_details[name]=João da Silva" \ --data-urlencode "billing_details[email]=joao@exemplo.com" \ -d "billing_details[address][line1]=1234 Av. Paulista" \ -d "billing_details[address][city]=São Paulo" \ -d "billing_details[address][state]=SP" \ -d "billing_details[address][postal_code]=01310-000" \ -d "billing_details[address][country]=BR" ``` ### Asocia el método de pago Boleto a un cliente Para asociar el método de pago Boleto al cliente, agrega este código: ```curl curl https://api.stripe.com/v1/payment_methods/{{PAYMENT_METHOD_ID}}/attach \ -u "<>:" \ -d customer={{CUSTOMER_ID}} ``` ### Configura el método de pago predeterminado del cliente Para que Boleto sea el método de pago predeterminado de tu cliente, agrega este código: ```curl curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \ -u "<>:" \ -d "invoice_settings[default_payment_method]={{PAYMENT_ID}}" ``` ## Crear un producto y un precio Define todas tus ofertas comerciales y de productos en un solo lugar. Los *productos* (Products represent what your business sells—whether that's a good or a service) definen lo que vendes y los *precios* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions) indican cuánto y con qué frecuencia se debe cobrar. Esta es una entidad básica dentro de Stripe que funciona con *suscripciones* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis), *facturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) y [Checkout](https://docs.stripe.com/payments/checkout.md). Los precios habilitan los siguientes casos de uso: - Un proveedor de software que cobra el costo único de instalación siempre que un usuario crea una nueva suscripción. - Una tienda de comercio electrónico que hace envíos recurrentes de una caja de productos por USD 10 por mes y quiere ofrecerles a sus clientes la posibilidad de comprar complementos por única vez. - Una empresa de servicios profesionales que ahora puede crear una lista de servicios estándar desde donde escoger los ítems de cada factura en lugar de completar la factura a mano - Una organización sin fines de lucro que permite a los donantes definir un importe de donación recurrente por cliente. Puedes gestionar tu catálogo de productos con productos y precios. Los productos definen lo que vendes y los precios, cuánto y con qué frecuencia cobrar. Gestiona tus productos y sus precios en el Dashboard o a través de la API. #### Dashboard Si usaste el Dashboard en un *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) para configurar tu empresa, puedes copiar cada uno de tus productos y pasarlos a modo activo usando **Copiar a modo activo** en la [página del Product catalog](https://dashboard.stripe.com/products). Usa nuestras bibliotecas oficiales para acceder a la API de Stripe desde tu aplicación. 1. Ve a la página **Catálogo de productos** y haz clic en **Agregar producto**. 1. Selecciona si quieres crear un **Producto único** o un **Producto recurrente**. 1. Dale un nombre a tu producto y asígnale un precio. #### API Aprende a crear [Productos](https://docs.stripe.com/api/products.md) y [Precios](https://docs.stripe.com/api/prices.md). > Para informarte sobre cómo empezar a usar la [CLI de Stripe](https://docs.stripe.com/stripe-cli.md) o la API, consulta la [Guía completa de integración de Invoicing](https://docs.stripe.com/invoicing/integration.md). ### Crear un producto Para crear un producto, ingresa su nombre: ```curl curl https://api.stripe.com/v1/products \ -u "<>:" \ -d "name=Gold Special" ``` ### Crear un precio [Precios](https://docs.stripe.com/api.md#prices) define cuánto cobrar por los productos y con qué frecuencia. Esto incluye cuánto cuesta el producto, qué moneda usar y el intervalo de facturación (cuando el precio es de una suscripción). Al igual que sucede con los productos, si tienes pocos precios, es preferible gestionarlos en el Dashboard. Usa el importe unitario para expresar los precios en la unidad más baja de la moneda, en este caso, centavos (USD 10 son 1,000 centavos, por lo que el importe unitario es 1000). Como alternativa, si no necesitas crear un precio para tu producto, puedes usar el parámetro [amount](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-amount) durante la creación de la partida de factura. Para crear el precio y asignarlo al producto, especifica el ID de producto, el importe unitario y la moneda. En el siguiente ejemplo, el precio del producto “Gold Special“ es de USD 10: ```curl curl https://api.stripe.com/v1/prices \ -u "<>:" \ -d "product={{PRODUCT_ID}}" \ -d unit_amount=1000 \ -d currency=usd ``` > #### Precios localizados > > Cuando [creas partidas de factura](https://docs.stripe.com/api/invoiceitems/create.md) o cargos con la API, Stripe procesa el monto y las monedas que proporcionas de forma explícita. El precio localizado no se calcula automáticamente, y eres responsable de pasar el monto y las monedas correctas para la región de tu cliente. Recomendamos usar el parámetro [pricing.price](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-pricing-price) con el fin de pasar el ID de precio. ## Crear y enviar una factura Para crear y enviar una factura, completa estos pasos: #### Dashboard 1. En el Dashboard, ve a la página [Resumen de facturas](https://dashboard.stripe.com/invoices) y luego haz clic en **Crear factura** para abrir el [editor de facturas](https://dashboard.stripe.com/invoices/create). Cada vez que sales del editor de facturas, Stripe guarda un borrador. Para eliminar un borrador de factura, haz clic en el menú de contenido adicional (⋯) que se encuentra junto con una factura en la [página Facturas](https://dashboard.stripe.com/invoices). 1. Introduce el nombre de un cliente que ya existe para seleccionarlo. 1. En la sección **Ítems**, selecciona el producto e introduce la **cantidad**. Stripe automáticamente completa el precio del producto según lo que hayas establecido cuando creaste el producto. 1. (Opcional) Haz clic en **Opciones de ítems** si necesitas agregar una tasa impositiva, un cupón o una fecha de suministro. También puedes usar la Dashboard para crear una [tasa impositiva](https://dashboard.stripe.com/tax-rates) o un [cupón](https://dashboard.stripe.com/coupons/create). 1. (Opcional) Utiliza la casilla **Nota** para proporcionar más información a tu cliente. Para editar la nota de una factura, debes hacer clic en **Editar nota** en la página de datos de esa factura. 1. Selecciona la siguiente opción de envío de facturas dependiendo de si quieres enviar la factura o cobrarle a tu cliente de forma automática: > Si quieres cobrar automáticamente a tu cliente con Boleto, ve a la [página Clientes](https://dashboard.stripe.com/customers), haz clic en el cliente y selecciona **Agregar Boleto** en Métodos de pago. - **Cobrar automáticamente a un método de pago guardado**: Carga de inmediato el importe de la factura en el método de pago que tienes archivado para el cliente. (Selecciona **Boleto** como método de pago). - **Enviar factura por correo electrónico con enlace**: Le permite a Stripe enviar un correo electrónico con una página de pago y una factura en PDF. (Selecciona **Boleto** y **tarjeta** como opciones de pago). 1. (Opcional) Para programar esta factura para que [finalice automáticamente](https://docs.stripe.com/invoicing/scheduled-finalization.md) en una fecha futura, selecciona **Programar fecha de envío**. O bien, según lo que hayas seleccionado en el paso anterior, **Programar fecha de pago** o **Programar fecha de finalización**. 1. (Opcional) Expande el menú **Opciones avanzadas** y agrega [campos personalizados](https://docs.stripe.com/invoicing/customize.md#custom-fields). También puedes elegir si quieres que los precios de los ítems **incluyan o excluyan impuestos**. Para obtener más información, consulta [Precios netos e impuestos](https://docs.stripe.com/invoicing/taxes.md#net-price-taxes). Expande el menú **Opciones avanzadas** y agrega [campos personalizados](https://docs.stripe.com/invoicing/customize.md#custom-fields). 1. Haz clic en **Revisar factura** y decide si quieres incluir más correos electrónicos o seguir editando. Envía la factura. Si le cobras automáticamente a tu cliente, aun así tendrá que pagar el Boleto para que el pago se efectúe correctamente (sin importar que la factura se haya finalizado). Stripe le envía al cliente un correo electrónico con un enlace que podrá usar para efectuar el pago con Boleto. ![](https://d37ugbyn3rpeym.cloudfront.net/videos/invoice-editor-net-price-supply-date.mp4) #### API ### Crear una factura Si necesitas facturarle a un cliente, debes crear un ítem de factura donde se especifique el ID del cliente, la moneda y el precio. Entonces, podrás crear la factura del cliente, y el ítem de factura se agregará automáticamente. Para simplificar el ejemplo, establecimos `auto_advance` en `true`. Esto significa que Stripe finaliza automáticamente la factura después de unas horas, con lo que queda lista para el pago. Stripe no envía correos electrónicos en un *entorno de prueba* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), pero puedes verificar que Stripe creó la factura consultando la [página Facturas](https://dashboard.stripe.com/test/invoices) en el Dashboard. La página **Facturas** muestra el estado **Programada** al lado de la factura hasta su finalización automática. Antes de finalizar la factura, decide cómo quieres que pague el cliente usando el parámetro [collection_method](https://docs.stripe.com/api/invoices/object.md#invoice_object-collection_method). Puedes enviar un correo electrónico a tu cliente (`send_invoice`) o cobrarle automáticamente (`charge_automatically`). Si utilizas `send_invoice`, especifica el parámetro [days_until_due](https://docs.stripe.com/api/invoices/create.md#create_invoice-days_until_due) para que Stripe pueda marcar una factura como vencida. Cuando envías una factura, Stripe se la envía al cliente por correo electrónico junto con las instrucciones de pago. > La cantidad máxima de partidas de factura es 250. Al crear una factura se agregan hasta 250 partidas de factura pendientes; el resto se agregará en la próxima factura. Para ver las partidas de factura pendientes de tu cliente, ve a la página **Datos del cliente** o establece el atributo [pending](https://docs.stripe.com/api/invoiceitems/list.md#list_invoiceitems-pending) en `true` cuando uses la API para enumerar todas las partidas de la factura. #### Enviar una factura por correo electrónico ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "pricing[price]={{PRICE_ID}}" ``` ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d collection_method=send_invoice \ -d "payment_settings[payment_method_types][]=card" \ -d "payment_settings[payment_method_types][]=boleto" \ -d days_until_due=3 ``` Si estableces `auto_advance` en `false`, puedes seguir modificando la factura hasta su [finalización](https://docs.stripe.com/invoicing/integration/workflow-transitions.md). Para finalizar una factura en borrador, usa el Dashboard, envíasela al cliente o págala. También puedes utilizar la API [Finalize an invoice](https://docs.stripe.com/api/invoices/finalize.md): ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" ``` Si creaste una factura por error, puedes [anularla](https://docs.stripe.com/invoicing/overview.md#void). También puedes marcar una factura como [incobrable](https://docs.stripe.com/invoicing/overview.md#uncollectible). #### Cobrar a los clientes automáticamente ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d "pricing[price]={{PRICE_ID}}" ``` ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d customer={{CUSTOMER_ID}} \ -d collection_method=charge_automatically \ -d auto_advance=true ``` Si estableces `auto_advance` en `false`, puedes seguir modificando la factura hasta su [finalización](https://docs.stripe.com/invoicing/integration/workflow-transitions.md). Para finalizar una factura en borrador, usa el Dashboard, envíasela al cliente o págala. También puedes utilizar la API [Finalize an invoice](https://docs.stripe.com/api/invoices/finalize.md): ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" ``` Si creaste la factura por error, puedes [anularla](https://docs.stripe.com/invoicing/overview.md#void). También puedes marcar una factura como [incobrable](https://docs.stripe.com/invoicing/overview.md#uncollectible). ### Enviar una factura Envía la factura a la dirección de correo electrónico asociada al cliente. Stripe finaliza la factura tan pronto como la envías. Muchas jurisdicciones consideran las facturas finalizadas como un documento legal, por lo que algunos campos no pueden cambiarse. Si envías facturas que ya se pagaron, el correo electrónico no hará mención del pago. > Si envias facturas que ya se pagaron, el correo electrónico no hará mención del pago. Stripe envía las facturas a la dirección de correo electrónico asociada al cliente. ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/send \ -u "<>:" ``` ## See also - [Cómo funciona Invoicing](https://docs.stripe.com/invoicing/overview.md)