3dcart

Setup

Step 1 – Register Vextras as a 3dcart ‘Subscribed App’

1. Login to your Vextras dashboard
2. Click “+ Add New” on the bottom left
3. Add a new store, choose 3dcart
4. Give your store a name
5. Enter the secure URL in Vextras as found in your 3dcart admin area – “Settings” > “General” > “Store Settings” > “Secure URL”
6. Next, click the ‘API Key’ tab & copy your key
7. Login to your 3dcart store
8. Navigate to ‘Modules’ > ‘RestAPI’ > ‘Change Settings’
9. Add a new ‘Subscribed App’ (top right corner)
10. Paste the API key you copied in step 5 & authorize access
11. Re-save your store in the Vextras dashboard to generate the installation snippet

Step 2 – Place Vextras installation snippet in 3dcart template

1. Go back to your Vextras dashboard, copy installation snippet for your 3dcart store
2. Now proceed to your 3dcart store
3. Navigate to ‘Content’ > ‘Header & Footer’
4. Paste the install snippet in the ‘Global Footer’
5. Make sure ‘Global Footer’ is set to active
6. Save

API Key

A Vextras API key will be generated when a 3dcart store is added. This will be used to register the Vextras application as a “subscribed app” in your 3dcart administration area.

Example API Key

272fa137cde9c51e36f2ce9a2b71b6be

Installation Snippet

The Vextras installation snippet is used to capture shopping cart data in real-time. Apps and workflows depend on this code to be present at all times in order to work properly.

Example Snippet

<!-- BEGIN VEXTRAS CODE--> <script>function vextrasCustomRequest(){vextras.submitOrder("[invoicenum]");}</script><script src="https://s3-us-west-2.amazonaws.com/vextras/staging_scripts/store_X8VFWXBJBNYW5G4ZRD75RCPKT8.js"></script> <!-- END VEXTRAS CODE-->

Installation Demo

Connection

When your 3dcart store is active with Vextras, the ‘Connection’ tab for your store will show key indicators about the installation.

• Status
• Platform
• Store Name
• Secure URL – The secure URL can be found in your 3dcart admin area – Settings -> General -> Store Settings -> Secure URL.
• API Key – Use this key when adding a new ‘Subscribed App’ in your 3dcart admin area
• Install Code Status
• Install Script (required) – Paste the script into the Header area of your Bigcommerce template before the ending head tag.
• Conversion Tracking (required) – Paste the installation code in the ‘Global Footer’ of your 3dcart admin area. It’s ok to have this code loaded with other types of conversion scripts.

Settings

• Store information – basic contact details for your store, this is required for CAN-SPAM compliance if you want to use any of our workflows.
• Social links – attach your social links to any of our workflow e-mail templates. When added, the URL’s will automatically link to your social profiles.
• Locale settings – set your country and currency.
• Google Analytics integration – activate Google Analytics to display key metrics in your store’s dashboard.

Removal Instructions

1. Login to your 3dcart admin area
2. Navigate to ‘Modules’ > ‘RestAPI’ > ‘Change Settings’
3. Click the cog wheel icon on the far right
4. From the cog wheel drop-down menu, click ‘Delete’
5. Next, go to ‘Content’ > ‘Header & Footer’
6. Remove the install snippet in the ‘Global Footer’
7. Save

More Information

Processing Times

• All new order data is processed in real-time through standard web checkout.
• Phone or manual orders are processed on 15 minute intervals.

Order Update Times

• Our systems poll your store’s API on a set intervals i.e. every 4, 6, 8 hours etc. At that time, we filter through each record in our system and look for any order status change.
• By default, we check for order status changes every 10 hours.

Order Monitoring

• Before an order status is Shipped, each order status is monitored for 60 days. After an order is Shipped, our systems continue to monitor the order for 30 days.

Bandwidth Usage

Because of the way this shopping cart’s API is designed, we must poll your store’s API periodically to check for order updates. Although unlikely, this could result in increased bandwidth usage. How much usage is dependent on your store’s order volume.

Valid SSL Required

• If a store lacks a valid SSL certificate, we are unable to process any order information
• If an SSL expires on your domain, Vextras apps and workflows will not function
• A SSL can be purchased from the shopping cart provider or any 3rd party SSL vendor
• Installation of a SSL will need to be facilitated with your shopping cart provider

Localization

• All major currencies supported
• All time zones supported

Limitations

Platform

• An order must be placed through the standard web checkout before any phone or manual orders will process.
• Product option images are not available through the API. Therefore, the default product image will be used in workflow messages.

Workflows

• Abandoned cart workflows are currently not supported