2A-FFL Woocommerce Plugin Documentation

2A-FFL WooCommerce Plugin

Enable compliant firearm sales with FFL dealer integration

🛒 Plugin Overview

The 2A-FFL WooCommerce Plugin seamlessly integrates Federal Firearms License (FFL) dealer selection into your checkout process. Ensure full compliance when selling firearm-related products by allowing customers to choose their preferred FFL dealer for product pickup.

✨ Key Features

  • Integrated FFL dealer search at checkout
  • Interactive map display with nearby dealers
  • ATF-controlled product designation
  • Customizable warning messages
  • Flexible checkout block positioning

📋 Prerequisites

Before installation, ensure you have:

1 Install the Plugin

  1. Navigate to WordPress Admin Panel → Plugins → Add New
  2. Click Upload Plugin and select the plugin .zip file
  3. Click Install Now, then Activate the plugin
  4. The plugin will appear in your Plugin List and Admin Sidebar
Plugin in Admin Sidebar

2 Enter API Key & Activate

  1. Go to 2A Data FFL in the WordPress Admin Panel
  2. Enter your API key in the FFL API Key field
  3. Click Activate/Validate API Key
  4. Wait for validation confirmation
  5. Click Save Changes

✅ Success: The plugin will automatically validate and enable features once a valid key is entered.

API Key Configuration

3 Configure Checkout FFL Selection

🗺️ Google Maps API Key

Enter your Google Maps API key to enable the interactive dealer map on checkout. This allows customers to visually select their nearest FFL dealer.

How to get your key

⚠️ Firearm Warning Message

Customize the warning message displayed during checkout. Use this to inform customers about regulations, requirements, or important firearm purchase information.

🎨 Checkout Colors

Customize plugin element colors to match your store’s design and branding.

📍 Checkout Block Position

Choose where the FFL selection block appears on your checkout page. You can select a predefined position or use the [atf_ffl_map] shortcode for custom placement.

4 Mark Products as ATF-Controlled Items

⚠️ Important: Each firearm product must be individually marked as ATF-controlled to require FFL selection at checkout.

  1. Navigate to Products → All Products
  2. Edit the product you want to mark as ATF-controlled
  3. In the Product Data section, click the General tab
  4. Check This is an ATF-controlled item
  5. Click Save Changes
  6. Repeat for each ATF-controlled product in your catalog
ATF-controlled item checkbox

🎉 Setup Complete!

Your WooCommerce store is now configured to sell firearm-related products with full FFL transfer compliance. Customers purchasing ATF-controlled items will be prompted to select an FFL dealer during checkout.

Need Help?

Our support team is ready to assist with plugin setup and configuration.

Contact Support →

Explore More Solutions
FastBound FFL Software

Our FastBound FFL software allows any Wordpress website to integrate the power of FastBound into your website, for only $49 per month.

FFL API Plugin

Utilize the most reliable FFL API for gun store websites and firearms ecommerce for just $69 per month.