To add a store from Etsy APIv3, you need etsy_client_id і etsy_refresh_token

etsy_client_id is a keystring of the App created in Development Apps. To manage your apps, go to https://www.etsy.com/developers/your-apps and add a new application.

For successful registration of the application, the store registration must be fully completed (all supporting documents sent to Etsy, connected card for payment, etc.), otherwise there may be nuances with the registration of the application or its authorization with OAuth 2.0 for further work.

Once an app is registered, Etsy reviews and approves it. After the Etsy app is approved, you can authorize it via Oauth 2.0 and perform requests.

You can do it with the help of a postman. For this, you need to create a new request and select the Oauth2.0 authorization type on the Authorization tab.

• Token Name - an arbitrary name for the token to be used in postman
• Grant Type - Authorization Code (With PKCE)
• Callback URL - callback_url, which is registered for this application
• Auth URL - https://www.etsy.com/oauth/connect
• Access Token URL - https://api.etsy.com/v3/public/oauth/token
• Client ID - keystring of created application (parameter etsy_client_id)
• Code Challenge Method - SHA-256
• Scope - following scopes can be used for the applicationі: address_r address_w billing_r cart_r cart_w email_r favorites_r favorites_w feedback_r listings_d listings_r listings_w profile_r profile_w recommend_r recommend_w shops_r shops_w transactions_r transactions_w
• https://developer.etsy.com/documentation/essentials/authentication/ - here you can find the information about scopes
• State - a one-time marker created specifically for this request. An arbitrary set of symbols and numbers.
• Client Authentication - Send client credentials in body

When receiving a token, you need to confirm access permission for the application.

After successful authorization, we will receive a refresh_token, which can be used to add a store to the app.

First, you must ensure that the WooCommerce REST API is working. The following conditions must be met:

Next, you need to create API keys:

The following fields must be filled in:

In the User field, you need to specify a user who has the Administrator role. The Permissions field must be Read/Write

As a result, we will get Consumer key and Consumer secret, which are needed to add a store to the API2Cart:

To add a store in the API2Cart admin panel, fill in the fields as follows:

Troubleshooting

If you receive the following message while adding a store:

First of all, you need to check whether you have specified the correct store_url, wc_consumer_key and wc_consumer_secret.

If all the fields are correct, another reason can be that your server may be configured in such a way that it does not accept authorization tokens in request headers. You need to add the following line to the .htaccess file in the folder with the woocommerce project:

RewriteRule ^index\.php$ - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]

You can find additional information in the Woocommerce guide.

In order to see all additional parameters that are unique for your shopping cart, call product.list API method with the params=force_all parameter. Or set the necessary fields separated by comma in parameter "params" (params=length,depth).

• Call cart_bridge method from which you could get store_key.
• Call bridge_download method and pass store_key which was generated in cart_bridge.
• Upload the bridge to the root ftp server folder.
• Call cart_create method and paste previously generated store_url.

In most cases the system automatically defines the prefix of specific shopping cart and uses it. However if you have several shopping carts of one type, the automatic defining will not work. In this case you should use the method account.cart.add and define the prefix of your shopping cart with a parameter db_tables_prefix.

1. Log into the store.

2. Copy store URL from your browser address bar.

3. Go to Advanced Settings.

4. Click API Accounts.

5. Click Create API Account.

6. Type the name of the user in the Username box.

7. There you will find API Path box. Copy the part of the value that placed between api.bigcommerce.com and /v3/ as shown.

8. Click Content - modify, Checkout Content - modify, Customers - modify, Customers Login - login, Information Settings - modify, Marketing - modify, Orders - modify, Order Transactions - modify, Products - modify, Themes - modify, Carts - modify.

9. Click the Save button. There will appear a window BigCommerce API Credential with Client ID and Access Token.

10. Add BigCommerce store to your API2Cart account, using credential you've got in steps 2, 7 and 9.

To connect Shopify store to API2Cart you need to specify the following credentials:

Required credentials:

1. shopify_api_key + shopify_api_password - for connection via Private app
2. shopify_access_token - for connection via Custom app
3. shopify_shared_secret - is needed to work with Live Shipping Rates or Webhooks

Note. Private apps are deprecated and can`t be created as of January 2022. Custom apps are used instead

To receive shopify_access_token you need to create a Custom app. There are 2 ways:

Let's consider the 2nd way.

Open Apps section and press Develop apps for your store.

Press Allow custom app development.

Next step - Create Custom app.

Choose scopes and permissions to the store data.

Webhook Subscriptions Event version - leave without any changes.

Next, open Overview tab and Install the app.

Access token and shared secret will be available in API credentials section.

Please note that Access token could be seen just once. If you lose it you will need to create another App.

Use needed credentials to connect the store.

You can find additional information in Shopify guide.

https://shopify.dev/apps/auth/admin-app-access-tokens.

If you are interested in oAuth authorization proceed with the first way via Partner dashboard. Here is a Shopify guide https://shopify.dev/apps/auth/oauth/getting-started .

1. Login to the Admin Area of your Volusion store.
2. Click the Inventory tab followed by the Import/Export link at the top, below the Inventory tab.
3. Click the Volusion API tab.
4. Point to Get Help in the top right and click Get help with this page.
5. Click the Volusion API Integration Help link at the bottom of the page.
6. Select to view instructions for Generic Orders and expand the URL with Query Stringsection at the bottom. The Encrypted Password can be found in the URL displayed, between the Encrypted Password= and &API_Name.

1. Log in to your admin panel and go to Settings -> General -> Store Settings.
2. Go to the Advanced Settings section located at the far bottom of the page.
3. Click on Change Settings next to API Settings.
4. Check Enable API if it isn't enabled yet.
5. Copy API User Key and save changes.

The process of connecting the store to API2Cart depends on the type of shopping cart. There are two major types: Hosted (3dcart, Volusion, Shopify) and Open-source (PrestaShop, WooCommerce, OpenCart, etc.) Get the type of carts here.

For Hosted Carts

You are able to add your stores in 2 ways:

1. Through the interface in your account. Simply press ‘Add store button’, paste your store’s URL, select type, valid API key and API password.
2. By calling account.cart.add method.  In order to add store correctly, provide all necessary parameters that are described in documentation.

public function apiCreate()
{
  $params = array(
    'cart_id'      => 'BigcommerceApi',
    'store_url'    => 'https://example.com',
    'verify'       => 'false',//set this param=false for test only
    'store_key'    => 'ab37fc230bc5df63a5be1b11220949be',//for self-hosted cart only
    'AdminAccount' => 'admin',
    'ApiPath'      => 'https://example.com/api/v1',
    'ApiKey'       => '6b89704cd75738cb0f9f6468d5462aba',
  );

  return $api->request('account.cart.add', $params);
}

Note: Store key is generated automatically for hosted carts (Shopify, Bigcommerce, Volusion, etc.)

For Open-source Carts.

When talking about Open-source platforms, it’s worth mentioning that API2Cart connects to such type of solutions through connection bridge.

You are able to add your stores in 2 ways:

1. Through the interface in your account. Simply press ‘Add store button’, paste your store’s URL, select type, download bridge and paste it to your store’s root folder via FTP client. (Read our FAQ on what is the connection bridge and why do you need it)
2. By calling these methods:

• Call cart.bridge method from which you could get store_key.
• Call bridge.download method and pass store_key which was generated in cart_bridge.
• Upload the bridge to the root ftp server folder.
• Call account.cart.add method and paste previously generated store_url.

Product API methods allow you to manage products in the store. It is possible to:

• Create - add products
• Read - retrieve list, info, find
• Update - update
• Delete - delete

Run product.add method, in order to add new products to the store, and provide all necessary parameters.

public function apiAdd($params)
{
  $params = array(
    'name'        => 'Bag',
    'model'       => 'bag_01',
    'description' => 'This is new product',
    'price'       => 99.9,
    'quantity'    => 12,
    'manufacturer'=> 'Test',
  );

  return $api->request('product.add', $params);
}

Note: You may add image, tax, manufacturer, option, variant or other info to the product by calling these methods: product.image.add, product.variant.add, product.manufacturer.add, product.tax.add, product.option.add, product.option.value.add, product.option.assign, product.option.value.assign

For more methods jump into documentation.

If you want to update the product, call product.list method  to retrieve product id.

public function apiList($params)
{
  $params = array(
    'start'  => 0,
    'count'  => 50,
    'params' => 'id,name,price',
  );

  return $api->request('product.list', $params);
}

When you get product id, you are able to update price and inventory(quantity) for this product, simply calling product.update method.

public function apiUpdate($params)
{
  $params = array(
    'id' => 69,
    'price' => 89,
  );

  return $api->request('product.update', $params);
}

Note: You may update variant, image and product option value by calling the following methods: product.variant.update, product.image.update, product.option.value.update

For more API methods visit our documentation.

Order API methods allow you to manage orders in the store. It is possible to:

• Create - add orders
• Read - retrieve list, info, find
• Update - update
• Delete - delete

Run order.add method to add orders to the store, and provide all necessary parameters.

public function apiAdd($params)
{
  $params = array(
    'customer_email'         => '[email protected]',
    'order_status'           => 'Complete',
    'bill_first_name'        => 'Adam',
    'bill_last_name'         => 'Smith',
    'bill_address_1'         => 'Green str. 35',
    'bill_city'              => 'Chicago',
    'bill_postcode'          => '12345',
    'bill_state'             => 'IL',
    'bill_country'           => 'US',
    'total_price'            => '23.56',
    'order_item_id_1'        => 8,
    'order_item_name_1'      => 'Bag',
    'order_item_model_1'     => 'bag_01',
    'order_item_price_1'     => 89,
    'order_item_quantity_1'  => 3,
  );

  return = $api->request('order.add', $params);
}

If you want to update an order, call order.list method to get order id.

public function apiList($params)
{
  $params = array(
    'start'  => 0,
    'count'  => 5,
    'params' => 'id,customer,status'
  );

  return $api->request('order.list', $params);
}

When you get your order id, you are able to update comment and order status by calling  order.update method

public function apiUpdate($params)
{
  $params = array(
    'order_id'     => 11,
    'order_status' => 'Pending',
    'comment'      => 'Order comment'
  );

  return $api->request('order.update', $params);//returns the number of updated orders
}

Note: You are able to count orders in the store by calling order.count method.

For more methods jump into documentation.

Customer API methods allow you to manage customers in the store. It is possible to:

• Create - add customers
• Read - retrieve list, info, find
• Update - update
• Delete - delete

Run customer.add method, to add customers to the store, and provide all necessary parameters.

public function apiAdd($params)
{
  $params = array(
    'email'      => '[email protected]',
    'first_name' => 'John',
    'last_name'  => 'Smith',
  );

  return $api->request('customer.add', $params);
}

If you want to update the customer, call customer.list method  to retrieve customer id.

public function apiList($params)
{
  $params = array(
    'start' => 0,
    'count' => 5
  );

  return $api->request('customer.list', $params);
}

When you get your customer id, you are able to perform customer.update method.

public function apiUpdate($params)
{
  $params = array(
    'id'         => 11,
    'first_name' => 'Jack',
    'last_name'  => 'Smith',
  );    

  return $api->request('customer.update', $params);
}

For more methods jump into documentation.

Categories API methods allow you to manage categories in the store. It is possible to:

• Create - add categories
• Read - retrieve list, info, find
• Update - update
• Delete - delete

Run category.add method, to add customers to the store, and provide all necessary parameters.

public function apiAdd($params)
{
  $params = array(
    'name' => 'Shoes'
  );

  return $api->request('category.add', $params);
}

If you want to update the category, call category.list method to get category id.

public function apiList($params)
{
  $params = array(
    'start'  => 2,
    'count'  => 2,
  );
  
  return $api->request('category.list', $params);
}

When you get your category id, you are able to perform category.update method.

public function apiUpdate($params)
{
  $params = array(
    'id'         => 20,
    'avail'      => 'false',
    'meta_title' => 'meta title for category'
  );
    
  return $api->request('category.update', $params);
}

If you want to assign your product to some category, simply call product.list method and category.list method to get product id and category id.

After that, run category.assign method.

public function apiAssign($params)
{
  $params = array(
    'product_id'     => 69,
    'category_id'    => 20,
  );
    
  return $api->request('category.assign', $params);
}

For more methods jump into documentation.

When signing up for API2Cart account, you are asked to provide name, e-mail address, password.

When adding a new store, you are asked to provide API key and store URLs. You may also be asked to provide your direct database connection to speed up the process. We take appropriate security measures to protect your information. Find out more about our Privacy Policy.

• • provide API Key/Token and password if it is a hosted platform
  • or use bridge files to establish connection to other carts.

See the full list below (in alphabetic order):

For more information about how to get your API Key/Token follow this link.