Quote Status Updates

quote.updated

FastSpring sends the quote.updated webhook each time a team member or prospect updates a quote. Status changes include the following:

  • Quote Accepted: Changes from open to pending payment. The prospect accepted the quote, however they have not paid. This can happen when the buyer or seller generates an invoice instead of clicking Pay Now.
  • Quote Canceled : Changes from open or pending payment to canceled. FastSpring cancels the associated order in the app.
  • Quote Completed: Changes from open to completed. The prospect accepted the quote and completed their payment.
  • Quote Expired: Changes from open to expired. After a quote expires, you can create a new quote or change the expiration date to complete the order.
  • Quote Modified via App: A seller updated the quote in the FastSpring app.
  • Quote Modified via API: A seller updated the quote with the /quotes API endpoint.

Contents of Event Payload

Name

Type

Description

quote

string

Internal ID of the quote.

quoteName

string

Name of the quote.

changed

string

Time in which the quote was updated, in milliseconds.

changedInSeconds

string

Time in which the quote was updated, in seconds.

changedDisplay

string

Date in which the quote status changed.

changedTimeDisplay

string

Time in which the quote status changed.

type

string

Type of quote that was generated: Self-Serve or Assisted.

updatedBy

string

The email address of the sales representative or seller who updated the quote.

order

string

Internal order ID.

order reference

string

Order Reference Number.

order status

string

The current status of the order. Possible values include:
OPEN
AWAITING_PAYMENT
COMPLETED
EXPIRED
CANCELED

invoiceURL

string

URL of the customer-facing invoice for this order.

reason

string

Reason approval is required for the order.

creator

string

The email address of the sales representative or seller who created the quote.

quoteStatus

string

The current status of the quote. Possible values include:
OPEN
AWAITING_PAYMENT
COMPLETED
EXPIRED
CANCELED

language

string

2 character ISO code of the language associated with the quote.

quoteCurrency

string

3 character ISO code of the order currency.

quoteURL

string

URL of the customer-facing quote for this order.

account

string

FastSpring-generated customer account ID.

coupon

array

The Coupon ID applied to the quote.

recipient

array

Prospect information.

   first

string

The prospect's first name.

   last

string

The prospect's last name.

   email

string

The prospect's email address.

   company

string

The company that the prospect associates with.

   phone

string

The prospect's phone number.

   vatID

string

The prospect’s VAT ID (if applicable).

address

array

The prospect’s physical address.

fulfillmentSetting

string

Displays the fulfillment type.

notes

string

External-facing notes on the quote.

tags

object

Tags associated with the quote.

items

array

Products included in the quote.

   product

string

Product path (product ID) of the product on the quote.

   quantity

string

Quantity of the product on the quote.

   display

string

Prospect-facing display name of the product.

   subtotal

string

Subtotal of the specific item.

   subtotalDisplay

string

Subtotal with currency.

   discount

string

Discount on particular item.

   discountDisplay

string

Discount with currency.

Example

{
   "quote":"QUUWOACS4PXFFGPFFM6AKNBTJ3P4",
   "quoteName":"Quote for Company",
   "changed":1617927858699,
   "changedInSeconds":1617927858,
   "changedDisplay":"04/09/21",
   "changedTimeDisplay":"00:24:18 UTC",
   "type":"Assisted",
   "updatedBy":"[email protected]",
   "order":"yUIaT8yzSJew_IUCS5uhew",
   "order reference":"SAL210409-7545-63119",
   "order status":"AWAITING_PAYMENT",
"invoiceUrl":"https://store.onfastspring.com/popup-defaultB2B/account/order/SAL210409-7545-63119/invoice",
   "Reason":"Quote Accepted",
   "creator":"[email protected]",
   "quoteStatus":"AWAITING_PAYMENT",
   "language":"en",
   "quoteCurrency":"USD",
"quoteUrl":"https://store.onfastspring.com/popup-defaultB2B/account/order/quote/QUUWOACS4PXFFGPFFM6AKNBTJ3P4",
   "account":"M72EC3GtSfagETDA6lmBXw",
   "coupon":"10OFF",
   "recipient":{
      "first":"Name",
      "last":"Name",
      "email":"[email protected]",
      "company":"FastSpring",
      "phone":"",
      "vatID":null
   },
   "address":{
      "addressLine1":"123 Main St",
      "city":"SANTA BARBARA",
      "region":"California",
      "postalCode":"93101",
      "country":"US",
      "display":"123 Main St, SANTA BARBARA, California, 93101, US"
   },
   "fulfillmentSetting":"ON PAYMENT",
   "notes":"Terms & Conditions of Sale",
   "tags":{
      
   },
   "items":[
      {
         "product":"agency",
         "quantity":1,
         "display":"Active Product",
         "subtotal":100.0,
         "subtotalDisplay":"$100.0",
         "discount":"10",
         "discountDisplay":"$10"
      }
   ]
}

Did this page help you?