HomeGuidesRecipesAPI
HomeGuidesAPILog In

Stripe Connector Installation and Upgrade

Payment Gateway

Installation

📘

Configuration and Usage

For configuration and usage of this connector please go to the Stripe Connector guide.

Installation Requirements

📘

SaaS Environments

No action needs to be taken for customers on cloud deployments hosted by Smart Communications as the environment should already have this connector installed. If you need a licence please contact your Customer Service Manager.

For customers on self-hosted deployments (either in the cloud or on-premise), consider the following requirements before installing or upgrading this extension:

  • You must have administrator/elevated permissions to the SmartIQ web server, including the ability to copy and replace files in the SmartIQ installation folder. This is usually c:\inetpub\wwwroot\<<productname>> however may vary from system to system.

  • Ensure you have a compatible version of the connector with your current SmartIQ system (Connector and SmartIQ should match versions)

🚧

️ ️Licence key required

You must have a valid license key to enable the Stripe connector module (id 9015). If you do not have one, please contact your SmartIQ representative.

️ Schedule Downtime

Changes to the configuration may cause interruptions to users in forms.

  • Before installing this Connector in a production SmartIQ environment, ensure the environment is backed up.
  • It is recommended that this installation is tested in a non-production environment first, and installed during scheduled downtime.

Installation Files

You must have the following installation files:

  • StripeConnector.dll
  • Stripe.net.dll
  • System.Collections.Immutable.dll

Installation and Configuration

Creating Stripe Sandbox

Stripe sandbox will enable you to create a sandbox for testing and development. This is also where you will obtain the Publishable and Secret API keys required to configure the connector. For more information, refer to Stripe.

Installation

  1. Copy the following files on SmartIQ Web Server under [<<productname>> Produce Path]:
  • StripeConnector.dll
  • Stripe.net.dll
  • System.Collections.Immutable.dll
  1. Using a text editor such as Notepad, open the following file: [<<productname>> Produce Path]\appsettings.json locate [Extensions] and add
"StripeConnector.Stripe, StripeConnector"
  1. Using a web browser, navigate to the SmartIQ Produce application to allow the system to register the connector.

  2. Check if Content-Security-Policy rule is defined in [<<productname>> Produce Path]\web.config inside <httprotocol> <customHeader>. If that's the case,
    make sure you add: https://checkout.stripe.com and https://q.stripe.com. Resulting into something like:

<add name="Content-Security-Policy" value="default-src 'self' 'unsafe-inline' data: https://cdnjs.cloudflare.com https://maxcdn.bootstrapcdn.com https://*.googleapis.com https://fonts.gstatic.com https://checkout.stripe.com https://q.stripe.com" />
  1. Add the a reference to the netstandard assembly in [<<productname>> Produce Path]\web.config inside <system.web><compilation> <assemblies>. The line you need to add is:
<add assembly="netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51"/>

So the compilation section will look something like this:

<compilation defaultLanguage="vb" debug="true" strict="false" explicit="true" targetFramework="4.7.2">
      <assemblies>
        <add assembly="System.Runtime, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add assembly="netstandard, Version=2.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51"/>
      </assemblies>
    </compilation>

The Connector should now be installed and ready for configuration.