Follow the steps below to install the Big Commerce Connector.

Install the connector as hosted service on an IIS website

The hosted service requires ISS to have the “ASP.NET Core Runtime 6.x” installed. On Windows, we recommend installing the Hosting Bundle version.

Unzip all the files from “Perfion Connector for BigCommerce - x.y.z.zip“ to the location for the IIS website e.g. “C:\inetpub\wwwroot\BigCommerceConnector”.

Make sure IIS user has full control of AppData folder as it needs to write to this folder.

Create a website

Enable Application Initialization and set

Set Start mode to AlwaysRunning at the Application Pool

Set Perload Enabled = True at the web site

Install a Perfion API

Install a Perfion API and create an Access token in Perfion. Set the “GetDataUri” and “PerfionToken“ and E-Commerce “Channel” in the appsettings.json file. See the Perfion API guide.

The Perfion API must be installed as a secure website (HTTPS). If the Perfion API runs with a self signed certificate, make sure the BigCommerce Connector has access to this certificate e.g. install the self signed certificate as a “Trusted root certification authorities“ via Microsoft Management Console (MMC.exe).

BigCommerce account

At the Big Commerce account create a “Store-level API account” with access level: “Channel settings” read-only and “Products” modify.

Set the “API path” and the “Access token” in the appsettings.json file

Logging and debugging

It is possible to enable logging/debugging via Serilog. To setup Serilog, add serilog configuration to the appsettings.json file. An example of a Serilog setup:

{
  "AllowedHosts": "*",
  "PerfionApi": {
    "GetDataUri": "https://localhost:123/PerfionAPIService/perfion/getdata.asmx",
    "PerfionToken": "iIsIlBlcmZpb25Vc2VyIjoiQWRtaW4iLCJpc3MiOiJQZXJmaW9uLkFQSVNlcnZpY2UiLCJhdWQiOiJQZXJmaW9uLkNsaWVudCJ9.OLQavtaPI6_D6OmYdR6tZzvyVZJIVMKp9Mw-rdbq7dc",
    "Channel": "Channel A"
  },
  "BigCommerceApi": {
    "BaseUri": "https://api.bigcommerce.com/stores/abcdefghij/v3/",
    "AccessToken": "aabbccddeeffgghhiijj",
    "UserAgent": "Perfion.BigCommerceConnector"
  },
  "Serilog": {
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "System": "Warning",
        "Microsoft": "Warning"
      }
    },
    "WriteTo": [
      {
        "Name": "File",
        "Args": {
          "path": "c:/temp/logs/log.txt",
          "rollingInterval": "Day",
          "fileSizeLimitBytes": null,
          "retainedFileCountLimit": 15,
          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level}] [{SourceContext}] [{RequestId}] : {Message} {Exception}{NewLine}"
        }
      }
    ]
  }
}