Create and send a quote

​​To create a quote, pass in a line item for each product or service. Attach a Customer object to the quote to represent the customer. After you create the customer, store the id in your database so you can use it later. In the next step, you’ll use the customer to create a quote.

To create a quote, pass in the Customer and Line items. You can use prices to model the offerings that your business provides. Learn how to set up your product catalog to use prices with quotes.

You can add each offering from your business to the quote as a line item by specifying the price and quantity. For example, if you were to create a quote for a monthly software license that comes with a one-time consultation fee to install the software, the quote would contain two line items:

• The first line item represents five licenses of the 100 USD per month per license cost of the software.
• The second line item represents the one-time 1000 USD consultation fee.

A newly created quote has a draft status. You can modify draft quotes by adding or removing line items.

curl https://api.stripe.com/v1/quotes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=cus_GBV60HKsE0mb5v \
  -d "line_items[0][price]"=price_CBb6IXqvTLXp3f \
  -d "line_items[0][quantity]"=5 \
  -d "line_items[1][price]"=price_HGd7M3DV3IMXkC

When you’re ready to send the quote to your customer, you can move it to an open state by finalizing the quote. Because the quote is for a specific customer, you must attach a Customer object to it before it can transition to the new state.

curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/finalize \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"

After you finalize a quote, you can download the PDF, which contains an overview of the quote. Attach it to an email and send it to your customer.

curl https://files.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/pdf \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -G

You can also set a header, footer and description on your quote, which the PDF displays. You can specify the default settings for the header, footer and description in the Quote template. Remember to keep the quote in an open state while your customer reviews it.

​​After the customer agrees to the quote, move it to the accepted state, which automatically creates an invoice or subscription (depending on whether or not you’ve added line items with a recurring price). When you use a quote for one-time payments, Stripe creates an invoice in the draft state. You can make modifications to your invoice before sending it to your customer.

curl -X POST https://api.stripe.com/v1/quotes/qt_1HDGlYClCIKljWvsIGaAA06B/accept \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:"