Magento Installation and User Guide


The AutomaticFFL™ Checkout App enhances the Checkout of a Magento / Adobe Commerce store, making it convenient for customers to ship their purchased firearms to a local Federal Firearms Licensee (target dealer).

The application provides facilities for the store owner to define which products must be shipped to a Target Dealer, and which ones they can be shipped to.

Customers of the store are provided with a dealer locator powered by Google Maps. The locator is presented to the customer on the checkout page, and allows them to easily search for, and select a target dealer. Customers are unable to complete a firearms-related purchase without first selecting a target dealer.

See home page for pricing

Super Easy Installation

Use composer to install the extension at this repository

Create an AutomaticFFL account

Add a payment method

Create a store

Obtain a Google Maps API Key

Configure the extension in your Magento admin panel

Installation Guide

Install Magento Extension from Repository

Installation of the AutomaticFFL Magento Extension should be done via Composer. See the GitHub repository for developer installation instructions.

Create Admin Account

Visit the AutomaticFFL admin home to create an account.

Add a Payment Method

Click the SET UP PAYMENT link and follow the instructions to save your payment method in our Braintree payment vault.

why is this safe?

Create a Store

Click the “Add your first storefront” link.

Choose Magento from the top of the “Create a new store” page and fill in the form.

Obtain Google Maps API Key

If you do not have a Google developer account already, visit Google Maps Platform and click the Get Started button to obtain a key. Google offers a generous number of free requests. If your site experience extremely high traffic, you may need to pay for additional requests.

Configure Magento Extension

From, if you did not leave the “Create a new store” page open, click the EDIT link on the store profile to give you access to the Store Hash and the Store Secret.

In the admin panel of your Magento / Adobe Commerce store, open the configuration panel. Copy and paste the Store Hash and the Google API Key into the appropriate fields.

Inventory Management

When you install the Magento extension, a new attribute called “FFL Required” will be added to your attributes. Make sure this attribute is available in all of the attribute sets you use for firearms in your product catalog.

On each firearm product in your catalog, enable the “FFL Required” setting.

Customer Experience

Depending on the contents of a customer’s cart, extra steps will be added to the checkout process. These steps ensure that products restricted to FFL shipping cannot be shipped (intentionally or otherwise) directly to the customer’s shipping address.

If a customer has added a product to their cart that can only be shipped to a target dealer, a button to open the dealer locator will appear at the top of the checkout. A prompt will then appear instructing them to use the locator to select the dealer of their choice.

Clicking on ‘Select Your Dealer’ will open the locator. Using the embedded map interface, the customer can then search any location to find authorized dealers within a specific radius.

After searching, a list of dealers in the area will be displayed. If the customer fails to select an FFL, they will not be able to complete the checkout process so long as the restricted product remains in their cart.

Once a customer has successfully selected a dealer, the shipping information of that dealer will be loaded into the checkout. All FFL-restricted products will then be assigned to that shipping address. If a customer has purchased both restricted and non-restricted products, the extensions will automatically separate them. Restricted products will receive the shipping address of the dealer, while any non-restricted products will have the shipping address supplied by the customer.

Dealer Management

AutomaticFFL gives you the ability to customize the list of dealers that will be available for checkout. See Dealer Management for complete details.