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.
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 |
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 |