Defines the object schema located at components.schemas.order in the specification.
An Order describes a purchase being made by a customer, including the products & quantities being purchased, the order status, the payment information, and the billing/shipping details.
Related guide: Orders overview
Constructors
OrderorderAmountSubtotal :: Intamount_subtotal: Order cost before any discounts or taxes are applied. A positive integer representing the subtotal of the order in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).
orderAmountTotal :: Intamount_total: Total order cost after discounts and taxes are applied. A positive integer representing the cost of the order in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). To submit an order, the total must be either 0 or at least $0.50 USD or equivalent in charge currency.
orderApplication :: Maybe (Nullable OrderApplication'NonNullableVariants)application: ID of the Connect application that created the Order, if any.
orderAutomaticTax :: Maybe OrdersV2ResourceAutomaticTaxautomatic_tax:
orderBillingDetails :: Maybe (Nullable OrderBillingDetails'NonNullable)billing_details: Customer billing details associated with the order.
orderClientSecret :: Maybe (Nullable Text)client_secret: The client secret of this Order. Used for client-side retrieval using a publishable key.
The client secret can be used to complete a payment for an Order from your frontend. It should not be stored, logged, embedded in URLs, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret.
Refer to our docs for creating and processing an order to learn about how client_secret should be handled.
Constraints:
Maximum length of 5000
orderCreated :: Intcreated: Time at which the object was created. Measured in seconds since the Unix epoch.
orderCurrency :: Textcurrency: Three-letter ISO currency code, in lowercase. Must be a supported currency.
orderCustomer :: Maybe (Nullable OrderCustomer'NonNullableVariants)customer: The customer which this orders belongs to.
orderDescription :: Maybe (Nullable Text)description: An arbitrary string attached to the object. Often useful for displaying to users.
Constraints:
Maximum length of 5000
orderDiscounts :: Maybe (Nullable [OrderDiscounts'NonNullableVariants])discounts: The discounts applied to the order. Use `expand[]=discounts` to expand each discount.
orderId :: Textid: Unique identifier for the object.
Constraints:
Maximum length of 5000
orderIpAddress :: Maybe (Nullable Text)ip_address: A recent IP address of the purchaser used for tax reporting and tax location inference.
Constraints:
Maximum length of 5000
orderLineItems :: Maybe OrderLineItems'line_items: A list of line items the customer is ordering. Each line item includes information about the product, the quantity, and the resulting cost. There is a maximum of 100 line items.
orderLivemode :: Boollivemode: Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
orderMetadata :: Maybe (Nullable Object)metadata: Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
orderPayment :: OrdersV2ResourcePaymentpayment:
orderShippingCost :: Maybe (Nullable OrderShippingCost'NonNullable)shipping_cost: The details of the customer cost of shipping, including the customer chosen ShippingRate.
orderShippingDetails :: Maybe (Nullable OrderShippingDetails'NonNullable)shipping_details: Customer shipping information associated with the order.
orderStatus :: OrderStatus'status: The overall status of the order.
orderTaxDetails :: Maybe OrdersV2ResourceTaxDetailstax_details:
orderTotalDetails :: OrdersV2ResourceTotalDetailstotal_details: