1ShoppingCart Gateway: |
Follow the steps below to automation ordering between 1ShoppingCart.com and TrepStar.
You will need to be signed up for the 1ShoppingCart Professional plan. If you are using the Starter or Basic plan, 1ShoppingCart does not grant you access to the 1ShoppingCart API. This API (application program interface that allows TrepStar to access your order data) is required for the integration with TrepStar. |
- Copy 1ShoppingCart API Keys to TrepStar
- Login to 1ShoppingCart, and select "My Account", then "Api Settings". If you do not see the "API Settings" choice on the drop down menu, you need to upgrade to 1ShoppingCart Professional to gain access to the API.
- Copy the "Current Merchant API Key" value. It will look something like 3B2EA25FBE9B4E31915F3CEDD74E8E78
- Login to TrepStar, and click the "Edit" button to edit your publisher settings.
- Scroll down to the "Shopping Cart Integration..." section and paste the API Key into the field named "Merchant API Key"
- Switch back to 1ShoppingCart, and copy your "Merchant ID" (usually displayed in upper right hand corner of the screen).
- Switch back to TrepStar and paste your "Merchant ID" into the TrepStar field named "Merchant ID"
- Save the TrepStar Publisher Information ("Save" button).
- Configure 1ShoppingCart to call TrepStar with order notifications
- Switch over to 1ShoppingCart, and look at the "API Settings" area.
- Under the API Key, look for "Notification URL". Copy and paste the following into that field:
- TSMode is set to the value of test in the example above. Set this to the value of prod when you are done testing. No CD/DVD/USB product will be created or mailed if the mode is test. Test mode is set this way so you can test a few orders before actually having TrepStar.com actually make or send product.
- TSPub is your publisher id. Replace TrepStarPublisherID in the URL above with your actual publisher ID. i.e. TSPub=40110 . Publisher ID can be found by logging into TrepStar.com and finding it listed there. We validate your Product IDs with your publisher ID so no one else can order products except you.
- TSErrEM is any email where you would like to receive notification or error emails. Replace you@abc.com with your email address. i.e. TSErrEM=you@abc.com .
It's hard to test these integrations so if errors occur,
our server will send you an email that will help us all fix the problem. This field is optional, but it does help debug any early problems. Once the
integration is setup and working, you can remove this parameter from the URL.
- Associate 1ShoppingCart Product SKU's with TrepStar Projects
- While in 1ShoppingCart, choose "Products" from their main menu bar.
- Notice the SKU number associated with each product.
- Copy the SKU number for a product on 1ShoppingCart.
- Switch over to TrepStar and edit the project that matches the product you are selling on 1ShoppingCart
- Scroll down to near the bottom of the TrepStar Project edit area to the "Optional Advanced Variables" section.
- Paste the SKU# into the "eCommerce ID String" field.
- Do you have more than one 1ShoppingCart SKU that is associated with a single TrepStar project? No problem: String several 1ShoppingCart SKU's together in the TrepStar 'eCommerce ID String' using < >. Example: If you had 3 1ShoppingCart SKU's 5000-A, 6000-B, and 7150 that corresponded to a single TrepStar project, set the TrepStar project 'eCommerce ID String' to <5000-A> <6000-B> <7150> Now, when a customer orders either SKU 5000-A, 6000-B, or 7150, this TrepStar product will be ordered.
- Do you have a single 1ShoppingCart SKU that is associated with a two or more TrepStar project? This might occur if you have a SKU that would order a primary TrepStar product, but also include a bonus CD/DVD/USB TrepStar Product. In this case, you put that 1ShoppingCart SKU in both TrepStar Projects. Add that SKU to the TrepStar 'eCommerce ID String' using < >. Example: The first TrepStar project might have the eCommerce String look like <5000-A> <6000-B> The second trepstar project might look like <4000-C> <6000-B>. In this example, if the SKU 5000-A was submitted, the first TrepStar product will be ordered. If the SKU 4000-C was submitted, only the second TrepStar product will be ordered. However, if the SKU 6000-B was submitted, BOTH TrepStar products will be ordered and placed in the same shipping box.
- Save the TrepStar Project.
- Other Details:
- Shipping: By default, we ship standard first class + tracking. If you want to ship priority or express (now named priority-express by USPS), your shipping methods you've
set up in 1ShoppingCart must contain the word priority, or express anywhere in the description. It doesn't matter if it's upper or lower case. The only way to be sure this
works is to order a few test orders using the priority or express shipping method you've set up.
- Shipping: By default, we ship standard first class + tracking. If you want to ship priority or express (now named priority-express by USPS), your shipping methods you've
set up in 1ShoppingCart must contain the word priority, or express anywhere in the description. It doesn't matter if it's upper or lower case. The only way to be sure this
works is to order a few test orders using the priority or express shipping method you've set up.
Once you've completed the steps above, when new orders come in through 1ShoppingCart, a test order record will be made on TrepStar.
- Because you set to TSMode to a value of "test" in the steps above, a test record will be created in TrepStar
- These test orders show you the customer data, and indicate the integration is working.
- Click the recent orders button to see all recent orders including test orders.
- "test" mode orders will not cause a CD/DVD/USB to be made or shipped, nor are you billed for test orders.
- Test orders can not be converted into production "prod" orders. They should be deleted.
- When you are satisfied the integration is working, change your 1ShoppingCart Notify URL and replace TSMode=test with TSMode=prod.