Using AI coding agents like Claude Code or Cursor? Try the official Chargebee Agent Skills to speed up your development.Try now
ChargebeeAPI

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

Sample Result[JSON]

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=10000

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
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

quote
Quote object
Resource object representing quote
quoted_charge
Quoted charge object
Resource object representing quoted_charge