Create an order draft

Authorizations

Authorization

string

header

required

Include the Bearer<token> header where the <token> is the authentication token generated from the Getting Started with fabric APIs process.

Headers

x-fabric-tenant-id

string

required

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

x-fabric-request-id

string

Unique request ID for tracking.

x-fabric-channel-id

string

required

x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.

Path Parameters

cartId

string

required

The 24-character system-generated Cart ID. This ID is generated using the Create cart endpoint.

Body

application/json

Order draft request body

orderSequence

object

An order sequence is used to define a pattern or template for generating unique order numbers. This object contains the order sequence name and identifier.

Show child attributes

orderSequence.sequenceName

string

Sequence configuration name

Example:

"STORE_ORDER_NUMBER"

orderSequence.sequenceKey

string

Sequence identifier

Example:

"SHOPZ"

orderNumber

string

Order number based on the order sequence.

Example:

"SHOPZ0000001"

Response

Order draft created successfully

order

object

Order information

Show child attributes

order.id

string

Identifier of an order draft to create an order.

Example:

"6d65755f-b1d9-4c9d-bb5b-118d317f8db4"

order.number

string

Order number

Example:

"100001"

order.lineItems

object[]

An array containing items with associated custom data.

Show child attributes

order.lineItems.id

string

required

The unique identifier of the item.

Example:

"6d65755f-b1d9-4c9d-bb5b-118d317f8db4"

order.lineItems.supplementaryData

object

Additional data for the item, such as product attributes.

Show child attributes

order.lineItems.supplementaryData.{key}

object

Additional data for the item, such as product attributes.

Example:

{ "productTitle": "Lamp" }

Example:

{ "productTitle": "Lamp" }

order.attributes

object

Custom attributes, such as order status.

Show child attributes

order.attributes.{key}

object

Custom attributes, such as order status.

Example:

{ "orderStatus": "ACTIVE" }

Example:

{ "orderStatus": "ACTIVE" }

cartId

string

The unique identifier of the cart that was passed in the parameter.

Example:

"4ed2e918-fb5b-47ed-bca3-da514b6aa6bf"

attributes

object

Custom attributes used to describe the cart, such as a wishlist cart.

Show child attributes

attributes.{key}

string

Example:

{ "attr1": "attrValue" }

customerContext

object

Customer context object containing customer information.

Show child attributes

customerContext.id

string

The Customer ID that was added to the customer attribute when using the Update customer endpoint.

Example:

"109840938"

customerContext.segments

object[]

An array containing segments of customer information.

Show child attributes

customerContext.segments.name

string

Segment name

Example:

"membership"

customerContext.segments.value

string[]

Segment values

Example:

["gold", "silver"]

customerContext.attributes

object

Customer attributes such as email.

Show child attributes

customerContext.attributes.{key}

object

Customer attributes such as email.

Example:

{ "email": "[email protected]" }

Example:

{ "email": "[email protected]" }

customerContext.sessionId

string

Session ID of the customer.

Example:

"3a5fd2d3-5c96-4e57-b069-7ff2a88c1119"

status

enum<string>

The cart status indicates whether the cart is active or deleted.

Available options:

ACTIVE,

SOFT_DELETE

Example:

"ACTIVE"

state

object[]

The resource state is stored in an array that holds information about the current status of the cart.

Show child attributes

state.resource

enum<string>

The type of resource indicating its current state, such as a cart.

Available options:

ITEM,

CART,

FULFILLMENT,

PAYMENT,

FEE,

VALIDATION

Example:

"CART"

state.resourceId

string

The ID used to reference the resource's state, such as a cart.

Example:

"c86f777b-1885-4ddf-961d-542ba80a69b8"

state.key

string

The key used to map the state of the resource.

Example:

"MISSING_PAYMENT_DETAILS"

state.description

string

A detailed description of the resource's current state, such as the absence of payment details.

Example:

"No payment details have been added to this Cart"

price

object

The sum of the total amount of the cart.

Show child attributes

price.total

number<float>

The grand total, inclusive of all charges and discounts.

Example:

1570

price.subtotal

number<float>

The subtotal of all items.

Example:

1530

price.tax

number<float>

The total tax calculated amount.

Example:

0

price.fulfillments

number<float>

The total fulfillments amount.

Example:

40

price.discounts

number<float>

The total discounts amount.

Example:

0

price.fees

number<float>

The total fees amount.

Example:

0

price.adjustments

number<float>

The total adjustments amount.

Example:

0

promotions

object

A collection of promotions applied to the cart.

Show child attributes

promotions.total

number<float>

The total value of all applied promotions.

Example:

0

promotions.collection

object[]

An array containing promotions in the collection.

Show child attributes

promotions.collection.id

string

The unique identifier of the promotion.

Example:

"6626c179627d450008a5b202"

promotions.collection.title

string

Promotion title

Example:

"Cart Promotion Fixed Price"

promotions.collection.type

string

The type of promotion, such as percentage or fixed value.

Example:

"QUANTITY"

promotions.collection.value

number<float>

The value of the promotion, indicating the amount of the discount applied. This can be a fixed amount or a percentage.

Example:

10

promotions.collection.attributes

object

Custom attributes provide more context for the promotion.

Show child attributes

promotions.collection.attributes.{key}

string

Example:

{ "promotionStack": "HIGHEST" }

fees

object

A collection of fees associated with the cart.

Show child attributes

fees.id

string

The unique identifier of the fee associated with the cart that was generated when making Create fee endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

fees.name

string

Name of the fee

Example:

"Eco Fee"

fees.price

object

Price details

Show child attributes

fees.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

fees.taxable

boolean

A boolean value that determines whether a fee is taxable.

Example:

true

fees.attributes

object

Custom attributes that provide more context for the fee, such as the source of the fee.

Show child attributes

fees.attributes.{key}

object

Custom attributes that provide more context for the fee, such as the source of the fee.

Example:

{ "source": "eco" }

Example:

{ "source": "eco" }

fees.tax

object

A collection of taxes.

Show child attributes

fees.tax.total

number

Tax total in the collection.

Example:

3

fees.tax.collection

object[]

An array containing taxes in a collection.

Show child attributes

fees.tax.collection.amount

number

Tax amount

Example:

3

fees.tax.collection.attributes

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Show child attributes

fees.tax.collection.attributes.{key}

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Example:

{ "rate": "5.0", "type": "COUNTY" }

Example:

{ "rate": "5.0", "type": "COUNTY" }

fees.updatedAt

string

The date and time when the fee was last updated.

Example:

"2024-06-13T16:50:00.682Z"

fees.createdAt

string

The date and time when the fee was created.

Example:

"2024-06-13T16:50:00.682Z"

fees.taxDetails

object

Tax details used to determine tax for a cart fee.

Show child attributes

fees.taxDetails.destinationAddress

string

The destination address where the item will be delivered.

Example:

"c86f777b-1885-4ddf-961d-542ba80a69b8"

fees.taxDetails.originAddress

string

The origin address from which the item will be fulfilled.

Example:

"c86f777b-1885-4ddf-961d-542ba80a69b8"

adjustments

object

A collection of adjustments made to the cart.

Show child attributes

adjustments.total

number

Adjustments total in a collection.

Example:

2

adjustments.collection

object[]

An array containing adjustments in the collection.

Show child attributes

adjustments.collection.id

string

The Adjustment ID generated when an adjustment was created using the Create adjustment endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

adjustments.collection.price

object

Price details

Show child attributes

adjustments.collection.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

adjustments.collection.reason

string

The reason for the adjustment.

Example:

"Price adjustment from customer representative."

adjustments.collection.attributes

object

Custom attributes used for price adjustments.

Show child attributes

adjustments.collection.attributes.{key}

object

Custom attributes used for price adjustments.

Example:

{ "source": "CSR" }

Example:

{ "source": "CSR" }

adjustments.collection.updatedAt

string

The date and time when the adjustment was last updated.

Example:

"2024-06-13T16:50:00.682Z"

adjustments.collection.createdAt

string

The date and time when the adjustment was created.

Example:

"2024-06-13T16:50:00.682Z"

addresses

object

A map of addresses added to the cart.

Show child attributes

addresses.a8577d7f0d4d4b228e857b4a2e90dc93

object

Address

Show child attributes

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.id

string

The Address ID generated when an address was created using the Create address endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.name

object

Show child attributes

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.name.first

string

First name

Example:

"John"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.name.last

string

Last name

Example:

"Doe"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.email

string

Example:

"[email protected]"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.phone

object

Show child attributes

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.phone.number

string

Phone number

Example:

"1234567890"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.phone.type

string

Type of phone number (e.g., MOBILE, HOME)

Example:

"MOBILE"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.addressLine1

string

Address line 1

Example:

"123 Park Road"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.addressLine2

string

Address line 2

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.addressLine3

string

Address line 3

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.addressLine4

string

Address line 4

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.city

string

City

Example:

"Santa Cruz"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.region

string

State, Province or Area

Example:

"California"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.country

string

Country

Example:

"USA"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.postalCode

string

Postal code or zip code

Example:

"12345"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.updatedAt

string

The date and time the address was last updated.

Example:

"2024-06-13T16:50:00.682Z"

addresses.a8577d7f0d4d4b228e857b4a2e90dc93.createdAt

string

The date and time the address was created.

Example:

"2024-06-13T16:50:00.682Z"

lineItems

object

A collection of items in the cart.

Show child attributes

lineItems.total

number

Item total in a collection.

Example:

100

lineItems.collection

object[]

An array containing items in the collection.

Show child attributes

lineItems.collection.id

string

The unique identifier of the item.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

lineItems.collection.sku

string

The Stock Keeping Unit (SKU) associated with the item, used for inventory tracking and management.

Example:

"SKU3"

lineItems.collection.refId

string

An alternative identifier associated with the item, used for additional tracking or referencing.

Example:

"41"

lineItems.collection.quantity

integer<int32>

An integer that displays the total quantity of the item.

Example:

10

lineItems.collection.priceListId

string

The unique identifier for a price list, used to reference and manage pricing information.

Example:

"10001"

lineItems.collection.position

integer<int32>

Position of item in a cart.

Example:

1

lineItems.collection.price

object

Item price

Show child attributes

lineItems.collection.price.unit

number

The unit price of the item.

Example:

10

lineItems.collection.price.amount

number

The total price of the item, inclusive of quantity.

Example:

100

lineItems.collection.fees

object

A collection of fees associated with the cart.

Show child attributes

lineItems.collection.fees.total

number

The total fees amount in the collection.

Example:

5

lineItems.collection.fees.collection

object[]

An array containing all fees and their details in a collection.

Show child attributes

lineItems.collection.fees.collection.id

string

The unique identifier of the fee associated with the cart that was generated when making Create fee endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

lineItems.collection.fees.collection.name

string

Name of the fee

Example:

"Eco Fee"

lineItems.collection.fees.collection.price

object

Price details

Show child attributes

lineItems.collection.fees.collection.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

lineItems.collection.fees.collection.taxable

boolean

A boolean value that determines whether a fee is taxable.

Example:

true

lineItems.collection.fees.collection.attributes

object

Custom attributes that provide more context for the fee, such as the source of the fee.

Show child attributes

lineItems.collection.fees.collection.attributes.{key}

object

Custom attributes that provide more context for the fee, such as the source of the fee.

Example:

{ "source": "eco" }

Example:

{ "source": "eco" }

lineItems.collection.fees.collection.tax

object

A collection of taxes.

Show child attributes

lineItems.collection.fees.collection.tax.total

number

Tax total in the collection.

Example:

3

lineItems.collection.fees.collection.tax.collection

object[]

An array containing taxes in a collection.

Show child attributes

lineItems.collection.fees.collection.tax.collection.amount

number

Tax amount

Example:

3

lineItems.collection.fees.collection.tax.collection.attributes

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Show child attributes

lineItems.collection.fees.collection.tax.collection.attributes.{key}

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Example:

{ "rate": "5.0", "type": "COUNTY" }

Example:

{ "rate": "5.0", "type": "COUNTY" }

lineItems.collection.fees.collection.updatedAt

string

The date and time when the fee was last updated.

Example:

"2024-06-13T16:50:00.682Z"

lineItems.collection.fees.collection.createdAt

string

The date and time when the fee was created.

Example:

"2024-06-13T16:50:00.682Z"

lineItems.collection.fees.collection.taxDetails

object

Tax details used to determine tax for a cart fee.

Show child attributes

lineItems.collection.fees.collection.taxDetails.destinationAddress

string

The destination address where the item will be delivered.

Example:

"c86f777b-1885-4ddf-961d-542ba80a69b8"

lineItems.collection.fees.collection.taxDetails.originAddress

string

The origin address from which the item will be fulfilled.

Example:

"c86f777b-1885-4ddf-961d-542ba80a69b8"

lineItems.collection.promotions

object

Collection of item promotions.

Show child attributes

lineItems.collection.promotions.total

number

Discount total in the collection.

Example:

2

lineItems.collection.promotions.collection

object[]

An array containing promotions in the collection.

Show child attributes

lineItems.collection.promotions.collection.id

string

The unique identifier of the promotion.

Example:

"bb44db95-6fbd-4eed-a1ed-4d99bc91250f"

lineItems.collection.promotions.collection.amount

number

The discount amount applied to the item, excluding quantity.

Example:

15

lineItems.collection.promotions.collection.quantity

integer<int32>

The An integer that displays the total quantity of the item. for which the discount is applicable.

Example:

3

lineItems.collection.promotions.collection.proration

object

Prorations

Show child attributes

lineItems.collection.promotions.collection.proration.spread

object[]

An array containing details about adjustments made to charges based on partial usage. Each entry in the array represents a specific proration adjustment, including the amount.

Show child attributes

lineItems.collection.promotions.collection.proration.spread.amount

number

Proration amount for the item

Example:

5

lineItems.collection.promotions.collection.proration.spread.quantity

integer<int32>

Proration quantity the amount is applicable for

Example:

3

lineItems.collection.adjustments

object

A collection of adjustments made to the cart.

Show child attributes

lineItems.collection.adjustments.total

number

Adjustments total in a collection.

Example:

2

lineItems.collection.adjustments.collection

object[]

An array containing adjustments in the collection.

Show child attributes

lineItems.collection.adjustments.collection.id

string

The Adjustment ID generated when an adjustment was created using the Create adjustment endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

lineItems.collection.adjustments.collection.price

object

Price details

Show child attributes

lineItems.collection.adjustments.collection.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

lineItems.collection.adjustments.collection.reason

string

The reason for the adjustment.

Example:

"Price adjustment from customer representative."

lineItems.collection.adjustments.collection.attributes

object

Custom attributes used for price adjustments.

Show child attributes

lineItems.collection.adjustments.collection.attributes.{key}

object

Custom attributes used for price adjustments.

Example:

{ "source": "CSR" }

Example:

{ "source": "CSR" }

lineItems.collection.adjustments.collection.updatedAt

string

The date and time when the adjustment was last updated.

Example:

"2024-06-13T16:50:00.682Z"

lineItems.collection.adjustments.collection.createdAt

string

The date and time when the adjustment was created.

Example:

"2024-06-13T16:50:00.682Z"

lineItems.collection.fulfillment

object

Item Fulfillment

Show child attributes

lineItems.collection.fulfillment.id

string

The identifier of the fulfillment linked to the item.

Example:

"6d65755f-b1d9-4c9d-bb5b-118d317f8db4"

lineItems.collection.fulfillment.price

object

Price details

Show child attributes

lineItems.collection.fulfillment.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

lineItems.collection.fulfillment.inventory

object

Show child attributes

lineItems.collection.fulfillment.inventory.channels

object

Show child attributes

lineItems.collection.fulfillment.inventory.channels.type

string

Channel type (e.g., WEB_PICKUP, WEB_SHIP)

Example:

"WEB_PICKUP"

lineItems.collection.fulfillment.inventory.channels.locationNumber

string

Location number

Example:

"15"

lineItems.collection.fulfillment.inventory.channels.channelId

string

Example:

"12"

lineItems.collection.fulfillment.inventory.channels.networkCode

string

Network code (for shipping channels)

Example:

"shipToHome"

lineItems.collection.fulfillment.inventory.type

string

Inventory type (e.g., availableToPurchase, availablePreorder)

Example:

"availableToPurchase"

lineItems.collection.fulfillment.tax

object

A collection of taxes.

Show child attributes

lineItems.collection.fulfillment.tax.total

number

Tax total in the collection.

Example:

3

lineItems.collection.fulfillment.tax.collection

object[]

An array containing taxes in a collection.

Show child attributes

lineItems.collection.fulfillment.tax.collection.amount

number

Tax amount

Example:

3

lineItems.collection.fulfillment.tax.collection.attributes

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Show child attributes

lineItems.collection.fulfillment.tax.collection.attributes.{key}

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Example:

{ "rate": "5.0", "type": "COUNTY" }

Example:

{ "rate": "5.0", "type": "COUNTY" }

lineItems.collection.attributes

object

Custom attributes to provide more context for the item.

Show child attributes

lineItems.collection.attributes.{key}

object

Custom attributes to provide more context for the item.

Example:

{ "name": "item-custom" }

Example:

{ "name": "item-custom" }

lineItems.collection.tax

object

A collection of taxes.

Show child attributes

lineItems.collection.tax.total

number

Tax total in the collection.

Example:

3

lineItems.collection.tax.collection

object[]

An array containing taxes in a collection.

Show child attributes

lineItems.collection.tax.collection.amount

number

Tax amount

Example:

3

lineItems.collection.tax.collection.attributes

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Show child attributes

lineItems.collection.tax.collection.attributes.{key}

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Example:

{ "rate": "5.0", "type": "COUNTY" }

Example:

{ "rate": "5.0", "type": "COUNTY" }

lineItems.collection.taxCode

string

The code used to identify and apply tax rates for transactions.

Example:

"10001"

lineItems.collection.updatedAt

string

The date and time in UTC when the cart was last updated.

Example:

"2024-06-13T16:50:00.682Z"

lineItems.collection.createdAt

string

The date and time in UTC when the cart was last updated.

Example:

"2024-06-13T16:50:00.682Z"

fulfillments

object

A map of fulfillments added to the cart.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e

object

A fulfillment object containing important fulfillment information.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.id

string

The Fulfillment ID generated when a fulfillment was created using the Create fulfillment endpoint.

Example:

"d6229cdb-0c5b-4885-b1b2-13b94d02488e"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.type

enum<string>

Determines the type of fulfillment.

Available options:

SHIP_TO,

BOPIS,

ROPIS

Example:

"SHIP_TO"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.refId

string

An alternative identifier for fulfillments, used for additional tracking or referencing.

Example:

"398427903843"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.attributes

object

Custom attributes to provide more context to the fulfillment, such as where it was made.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.attributes.{key}

object

Custom attributes to provide more context to the fulfillment, such as where it was made.

Example:

{ "source": "store" }

Example:

{ "source": "store" }

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.originAddress

string

The identifier of the address where the item is being fulfilled.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.destinationAddress

string

The identifier of the address where the item is being shipped.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.locationId

string

Unique identifier of the store.

Example:

"CA"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson

object

Pickup person details

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary

object

Name of the pickup person.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary.name

object

required

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary.name.first

string

First name

Example:

"John"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary.name.last

string

Last name

Example:

"Doe"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary.email

string

Email of the pickup person.

Example:

"[email protected]"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary.phone

object

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary.phone.number

string

Phone number

Example:

"1234567890"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.primary.phone.type

string

Type of phone number (e.g., MOBILE, HOME)

Example:

"MOBILE"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary

object[]

An array containing secondary people for pickup.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary.name

object

required

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary.name.first

string

First name

Example:

"John"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary.name.last

string

Last name

Example:

"Doe"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary.email

string

Email of the pickup person.

Example:

"[email protected]"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary.phone

object

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary.phone.number

string

Phone number

Example:

"1234567890"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.pickupPerson.secondary.phone.type

string

Type of phone number (e.g., MOBILE, HOME)

Example:

"MOBILE"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.price

object

Price details

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.promotions

object

A collection of promotions applied to the fulfillment.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.promotions.total

number

The total discount applied within a collection.

Example:

15

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.promotions.collection

object[]

An array containing the promotions within a collection.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.promotions.collection.id

string

Identifier of a promotion

Example:

"bb44db95-6fbd-4eed-a1ed-4d99bc91250f"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.promotions.collection.amount

number

The discount amount applied to a fulfillment.

Example:

15

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees

object

A collection of fees associated with the cart.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.total

number

The total fees amount in the collection.

Example:

5

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection

object[]

An array containing all fees and their details in a collection.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.id

string

The unique identifier of the fee associated with the cart that was generated when making Create fee endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.name

string

Name of the fee

Example:

"Eco Fee"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.price

object

Price details

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.taxable

boolean

A boolean value that determines whether a fee is taxable.

Example:

true

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.attributes

object

Custom attributes that provide more context for the fee, such as the source of the fee.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.attributes.{key}

object

Custom attributes that provide more context for the fee, such as the source of the fee.

Example:

{ "source": "eco" }

Example:

{ "source": "eco" }

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.tax

object

A collection of taxes.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.tax.total

number

Tax total in the collection.

Example:

3

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.tax.collection

object[]

An array containing taxes in a collection.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.tax.collection.amount

number

Tax amount

Example:

3

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.tax.collection.attributes

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.tax.collection.attributes.{key}

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Example:

{ "rate": "5.0", "type": "COUNTY" }

Example:

{ "rate": "5.0", "type": "COUNTY" }

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.updatedAt

string

The date and time when the fee was last updated.

Example:

"2024-06-13T16:50:00.682Z"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.createdAt

string

The date and time when the fee was created.

Example:

"2024-06-13T16:50:00.682Z"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.taxDetails

object

Tax details used to determine tax for a cart fee.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.taxDetails.destinationAddress

string

The destination address where the item will be delivered.

Example:

"c86f777b-1885-4ddf-961d-542ba80a69b8"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.fees.collection.taxDetails.originAddress

string

The origin address from which the item will be fulfilled.

Example:

"c86f777b-1885-4ddf-961d-542ba80a69b8"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments

object

A collection of adjustments made to the cart.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.total

number

Adjustments total in a collection.

Example:

2

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection

object[]

An array containing adjustments in the collection.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.id

string

The Adjustment ID generated when an adjustment was created using the Create adjustment endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.price

object

Price details

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.price.amount

number

required

Total resource amount

Required range: x > 0

Example:

12.99

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.reason

string

The reason for the adjustment.

Example:

"Price adjustment from customer representative."

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.attributes

object

Custom attributes used for price adjustments.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.attributes.{key}

object

Custom attributes used for price adjustments.

Example:

{ "source": "CSR" }

Example:

{ "source": "CSR" }

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.updatedAt

string

The date and time when the adjustment was last updated.

Example:

"2024-06-13T16:50:00.682Z"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.adjustments.collection.createdAt

string

The date and time when the adjustment was created.

Example:

"2024-06-13T16:50:00.682Z"

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.tax

object

A collection of taxes.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.tax.total

number

Tax total in the collection.

Example:

3

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.tax.collection

object[]

An array containing taxes in a collection.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.tax.collection.amount

number

Tax amount

Example:

3

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.tax.collection.attributes

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Show child attributes

fulfillments.d6229cdb0c5b4885b1b213b94d02488e.tax.collection.attributes.{key}

object

Custom attributes to provide more context to the tax, such as the rate and the type of tax.

Example:

{ "rate": "5.0", "type": "COUNTY" }

Example:

{ "rate": "5.0", "type": "COUNTY" }

coupons

object[]

An array containing all coupons added to the cart.

Show child attributes

coupons.code

string

Coupon code

Example:

"VALID_COUPON"

coupons.updatedAt

string

The date when the coupon was added to the cart.

Example:

"2024-06-13T16:50:00.682Z"

appliedCoupons

object[]

An array containing all coupons applied to the cart.

Show child attributes

appliedCoupons.code

string

Coupon code

Example:

"VALID_COUPON"

appliedCoupons.updatedAt

string

The date when the coupon was added to the cart.

Example:

"2024-06-13T16:50:00.682Z"

notAppliedCoupons

object[]

An array containing any coupons that were ineligible and not applied to the cart.

Show child attributes

notAppliedCoupons.code

string

Coupon code

Example:

"VALID_COUPON"

notAppliedCoupons.updatedAt

string

The date when the coupon was added to the cart.

Example:

"2024-06-13T16:50:00.682Z"

payments

object

An object containing a collection of payments added to the cart.

Show child attributes

payments.authorized

number

The payments that have been authorized within the collection.

Example:

800

payments.collection

object[]

An array containing payments within the collection.

Show child attributes

payments.collection.id

string

The Payment ID that was generated when a payment was created using the Create payment endpoint.

Example:

"6ef2067a-5d6b-4785-a090-96ea0078220d"

payments.collection.provider

string

The payment provider, such as Verifone, that offers functions like transaction processing, gateway management, and other financial services.

Example:

"verifone"

payments.collection.processor

string

The payment processor, such as Stripe, responsible for handling and processing payment transactions by facilitating communication between the merchant and the issuing bank.

Example:

"stripe"

payments.collection.method

string

Payment method, such as Apple Pay, used for processing transactions.

Example:

"apple pay"

payments.collection.methodType

string

Payment method type, such as a credit card.

Example:

"credit card"

payments.collection.state

enum<string>

Payment state indicates whether the payment has been successfully processed.

Available options:

PENDING,

AUTHORIZED,

CAPTURED,

FAILED

Example:

"PENDING"

payments.collection.authorization

object

Payment authorization

Show child attributes

payments.collection.authorization.amount

number

required

The amount for which the payment has been authorized.

Required range: x > 0

Example:

8

payments.collection.authorization.expiry

string

The date when the payment authorization expires.

Example:

"2024-06-13T16:50:00.682Z"

payments.collection.authorization.verifier

object

Payment verifier

Show child attributes

payments.collection.authorization.verifier.type

string

The type of verification used, such as a token.

Example:

"TOKEN"

payments.collection.authorization.verifier.key

string

The key used for payment verification.

Example:

"CH39082K439R0"

payments.collection.billToAddress

string

The Address ID that was generated when an address was created using the Create address endpoint.

Example:

"a8577d7f-0d4d-4b22-8e85-7b4a2e90dc93"

payments.collection.cardDetails

object

Information about the card used for payment, such as gift card details.

Show child attributes

payments.collection.cardDetails.{key}

object

Information about the card used for payment, such as gift card details.

payments.collection.attributes

object

Custom attributes associated with the transaction, such as the name of the gift card used.

Show child attributes

payments.collection.attributes.{key}

object

Custom attributes associated with the transaction, such as the name of the gift card used.

Example:

{ "gift-card-name": "custom name" }

Example:

{ "gift-card-name": "custom name" }

updatedAt

string<date-time>

The date and time in UTC when the cart was last updated.

Example:

"2024-06-24T16:57:47.112Z"

createdAt

string<date-time>

The date and time when a cart was created.

Example:

"2024-06-24T16:56:43.027Z"

errors

object[]

Show child attributes

errors.code

string

The error code as a result of the error.

Example:

"ERR001"

errors.message

string

The error message to provide more context for the error.

Example:

"Invalid input"

Cart & Checkout API

Authorizations

Headers

Path Parameters

Body

Response