# Shopify Plugin

## Overview

### Installation

#### [App Installation](https://docs.forter.com/extensions/app-installation)  
#### [Front-end Integration](https://docs.forter.com/extensions/nlgJ-front-end-integration)  
#### [Configure Actions](https://docs.forter.com/extensions/configure-actions)  
#### [Increasing API Limits](https://docs.forter.com/extensions/increasing-api-limits)  
#### [PayPal Transactions](https://docs.forter.com/extensions/YA0A-paypal-transactions)  
#### [Dispute Notifications](https://docs.forter.com/extensions/dispute-notifications)  
#### [Testing](https://docs.forter.com/extensions/tf7l-testing)  
#### [Traffic Review](https://docs.forter.com/extensions/traffic-review)  
#### [Payment Method Review](https://docs.forter.com/extensions/payment-method-review)

## App Installation

### [Shopify Plugin Installation](https://docs.forter.com/extensions/app-installation#shopify-plugin-installation) Shopify Plugin Installation

### [Shopify Public App Installation](https://docs.forter.com/extensions/app-installation#shopify-public-app-installation) Shopify Public App Installation

Below are step-by-step instructions for installing Forter's official Shopify Public App. Please make sure you've selected the appropriate environment and are logged into the Shopify store you want to integrate prior to initiating the installation.

### [1. Provide your shopify siteDomain](https://docs.forter.com/extensions/app-installation#1-provide-your-shopify-sitedomain) 1. Provide your shopify siteDomain

Provide your Shopify site domains - both test and production - to your Forter Implementation Engineer. You can find this in your **Shopify Domains** section as {your-shop}.myshopify.com

This domain will be securely added to Forter's database to allow for a seamless install.

### [2. Review your Forter Portal Environment](https://docs.forter.com/extensions/app-installation#2-review-your-forter-portal-environment) 2. Review your Forter Portal Environment

Log into your Forter portal and make sure you've toggled to the environment you want to install your Shopify app and the environment that corresponds to the domain you've provided to your Forter Implementation team in step 1 (i.e. "myteststore" goes to your Forter portal sandbox instance, "myprodStore" goes to your Forter portal Production instance)

### [3. Install the Forter App from the Listing Page](https://docs.forter.com/extensions/app-installation#3-install-the-forter-app-from-the-listing-page) 3. Install the Forter App from the Listing Page

**Initiate the Install from the app page**  
Log into the Shopify store you want to install and go directly to Forter's Shopify App link: [https://apps.shopify.com/forter](https://apps.shopify.com/forter "https://apps.shopify.com/forter")

**Note** - Forter's Shopify app has "hidden" status so it cannot be searched for in the marketplace. You'll need use the direct link above

**Initiate the Install Provide Permissions to Forter**  
Once you've initiated the Installation, an OAuth handshake will occur. You'll see a Shopify screen confirming that you will be giving Forter's app customer and store permissions. Click on the **Install app** button to confirm the store permissions for the Forter app.

### [4. Redirect to Forter portal](https://docs.forter.com/extensions/app-installation#4-redirect-to-forter-portal) 4. Redirect to Forter portal

Once you've clicked and confirmed the "Install" button on Shopify, you should be redirected back to your selected Forter portal account and environment.

Visit the [Portal Shopify Settings Page](https://portal.forter.com/app/developer/settings/shopify "Portal Shopify Settings Page") to confirm the installation. You should see your store domain and a list of actions for each Forter decision listed below.

**Note** - By default, all post-decision actions will be set to "No Action". Depending on the Forter Portal and Shopify store environment you've installed, you can adjust these configurations and create the appropriate decision tags.

## [Uninstallation](https://docs.forter.com/extensions/app-installation#uninstallation) Uninstallation

Below are step-by-step instructions for uninstalling Forter's Shopify App.

### [Uninstalling the Forter Shopify App](https://docs.forter.com/extensions/app-installation#uninstalling-the-forter-shopify-app) Uninstalling the Forter Shopify App

To fully uninstall your Shopify app installation so that it only points to one Forter environment (i.e. Production), please follow the steps below:

### [1. Go to your Apps and Sales Channels](https://docs.forter.com/extensions/app-installation#1-go-to-your-apps-and-sales-channels) 1. Go to your Apps and Sales Channels

Log into your Shopify Admin and go to your app settings. The path should be: **Settings** > **Apps and sales channels** The URL should be: [yourstorename].myshopify.com/admin/settings/apps/development.

### [2. Finalize the Uninstall](https://docs.forter.com/extensions/app-installation#2-finalize-the-uninstall) 2. Finalize the Uninstall

Click into your existing app and click on the **Uninstall app** button on the upper right hand corner of your app settings to uninstall

### [3. IMPORTANT - Wait 15 minutes to reinstall](https://docs.forter.com/extensions/app-installation#3-important-wait-15-minutes-to-reinstall) 3. IMPORTANT - Wait 15 minutes to reinstall

Please wait at least 15 minutes _AFTER_ uninstalling the plugin before initiating a new plugin installation on the same Forter portal site. This will allow the Forter system to clear the webhook cache and ensure a smooth re-install process.

**Note**: If you are changing the Shopify store you want to install, please contact Forter support or your Implementations manager and provide the new Shopify domain. This is a requirement in order to complete the installation with a new store.
