First, go to the Account Manager page (https://account.demandware.com/dw/account/Home), generate dw_client_id (Client Id) and dw_api_pass (Api Password).

Then, add permissions for API2Cart API, so that our API could retrieve data from the store. Go to your Admin panel: Administration > Open Commerce API Setting > Select type: Shop & Data > Select context: Global

Then, specify client application-specific configurations:

Global permissions

  
  {
    "_v":"22.6",
    "clients":[
       {
          "client_id":"YOUR_CLIENT_ID",
          "allowed_origins": [

          ],
          "resources":[
             {
                "resource_id":"/products/*/prices",
                "methods":["get"],
                "read_attributes":"(**)",
                "write_attributes":"(**)",
                "config":{
                   "product.prices.price_book_ids":"PRICE_BOOK_ID_1,PRICE_BOOK_ID_2,...,PRICE_BOOK_ID_N"
                }
             },
             {
                "resource_id":"/**",
                "methods":[
                   "put",
                   "get",
                   "post",
                   "patch"
                ],
                "read_attributes":"(**)",
                "write_attributes":"(**)"
             }
          ]
       }
    ]
  }
  

Or per resource permissions

  
  {
  "_v": "22.6",
  "clients": [
    {
      "client_id": "YOUR_CLIENT_ID",
      "allowed_origins": [],
      "resources": [
        {
          "resource_id": "/products/*/prices",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)",
          "cache_time": 0,
          "config": {
             "_comment": "Add a comma-separated list of the price book ids currently active in the organization",
             "product.prices.price_book_ids": "REPLACE_ME_WITH_PRICE_BOOK_IDS"
          }
        },
        {
          "resource_id": "/baskets",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*",
          "methods": [ "get", "patch", "delete" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/billing_address",
          "methods": [ "put" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/coupons",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/coupons/*",
          "methods": [ "delete" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/customer",
          "methods": [ "put" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/gift_certificate_items",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/items",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/items/*",
          "methods": [ "patch", "delete" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/notes",
          "methods": [ "post", "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/payment_instruments",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/payment_instruments/*",
          "methods": [ "patch", "delete" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/payment_methods",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/shipments",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/shipments/*",
          "methods": [ "patch" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/shipments/*/shipping_address",
          "methods": [ "put" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/shipments/*/shipping_method",
          "methods": [ "put" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*/shipments/*/shipping_methods",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/baskets/*",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/auth",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/password_reset",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*",
          "methods": [ "get", "patch" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*/addresses",
          "methods": [ "get", "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*/addresses/*",
          "methods": [ "get", "patch", "delete" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*/baskets",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*/orders",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*/password",
          "methods": [ "put" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*/payment_instruments",
          "methods": [ "get", "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customers/*/payment_instruments/*",
          "methods": [ "get", "delete" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/orders",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/orders/*",
          "methods": [ "get", "patch" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/orders/*/notes",
          "methods": [ "get", "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/orders/*/payment_methods",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/orders/*/payment_instruments",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/order_search",
          "methods": [ "post" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/products/*",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/products/*/availability",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)",
          "cache_time": 0
        },
        {
          "resource_id": "/site",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/categories/*",
          "methods": [ "get" ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        }
      ]
    }
  ]
}
  

Global permissions

{
  "_v":"22.6",
  "clients":[
     {
        "client_id":"YOUR_CLIENT_ID",
        "resources":[
           {
              "resource_id":"/**",
              "methods":[
                 "put",
                 "get",
                 "post",
                 "patch"
              ],
              "read_attributes":"(**)",
              "write_attributes":"(**)"
           }
        ]
     }
  ]
}

Or per resource permissions

      
      {
  "_v": "22.6",
  "clients": [
    {
      "client_id": "YOUR_CLIENT_ID",
      "resources": [
        {
          "resource_id": "/sites",
          "methods": [
            "get"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/sites/**",
          "methods": [
            "get"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/catalog_search",
          "methods": [
            "post"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/product_search",
          "methods": [
            "post"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/products/*",
          "methods": [
            "get",
            "patch"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/products/*/variant_search",
          "methods": [
            "post"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/products/*/variations",
          "methods": [
            "get"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/products/*/variation_attributes",
          "methods": [
            "get"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/customer_lists/**",
          "methods": [
            "get",
            "post"
          ],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/inventory_lists/*",
          "methods": ["patch"],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
          "resource_id": "/inventory_lists/*/product_inventory_records/*",
          "methods": ["patch", "put", "get"],
          "read_attributes": "(**)",
          "write_attributes": "(**)"
        },
        {
           "resource_id":"/system_object_definitions/**",
           "methods":["get", "put" , "patch", "post", "delete"],
           "read_attributes":"(**)",
           "write_attributes":"(**)"
        }
      ]
    }
  ]
}
      
    

To upload the bridge to Magento Commerce cloud stores and make it available on the URL, the store developer should do the following steps:

1) Add the bridge folder to the project root directory via GIT:

2) Edit the file .magento.app.yaml:

Add the following configurations:

"/bridge2cart":

root: "/"

passthru: "/bridge.php"

index:

bridge.php

expires: -1

scripts: true

allow: true

3) Push changes to the repository and merge them to master.

WooCommerce Plugin Installation

1. 1. Go to your admin panel and click on ‘Plugins” menu -> "Add New"
2. 2. Choose API2Cart Connector and click “Install Now” button.
3. 3. After downloading the plugin, click “Activate Plugin” to get it rolling.

Magento Plugin Installation

1. 1. Go to the Magento admin panel and navigate System -> Magento connect -> Magento connect manager.
2. 2. Login with the same credentials you use to access your admin panel.
3. 3. Then under Direct package file upload you can Upload package file. Click the Choose File button, select the extension .tgz file, and click Upload. To ensure the plugin is installed correctly, use the PHP version that matches the Magento version requirements.
4. If the version of PHP conflicts with the version of Magento in use, we suggest that you should install it using the following instructions:
5. 1. Unzip the archive and upload the files to the server.
6. 2. Clear the Magento cache by going into System-> Cache Management, selecting all in the list, choosing the Refresh option in the dropdown menu, and finally clicking Submit.
7. 3. Go to System-> Configuration and find API2CART Bridge in the menu on the left.

PrestaShop Plugin Installation

1. 1. Login into your Prestashop admin panel.
2. 2. Go to the module tab and click “Add a module from my computer”
3. 3. In “Module file” box click “Browse” button.
4. 4. Select module *.zip file from your computer.
5. 5. Complete the process by pressing “Upload this module” button.

Cs-Cart Plugin Installation

1. 1. Login into your Cs-Cart admin panel.
2. 2. Click on the navigation "Add-ons" -> "Manage Add-ons".
3. 3. Click on the "+" button to upload the plugin.
4. 4. In the dialog box that appears, click on the "Local" option to download the plug-in *.zip file
5. 5. Click the "Upload & install" to upload the installation.

OpenCart Plugin Installation

To connect Walmart store you will need:

• Client Id
• Client Secret
• Walmart environment

Log in to the seller account and go to the API Key Management section. (Or you can switch to https://developer.walmart.com/ and log in there under your account).

There you can get access to existing keys for production and sandbox environments.

You can also generate a new pair of client id and client secret, providing full access for this key.

Use Client Id and Client Secret when adding store (walmart_client_id and walmart_client_secret parameters).

Parameter walmart_environment you can leave empty or specify the value production if the production key is used. In case the sandbox key is used be sure to specify the sandbox value for walmart_environment parameter.

To connect your eBay account to API2Cart, send

request using

from your API2Cart account. This request should contain the following parameters:

• • api_key = YOUR_API_KEY
  • cart_id = EBay

• verify = true
• ebay_client_id
• ebay_client_secret
• ebay_refresh_token
• ebay_site_id
• ebay_environment = production

How to get parameters marked in red above:

• ebay_client_id - App ID

• ebay_client_secret - Cart ID

Go to the eBay developers program page

Log in to your account or register one. After the successful authentication, you will land on Application Keys page, which looks like this:

On the screenshot above we’ve highlighted the keys needed to connect your eBay account to API2Cart:

• ebay_refresh_token

Go to the User Tokens page: https://developer.ebay.com/my/auth.

To get RuName, go to User Tokens tab-> Get a Token from eBay via Your Application -> press Add eBay Redirect URL - there will appear a setting page -> tick the box under OAuth Enabled -> get your parameter RuName (eBay Redirect URL name).

On the same page (User Tokens) set up Sign-in settings. 1) 2) Switch on OAuth: 3) Your auth accepted URL - here specify a URL link on which you’ll get the code, which is a very important parameter. 4) Save settings. Click the link in the field: Your branded eBay Sandbox Sign In (OAuth) - copy this big URL link and paste it into the address bar. There you will see the following page:

Sign in to your seller eBay account, then go to page Grant application access to Token Name: press Agree, then you will be redirected to the page you’ve specified in the field Your auth accepted URL.On that page you will receive data in the following format: state:null

code:v^1.1#i^1#r^1#p^3#f^0#I^3#t^Ul41Xzg6MDM5RENGM0E3NEIxNTJDQkU5QjQxMDA2MjA5NjRBOTRfMV8xI0VeMTI4NA==

Send POST request to the link https://api.ebay.com/identity/v1/oauth2/token, in case you use production environment. Otherwise, if you use sandbox send a request to this link - https://api.sandbox.ebay.com/identity/v1/oauth2/token. Specify in Body parameters grant_type, code and redirect_uri, like we did on the screenshot below. Make sure "code" parameter value is not url encoded before passing it as a request parameter

On the Authorization tab choose Type: Basic Auth, and in fields Username and Password paste you client_id and client_secret, as we did in the screenshot below.

6) ebay_site_id:

Each eBay site maps to a unique eBay global ID. You can get it from https://developer.ebay.com/devzone/merchandising/docs/concepts/siteidtoglobalid.html

If you don't set this parameter, it will be 0 (US) by default.

Congrats!

After you press Send, eBay will give you

The instruction above is based on official eBay documentation: https://developer.ebay.com/api-docs/static/oauth-qref-auth-code-grant.html

0) Note: If you are trying to connect another marketplace (not Amazon.ca, Amazon.com, Amazon.com.mx) or you need to get customer's personal info (name, address etc.) you must register your developer:

• 1. Go to the User Permissions page in Seller Central and log into your Amazon seller account as the primary user.
• 2. In the Amazon MWS Developer Permissions section, click the Register as a developer button.
• 3. Fill out the Register as a developer form.

Be sure to click the Verify button to verify email addresses that you enter.

• 4. Click the Sign up button.
• 5. Your Developer ID appears.
• 6. Click Your developer credentials.

Your AWS Access Key ID and Secret Key appear. Use these credentials when adding store (amazon_access_key_id amazon_secret_key).

1) The seller goes to the User Permissions page in Seller Central and logs into their Amazon seller account as the primary user.

2) Go to Settings > User Permissions page in Seller Central.

NOTE: The owner of the Amazon account is the only one who will see the developer area on the User Permissions page. Not even a full access super-admin can see it, only the owner.

3) The seller clicks the Authorize a developer button. In the Developer name text box, the seller enters the name of the developer that they are authorizing. This doesn't need to be the exact name; it is merely for the seller's reference in the future. Example: API2Cart.

4) In the Developer ID text box, the seller enters the Developer ID: 0677-7064-4291 (or your Developer ID obtained in paragraph 0) and then clicks the Authorize developer button.

5) The seller's MWS Auth Token appears.

6) Add Amazon store in your API2Cart account using the credentials obtained in the previous steps.

amazon_access_token (MWS Auth Token)

amazon_seller_id (Seller ID)

amazon_marketplaces_ids (comma separated string of values specified in Marketplace ID)

If you were doing the paragraph 0, you need to insert the last two parameters

amazon_access_key_id

amazon_secret_key

To connect Etsy account to API2Cart you’ll need to either:

• - create an application with marketplace-wide access (needs to go through approval process by Etsy);
• - or create private application that will have access to a single store data only.
• Both could be done via link below:

https://www.etsy.com/developers/register

Once you register an account and you will receive following credentials for your app:

KEYSTRING

SHARED SECRET

2. Perform GET request to https://openapi.etsy.com/v2/oauth/request_token using Oauth 1.0 authorization

Consumer Key - KEYSTRING from step 1

Consumer Secret - SHARED SECRET from step 1

Response body will look like “login_url=URL”

You should urldecode URL and provide it to the account owner.

3. Account owner follows URL, confirms application access to the account and receives VERIFICATION CODE.

4. Perform GET request to https://openapi.etsy.com/v2/oauth/access_token?oauth_verifier=VERIFICATION CODE

Using Oauth 1.0 authorization

Consumer Key - KEYSTRING from step 1

Consumer Secret - SHARED SECRET from step 1

Access Token=(oauth_token from URL from step 2)

Token Secret=(oauth_token_secret from URL from step 2)

Verifier=(VERIFICATION CODE from step 2)

Response should look like

oauth_token=<ACCESS TOKEN>&oauth_token_secret=<TOKEN SECRET>

5. Finally you can connect Etsy store in your API2Cart account using the following parameters: KeyString - KEYSTRING from step 1

Shared Secret - SHARED SECRET from step 1

Access Token - ACCESS TOKEN from step 4

Secret Token - TOKEN SECRET from step 4

To connect Ecwid store via API2Cart, you need to register and list your branded External APP on Ecwid App Marketplace. It will only serve to receive OAuth Access Token which is later on used to add a store to the API2Cart system.

Find out what you need to register here.

During the registration process, you will need to specify OAuth Scopes - the resources that will be accessed through Ecwid API. That will directly affect which of our methods will work through the Access Token that your App receives.

Why do you need to register your App?

If API2Cart lists its App on the Ecwid marketplace, then the store owner will install the API2Cart App, not yours

Ecwid API works only on a paid subscription. For more details click here.

However, you can specify that you need such an account for testing and the Ecwid team will provide you with a paid account for free for development and testing purposes.

If you have an Ecwid store with a paid subscription, you can get an Access Token without waiting for the approval of your APP. To do this, you need to install the "Play with Ecwid API and Postman" App.

• 1. Install App by clicking on the link


• 2. After installation, click “Connect with Ecwid”





• 3. Next, you need to copy Postman collection url





• 4. Import collection









• 5. Copy the token from the request settings







• 6. Add a store to API2Cart. To do this, you need to specify:

• - Ecwid Store Id (where to get it you can find here)
• - Ecwid Access Token (value received in step 5)
• - Store Url (which can be found in the Ecwid Control Panel)

To connect Squarespace store to API2Cart and start working with the data from it, you need to register a new account.

To add the store built on Squarespace, you will need to have the Store URL and squarespace_api_key.

To get squarespace_api_key, you have to go to Squarespace admin panel, click on Settings, choose the option Advanced in the menu, click on Developer Api Keys, and Generate Key.

To connect CommerceHQ store to API2Cart and start working with the data from it, you need to register a new account.

To add the store built on CommerceHQ, you will need to have the Store URL, commercehq_api_key and commercehq_api_password.

To get commercehq_api_key and commercehq_api_password, you have to create a Private App in CommerceHQ admin panel.

For that go to Dashboard, choose Apps Store in the menu, press the button Add a Private App.

After the creation of Private App, you will see the required data for connecting CommerceHQ store to API2Cart.

Getting credentials

Create a client

Set token lifetime

To work with orders endpoint, you need to add a store with the parameters hybris_username, hybris_password.

Also, the user must belong to groups such as customersupportagentgroup and customermanagergroup.

To work with warehouses and get store data via cart.info, the admin user must also belong to a group warehouseadministratorgroup.

This can be done by simply assigning the user to a group, or if the user is already in a group and there is a need to expand its capabilities, then you can add its subgroup to the group.

If everything is done correctly, you can add a store.

If, when trying to add a store, an error occurs due to incorrect permissions, for example, due to the absence of a group, it is necessary to delete the incorrectly generated OAuth Access Token. If you try to regenerate it, Hybris will still give the same token until it expires.

The request examples (Postman collection)

If Store is Expired

for HSQL database:

./hybris/bin/platform/license.sh -temp CPS_SQL

for MySQL:

/hybris/bin/platform/license.sh -temp CPS_MYS

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

• lightspeed_api_key
• lightspeed_api_secret

There are two ways to get them:

1. The store owners can contact the LightSpeed Customer Service department in order to receive api_key and api_secret credentials.
2. You can develop your App and publish it on LightSpeed App Store. After that, you will get APP_KEY and APP_SECRET. Then you should specify the callback URL to which store credentials come. You can do it in the partner environment (Under ‘Apps > (APP NAME) > Success URL’).

When the store owner installs your App, credentials to the store will come to your callback URL (language, shop id, signature, timestamp, token, and cluster_id). From all the credentials you need only a token.

Now you have credentials needed for adding Lightspeed store to API2Cart.

• lightspeed_api_key = APP_KEY
• lightspeed_api_secret = md5(token + APP_SECRET);

More info you can find on LightSpeed docs.

To integrate with Shift4Shop via the REST API, you need to create and authorize an application with necessary scopes for the store. To do this, you need to have a Shift4Shop developer account https://developer.3dcart.com/".

In the dashboardhttps://devportal.3dcart.com/dashboard.asp you need to create a new application.

Choose the necessary scopes.

It is recommended to select all scopes, because after adding the store they cannot be changed.

Next, you need to authorize this application in your store.

After that, you will be redirected to a page where you will need to specify the URL of the Shift4Shop store.

Next, you will be redirected to a page where you need to accept the terms and authorize the application on the store.

After that, information about the store will appear on the application page in the dashboard.

To connect Shift4Shop to API2Cart, you need a private_key and an access_token credentials.

To integrate with Wix, you need to have a Wix developer account https://dev.wix.com/.

1. First of all, you need to create your own application.

Specify Redirect URL and App URL.

On this page, you should copy App ID and Secret Key which will be needed in the next steps.

You also need to select the necessary permissions. The minimum required permissions to add a store to API2Cart are full access to Wix Stores -> Read Stores, Wix Developers -> Manage Your App and Business Info -> Manage Consent Policy.

It is worth giving full access here. If you change permissions later, you will have to re-add the application to the store.

2. Next, you need to add an application to the store.

Here you should select added store or add the new one.

Next, the window opens with a page you specified in the App URL. You need to copy the token from the URL.

3. Here you form the URL for installing the application.

    https://www.wix.com/installer/install?code=<code>&appId=<app_id>&redirectUrl=<redirect_url></redirect_url>
    

code is the token that you copied in the previous step.

After that, you should follow this URL in a browser and click Add to Site.

Next, there will be a redirect to redirectUrl, where you need to take the code from the URL.

4. After that you need to make the following request:

curl -X POST \
  https://www.wixapis.com/oauth/access \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "authorization_code",
    "client_id": <APP_ID>,
    "client_secret": <APP_SECRET>,
    "code": <AUTH_CODE>
}'

As a result, you get refresh_token.

5. In order to add a store to API2Cart you need to specify the following fields:

In order to connect Magento 2 API to API2Cart, you need to do the following:

1. Choose Integrations in the menu (System -> Integrations)


2. Press the button "Add New Integration"


3. Enter the name and data of the admin account


4. In the API tab, set access to all entities. After that, choose "Save"


5. Activate the integration



6. Fill in the received data for authorization on the API2Cart APP

To integrate with Zid platform, you need to follow this instruction.

1. In order to get the needed credentials, you need to have a Zid developer account https://partner.zid.sa/.

It is necessary to create an application.



All information can be filled in English and Arabic.



It is required to select the necessary scopes. It is recommended to select all permissions because, in case of their change, you will need to get all tokens again. The page below contains the Client ID and Client Secret that will be needed to receive the tokens.



Next, you need to fill in detailed information about the application.



There is no need to fill in anything on the following page.



On this page, if necessary, you can set up a paid subscription to the application.


2. It is necessary to generate a URL for adding the application to the store, using the data from the previous step.

https://oauth.zid.sa/oauth/authorize?client_id=&redirect_uri=&response_type=code

After that, you need to use the mentioned URL in the browser. It is necessary to provide the access requested by the application.



As a result, it should redirect to the Redirect URL. You will see the code in the browser line.


3. You need to make a request.

curl -X POST \
  https://oauth.zid.sa/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "authorization_code",
    "client_id": ,
    "client_secret": ,
    "redirect_uri": ,
    "code": 
}'




The result of the request will be access_token, authorization and refresh_token.



To add a Zid store to API2Cart, you need to fill in the appropriate fields.