POST

Create Checkout From Cart


Creates a checkout from a cart.

If a checkout for the specified cart already exists, that checkout is updated with any new information from the cart.

Note: channelType is a required field.

Permissions
Manage eCommerce - all permissions
Manage Stores - all permissions
Manage Orders
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/ecom/v1/carts/{id}/create-checkout

Path Params
idstringRequired

Cart ID.

Body Params
channelTypestring

Required. Sales channel type.


shippingAddressShippingAddress

Shipping address. Used for calculating tax and shipping (when applicable).


billingAddressBillingAddress

Billing address. Used for calculating tax if all the items in the cart are not shippable.


selectedShippingOptionSelectedShippingOption

Selected shipping option.


emailstringformat EMAIL

Required when setting a billing or shipping address if the site visitor isn't logged in.

Response Object
checkoutIdstring

The newly created checkout's ID.

Create a checkout from a cart
Request
cURL
curl -X POST \ 'https://www.wixapis.com/ecom/v1/carts/f97a2939-b1f3-41f2-9fc5-7ecea2060991/create-checkout' \ -H 'Authorization: <AUTH>' \ -H 'Content-Type: application/json' \ --data-binary '{ "channelType": "EBAY" }'
Response
JSON
{ "checkoutId": "8e5a223d-f53a-431a-8d9d-3f0c5536e916" }
Errors
428Failed Precondition

There are 4 errors with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?