Contents

Order

The order’s details, including information about the products or services rendered, customer service, and fulfillment.

Declaration

object Order

Properties

NameTypeDescription
createdAt Requireddate-time

The date and time when the customer created the order, in RFC 3339 format.

merchant RequiredMerchant

The merchant for this order.

orderIdentifier Requiredstring

A unique order identifier scoped to your order type identifier. In combination with the order type identifier, this uniquely identifies an order within the system and isn’t displayed to the user.

orderManagementURL Requireduri

A URL where the customer can manage the order.

orderType Requiredstring

The type of order this bundle represents. Currently the only supported value is ecommerce.

orderTypeIdentifier Requiredstring

An identifier for the order type associated with the order. The value must correspond with your signing certificate and isn’t displayed to the user.

status Requiredstring

A high-level status of the order, used for display purposes. The system considers orders with status completed or cancelled closed.

schemaVersion Requirednumber

The version of the schema used for the order. The current version is 1.

updatedAt Requireddate-time

The date and time when the order was last updated, in RFC 3339 format. This should equal the createdAt time, if the order hasn’t had any updates. Must be monotonically increasing. Consider using a hybrid logical clock if your web service can’t make that guarantee.

associatedApplications[Application]

A list of associated applications, in order of preference. The device uses the first available application.

associatedApplicationIdentifiers[string]

The application identifier associated with the order.

authenticationTokenstring

The authentication token supplied to your web service. Required if you provide a web service.

barcodeBarcode

An identifier containing information about an order.

changeNotificationsstring

A property that describes whether the device notifies the user about relevant changes to the order. The default is enabled.

customerCustomer

The customer for this order.

fulfillments[*]

A list of fulfillments. The device displays fulfillments in the order provided.

lineItems[LineItem]

The items contained in the order, displayed in the order provided.

orderNumberstring

If available, an order number or reference suitable for display to the user.

orderProviderOrderProvider

Information about the platform providing the order data. Use this field if the order data isn’t provided by the merchant, but by a third party.

paymentPayment

The payment for this order.

returnInfoReturnInfo

The information related to a partial or full return.

returns[Return]

A list of returns. The device displays returns in the order provided.

statusDescriptionstring

A localized message describing the order status.

webServiceURLuri

The URL of your web service. This must begin with HTTPS://.

Mentioned in

Topics

Supporting objects

See Also

Essentials