Server Side Confirmation

Description

Our Server Side Integration is a simple HTTP Request from your website that tells our system when a purchase/order has taken place. First, you will need to generate your unique API key. Then, a couple of URL parameters are required and our system will respond with a success/error code. 

What are the benefits of Server Side Integration?

Quite simply, the server side integration is more accurate than the Javascript (client side) confirmation tracking. Since the Javascript tracking relies on the end user's browser settings, a small percentage of conversions may be missed. The server side integration, however, is based on your back-end sending an API call to our system upon a purchase. This option should be 100% accurate. 

To get started, you will need to generate a unique API key on the  Code/Setup page of your account. 
URL Endpoint

When a purchase is made, you will need to send an HTTP request using this URL with the appropriate parameters. (Do not include the brackets{})

https://api.cartstack.com/ss/v1/?key={api key}&siteid={site id}&email={customer email}&total={cart total}

Testing

Before testing, ensure that your basic integration has been completed, emails have been added to your campaign, and the site is in test mode. Without emails being added you will most likely receive error 102. You may also want to take the response from the call and record it, this way you can look through those responses and check for errors.

One other way to make sure your test purchases are making it to CartStack, is to monitor the Recent Purchases Recorded in the Recent Activity section of the dashboard found on the Setup page.

URL Parameters
Parameter Required Notes
key yes unique API key, generate on the  code/setup page in your account
siteid yes your SiteID, view this on the  code/setup page in your account
email yes customer email address
total no order/purchase amount, used for revenue reporting
Response Codes
Code Description
100 success
101 missing required field (api key, site id, or email)
101 Invalid Email Address
102 general error(Err_Txt: Cart not found for email address [email])
102 Not a valid site id.
102 Purchase Insert Failed
102 No cart exists for this email address. Please create a cart first before marking a purchase.
103 API Key does not match
Did this answer your question? Thanks for the feedback. Click the "Contact Us" button to the right if you need further help. There was a problem submitting your feedback. Please try again later.