POST
/
orders

Direct order submission allows channels to submit fully composed orders, including their own tax and shipping calculations, in a single request to the merchant through Violet. This feature overrides the platform’s built-in pricing engine, ensuring accuracy in the merchant’s system of record and customer communications.

Learn more about Direct Order Submission in this guide.

The following information is required to be included in the Order payload of this request:

  1. First Name
  2. Last Name
  3. Email
  4. Shipping Address
  5. Bag(s)

For a multi-merchant Order, multiple bags must be created in the Order payload. Each Bag must contain items from only one merchant and have its own shipping method.

Violet currently only supports accepting Single-use Stripe Tokens as a payment method in this endpoint.

Headers

X-Violet-Token
string
X-Violet-App-Secret
string
X-Violet-App-Id
integer

Body

application/json
order
object

Order

payment_method
object

The payment method request for a cart. If the token is provided no card data is required.

Response

200 - application/json

The response is of type any.