website logo
Channel Docs
Merchant Docs
Navigate through spaces
Channel Docs
Merchant Docs
⌘K
Guides
🚀Quick Start
🏃‍♂️Utilizing Quick Checkout
👋Welcome to Violet's Docs
💡Concepts
🌐API Reference
✋Help
Docs powered by archbee 
7min

Place an Order

Note: You can also follow this guide in Postman by using the appropriate requests and environment variables for the headers.



So far you have been able to view all the Merchants available for your application, view their catalog of products and select one specific product. Here you will learn how to go through the entire flow of purchasing a product through Violet. To get started with the Checkout process, we will create a cart and add products to it. For this section, we have taken the SKU that we retrieved details for in Interact with Catalogs.

So far in this Recipe we have viewed available merchants, seen what they have to offer, and selected the product we want to buy. We will now imagine we are a shopper, P. Sherman living on 42 Wallaby Way, Sydney, actually purchasing this product through your Application using Violet.

Create Cart

As seen above, the cart has now been created with the product of our choosing (SKU: 10064, GoPro Quadcopter). You may be wondering what a "bag" is in the response -- since Violet let's you sell products across different Merchants, during the checkout process we bucket each Merchant's products together in "Bags". Violet Applications do not need to worry about this concept and neither do your shoppers.

Now that the cart is created and the customer is ready to start the checkout process, the next steps is collecting customer information and applying it to the cart. Save the Cart Id from the Create Cart resposne. In the example above, this is id: 20956

Apply Customer Info

With the customer info applied we can go onto getting the shipping methods for each bag within the cart. Our test cart here only has one bag. Since Violet (and hence, your application) lets your customers purchase across various Merchants, think of a bag as a section of your cart for one specific merchant.

Get Shipping Method

Once the Shipping and Billing Address are set, then you can get the shipping methods available for a cart (and bags within the cart).



This will get the available shipping methods, it will return an array of shipping methods for each bag in the cart.
GET
Params
Header Parameters
X-Violet-Token
optional
String
Token
X-Violet-App-Secret
optional
String
App Secret from Dashboard
X-Violet-App-Id
optional
String
Your App ID


For more information on this endpoint go to Get Available Shipping Methods



Choose your shipping method and apply it!

Apply Shipping Method

Now that shipping address, billing address and shipping method have all been taken care of, we can move onto payments. Here you'll be able to show your customer the final order for review and enter their payment information. You can read more about how payments work in Violet here Payments.

Payment Info

The response above is our final order and gives your customer the chance to review their cart, along with shipping information, payment information and product details. Notice how all the fields have now been populated, including credit card details. To confirm this order, all that's left is to Submit the cart!

Submit Cart

For this example we didn't price our cart at any point. This is probably an important thing for you customers though go check out how it works Price Cart .





Submit a Cart. Turning the Cart into an Order
POST
Params
Header Parameters
X-Violet-Token
optional
String
Token
X-Violet-App-Secret
optional
String
App Secret from Dashboard
X-Violet-App-Id
optional
String
Your App ID


Fun fact: Cart ID's turn into Order ID's, carrying the same ID across the entire lifecycle of an order from creation to completion.

For more information on this endpoint go to Submit Cart

And you're done! You have now successfully placed an order through Violet and have a happy customer, all without having to integrate with any downstream merchant yourself. Your customer will now receive their purchase directly from the merchants and all payments to both you and the merchant will be handled for you by Violet. You can see the details of this sale on your Channel Dashboard (channel.violet.io).

Although we've done a lot already, this is only the start to what Violet can offer your application. We also have to provide shipping updates; browsing through product categories to better showcase which products are available to buy; and Violet Connect, a simple wizard that lets you directly add any new merchant to your application. For a complete list of APIs we have to offer and more information on the ones you've interacted with, please refer to our API Reference pages.

You can also read more about Violet on our Blog or Send us an email to get a demo or learn more about how we can work together!

Updated 14 Feb 2023
Did this page help you?
Yes
No
UP NEXT
Utilizing Quick Checkout
Docs powered by archbee 
Create Cart