Create quote for one-time charges

Idempotency Supported

Creates a quote for one-time charges and non-recurring addons. This is applicable only for one-time payment. Recurring charges are not permitted in this quote; use Create quote for a new subscription or Create quote for updating a subscription instead.

To send this quote, use "Send Email" quote action in the Chargebee application.

Based on the customer's reply, you can use Update quote status and Convert a quote APIs for changing quote status and invoicing the customer, respectively.

Sample Request

URL Format

POST https://[site].chargebee.com/api/v2/quotes/create_for_onetime_charges

Input Parameters

name

optional, string, max chars=100

The quote name will be used as the pdf name of the quote.

customer_id

required, string, max chars=50

Identifier of the customer for which the quote needs to be created.

po_number

optional, string, max chars=100

Purchase Order Number for this quote.

notes

optional, string, max chars=2000

Notes specific to this quote that you want customers to see on the quote PDF.

expires_at

optional, timestamp(UTC) in seconds

Quotes will be valid till this date. After this quote will be marked as closed.

currency_code

required if Multicurrency is enabled, string, max chars=3

The currency code (ISO 4217 format) of the quote.

coupon

optional, string, max chars=100

The 'One Time' coupon to be applied.

coupon_ids

optional, string, max chars=100

List of Coupons to be added.

shipping_address[0..n]

Parameters for shipping_address

pass parameters as shipping_address[<param name>]

addons[0..n]

Parameters for addons. Multiple addons can be passed by specifying unique indices.

pass parameters as addons[<param name>][<idx:0..n>]

charges[0..n]

Parameters for charges. Multiple charges can be passed by specifying unique indices.

pass parameters as charges[<param name>][<idx:0..n>]

tax_providers_fields[0..n]

Parameters for tax_providers_fields. Multiple tax_providers_fields can be passed by specifying unique indices.

pass parameters as tax_providers_fields[<param name>][<idx:0..n>]

Returns

quoteQuote object

Resource object representing quote

quoted_chargeQuoted charge object

Resource object representing quoted_charge