Skip to main content
POST
Sync Custom Order

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

storeId
string
required

Store ID

Example:

"64e5a8a1af49a89df37e4ee7"

Body

application/json

An order synced into Redo so it can be returned.

Redo reads the line items, discounts, and taxes below to decide what the shopper is allowed to return and what to refund, so send the values that were actually charged.

Note: If Redo is attached to this order, you must add a single line item with:

  • vendor: "re:do"
  • sku: "x-redo"
  • Include the price of Redo as the line item price
  • In tags, include: "returns", "package protection", or "both"
  • In properties, include _redo_type with value: "return", "package protection", or "both"
id
string
required

Order ID in external system

type
enum<string>
required

Type of resource (must be "order")

Available options:
order
createdAt
string
required

Order creation timestamp

presentmentCurrency
string
required

Currency shown to customer

shopCurrency
string
required

Shop's base currency

customer
Customer · object
required

Customer information

lineItems
Custom Order Line Item · object[]
required

Order line items. Line item IDs must be unique within an order.

orderDiscounts
Discount · object[]
required

Order-level discounts (not line item or shipping discounts)

shippingLines
Custom Order Shipping Line · object[]
required

Shipping methods

fulfillments
Custom Order Fulfillment · object[]
required

Order fulfillments

shippingAddress
Shipping Address · object
required

Shipping address

updatedAt
string
required

Last update timestamp

billingAddress
Billing Address · object | null

Billing address

salesChannel
string | null

Sales channel where order was placed

tags
string[]

Order tags

transactions
Custom Order Transaction · object[]

Payment transactions

Response

Order synced successfully

Response returned when an order is synced successfully

message
string
required

Always "Order synced successfully"

orderId
string
required

The order ID you supplied in the request body

redoId
string
required

The Redo order ID for the synced order