createOrder( )
Developer Preview
This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.
Creates an order from a specified checkout.
The createOrder()
function returns a Promise that resolves to the new order's ID and paymentGatewayOrderID
when the order is created.
Pass the paymentGatewayOrderId
as the paymentId
param to the startPayment()
function to allow a customer to pay for their order.
Note: The following requirements must be met for an order to be created from a checkout.
- A checkout cannot have calculation errors. Pass the
checkout._id
to Get Checkout and take a look at thecalculationErrors
field. - A checkout must have at least 1 line item.
- All of the line Items have an
availability.status
of"AVAILABLE"
or"PARTIALLY_AVAILABLE"
. - If there is a payment to be made, meaning that
priceSummary.total
is greater than 0, thebillingInfo.address
field must be provided. - When a checkout has line items to be shipped, the
shippingInfo.shippingDestination.address
andshippingInfo.selectedCarrierServiceOption
fields must be provided. - When a checkout has line items for pickup, the
shippingInfo.selectedCarrierServiceOption.logistics.pickupDetails
field must be provided.
Permission Scopes
For app development, you must have one of the following permission scopes:Manage Stores - all permissions
Manage eCommerce - all permissions
Manage Orders
Learn more about permission scopes.
Method Declaration
Copy
Method Parameters
_idstringRequired
Checkout ID.
Returns
Return Type:Promise<CreateOrderResponse>
Was this helpful?
Yes
No