Primary

Ecwid

ecwid logoThis plugin integrates Affiliates Enterprise with Ecwid. With this advanced integration plugin, referrals are created and synchronized automatically for your affiliates when sales are made. This integration also supports coupons related to affiliates to grant referrals when customers use them to credit the corresponding affiliate.

Requirements

▪ An Ecwid account with Order API and Instant Order Notifications API access enabled – this will not work with free accounts.
▪  Affiliates Enterprise
▪ Affiliates Ecwid Integration ( can be installed through the Dashboard, under Affiliates > Settings > Integrations )

Setup

When you freshly install the integration plugin, you will need to indicate your Store IDOrder API secret key and set the ION Cannon endpoint URL provided by the integration.

Screen Shot 2015-02-21 at 14.01.13

Go to Affiliates > Ecwid where you will provide your Store ID and Order API secret key.

Store ID – You will find your Store ID on your Ecwid Control Panel in the Account Summary box:

ecwid-store-id

Order API secret key – You will find this key on your Ecwid Control Panel under System Settings > Apps > Legacy API keys – If you do not see this menu, please visit this direct link https://my.ecwid.com/cp/CP.html#api

Ecwid Legacy API keys

Click the heading and you will find your Order API secret key there.

Ecwid Order API secret key

Input your Store ID and Order API secret key in the fields provided for that purpose on your WordPress Dashboard under Affiliates > Ecwid

Ecwid Settings

Now copy the ION Cannon endpoint URL which is provided under Affiliates > Ecwid

Ecwid ION

Paste the complete URL in the field ION Cannon endpoint URL provided under System Settings > Apps > Legacy API keys:

Ecwid CP ION

Test the ION endpoint by clicking the test link which opens up a dialog box where you need to click a button labeled Test – “Test performed successfully” should be displayed in the dialog.

To set the commission rate for your affiliates go to Affiliates > Ecwid and set the rate in the section Referral Rate.

Example: If you want to give an affiliate 10% of each net total sales amount, set the rate to 0.1.

To fully test your installation, follow the procedure outlined below. Please note that this assumes that you have embedded your store on your website using Ecwid’s code as provided on the Ecwid control panel.

  1. Create a new affiliate under Affiliates > Manage Affiliates > New Affiliate.
  2. Open a different browser and visit the affiliate’s link.
  3. Now place an order in your store.
  4. You should see that a new referral has been created under Affiliates > Referrals.

The advanced integration available with Affiliates Pro and Affiliates Enterprise allows referrals to be synchronized to the order status. The appropriate settings are used by default which includes accepting or rejecting referrals based on the order payment status. You can review these settings and reconfigure automatic adjustments if desired under Affiliates > Ecwid > Auto-adjustment of referrals.

Ecwid Auto-adjustment

The integration will reject referrals for orders whose payments have been cancelled or declined. Referrals for orders with completed payments are marked as accepted. Orders with queued or chargeable payments result in pending referrals.

These are the settings used by default; you can disable those automatic adjustments that are not desired, although in general, we recommend all synchronization options enabled.