g-FFL Checkout

Description

Built by a FFL, for FFL’s. This plugin will add a FFL search & selection widget to your checkout page for products requiring FFL Shipment.

FFL Checkout was originally built to meet the operational needs of my own FFL business. Over time, it has grown into the most complete FFL Checkout solution for WooCommerce — refined through input from hundreds of licensed dealers. The plugin empowers FFLs to stay compliant by capturing required information, enforcing shipping restrictions, and guiding customers through the purchasing process for firearms and ammunition. See the plugin in-action on garidium.com, and make sure to look at the FAQ section. Thank You, Gary (FFL Cockpit/Checkout Founder)

Feature Highlights:

  1. Advanced FFL Search & Selection – Easy-to-use FFL searching by zip code, distance, and name with intelligent list view on checkout page
  2. Interactive Mapping – Optional map view with no Google Maps API key required, reducing costs and complexity
  3. Mixed Cart Intelligence – Seamlessly handle orders with both FFL and non-FFL items, automatically managing shipping addresses
  4. State Compliance Management – Configurable ammunition compliance with automatic FFL routing for restricted states
  5. Document Management System – Secure customer upload portal for state licenses (FID/FOID cards) with state-specific requirements
  6. C&R License Integration – Direct API validation and document management for Curio & Relic licenses
  7. FFL Dealer Controls – Blacklist problematic dealers and prioritize customer favorite FFLs in search results
  8. Address Validation & Security – PO Box blocking, billing/shipping address matching enforcement, and name verification
  9. State Shipping Restrictions – Block firearms, ammunition, or all products by state with custom error messaging
  10. Enhanced Order Management – One-click ATF ezCheck integration, FFL document upload/download, and comprehensive order details
  11. Secure eFile System – Crowd-sourced FFL document storage with protected access for streamlined fulfillment
  12. Real-Time Compliance – Automatic detection of document requirements based on shipping state and cart contents

Subscription Required

While the plugin is free to download and install, it does require you to purchase a subscription. The plugin will not be useful without the subscription allows the plugin to connect to the required data services, providing the following features:

  1. Access to a database we manage that synchronizes weekly to the ATF FFL database
  2. Access to the eFile system to download and upload FFL documentation
  3. Access to Mapping and Geocoding features for displaying FFL locations on a map

To purchase a key, visit the g-FFL Checkout product page:

FFL Checkout Product Page

Please review our Terms and Conditions:

Terms and Conditions

Troubleshooting Guide

Click here for the Installation/Troubleshooting Guide

Screenshots

  • Here is what the plugin looks like on the checkout page. You will have the option to place the component in different locations. After the user enters in a zip code, a distance to search in miles, and an optional Name search, a list and map appear. The list will show FFL’s in the zip code provided, along with any nearby zip codes within the distance selected. There is an indicator in the list as to whether or not we have the signed copy of the FFL on file. If it’s green, we do… otherwise it’s red. The customer will then select a FFL from either the list or the map, and the shipping details will be auto-populated. The shipping address fields non-editable, except by selecting a FFL via the plugin component.
  • Using the top-right control in the map, you can go into a full screen map mode. You can hit the escape key or click on the same icon to revert back.
  • Once a customer has placed an order, in the order details view we add two buttons, one for downloading the FFL if it;s on file, and the 2nd to Launch the ATF’s ezCheck site to validate the FFL selected. These items are added in a new FFL Information section of the order page.
  • If the customer selected a FFL where there is no signed FFL on-file, we allow you to upload that copy once you receive it. This will help streamline the process for the next time someone asks to ship to this FFL.
  • The FFL ezCheck Button is a quick way to load ezCheck for the FFL selected by the customer, one-click.
  • The Download FFL will securely retrieve the FFL copy on-file. These links are not shareable and work for you as a subscriber to the g-FFL API

Installation

  1. Search for the plugin in the marketplace
  2. Click on “Install Now”
  3. Click on “Activate”
  4. Click on the “FFL Checkout” link in the admin panel
  5. Fill in the following information:
    • Set Checkout Message (change email in the message)
    • If you want to offer in-store pickup, put your FFL number in the “In-Store Pickup FFL#” field, otherwise leave it blank. This field requires the full FFL number with dashes.
    • Select the plugin position on the checkout page
    • Set your map on/off preference
    • Set the rest of your options as needed
  6. Click on “Save Changes”

FAQ

Why is this plugin better than the alternatives?

  • Built by an active FFL dealer who understands real-world compliance challenges and fulfillment needs
  • Product has been continuously improved through feedback from hundreds of current FFL Clients
  • We synchronize our FFL data with the ATF on a daily basis
  • Comprehensive compliance solution handling state restrictions, document management, and ammunition regulations
  • Mixed Cart support allowing for Firearms to be shipped to the selected FFL and Non-FFL items shipped to the customers shipping address
  • Cloud-based infrastructure on Amazon Web Services ensures minimal downtime and consistent performance, we don’t run our servers under our desks and hope for the best.
  • No Google Maps API key required for mapping features like other plugins require, reducing costs and complexity
  • Crowd-sourced FFL document database with signed copies available for instant download
  • Advanced dealer management tools including blacklisting
  • Real-time compliance detection and automatic document requirement enforcement
  • One-click ATF ezCheck integration and streamlined order management tools
  • Integrates with FFL Cockpit, the premier product feed and dropshipping automation product for FFL’s

How do I flag a product as FFL required?

  • Individual products: Check the “Requires FFL Shipment” checkbox in the product data section
  • Bulk operations: Select multiple products from the main products list and use bulk actions to set them as FFL required
  • The plugin automatically detects FFL items in the cart and activates the appropriate checkout flow
  • Ammunition products can also be marked as such, prompting the FFL Checkout workflow for states that require Ammunition to be shipped to FFL’s

How does mixed cart support work?

  • The plugin intelligently handles orders containing both FFL and non-FFL items
  • FFL items automatically ship to the selected dealer, while other items ship to the customer’s address
  • Customers see clear messaging explaining the split shipment process
  • Shipping addresses are automatically managed without customer confusion
  • Order details clearly separate FFL and direct-ship items for easy fulfillment

What state compliance features are included?

  • Configurable ammunition compliance with automatic FFL routing for restricted states
  • State-specific shipping restrictions for firearms, ammunition, or all products
  • Custom error messaging for blocked shipments by state
  • Automatic detection of document requirements (FID/FOID cards) based on shipping location
  • Real-time compliance checking during checkout to prevent violations

How does the document management system work?

  • Customers can securely upload required state licenses (FID/FOID cards) during checkout
  • C&R license integration with direct API validation and document storage
  • State-specific requirements automatically detected and enforced
  • All documents stored in protected directories with secure access controls
  • Automatic compliance verification based on shipping state and cart contents

What dealer management tools are available?

  • Blacklist problematic dealers to prevent them from appearing in search results
  • Customer favorite (last used) FFL appears first in search results for better user experience
  • FFL document upload/download system for streamlined fulfillment
  • One-click ATF ezCheck integration pre-filled with selected dealer information
  • Comprehensive order details with dealer contact information

How does address validation work?

  • Automatic PO Box detection and blocking for FFL shipments
  • Optional billing/shipping address matching enforcement for fraud prevention
  • Name verification to ensure FFL delivery names match billing information
  • Custom error messaging for validation failures
  • Real-time validation during checkout to prevent order processing issues

What happens if a customer tries to order from a restricted state?

  • The plugin automatically detects restricted states based on your configuration
  • Custom error messages explain why the order cannot be processed
  • Different restriction levels available: firearms only, ammunition only, or all products
  • Customers are clearly informed of restrictions before completing checkout
  • Orders are prevented from processing to avoid compliance violations

How does the subscription work?

  • Free setup fee with ongoing monthly subscription for data services
  • Synchronizes daily with the ATF FFLezCheck database
  • Full access to the eFile system for FFL document management
  • Mapping and geocoding features included
  • Priority support and feature updates included
  • No Google Maps API costs or hidden fees

Can I customize the appearance and messaging?

  • Fully customizable styling options to match your brand
  • Configurable checkout messages for different scenarios
  • Custom error messaging for state restrictions and compliance issues
  • Flexible positioning options on the checkout page

Reviews

March 1, 2023
Simply put, this is the easiest to use and install plugin around yet is on par or better than the costly $99 monthly competition. All the data is coming from a cloud server via an API therefore you will not clog your metapost and compromise your website speed with local hosted data.
March 1, 2023
Plugin’s programmer answers lightning fast, and keeps improving a product which blows away the competition. Not having to download a huge database of FFL vendors for each site we create is definitely a plus. Highly recommended.
Read all 4 reviews

Contributors & Developers

“g-FFL Checkout” is open source software. The following people have contributed to this plugin.

Contributors

Translate “g-FFL Checkout” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

  1. v2.0.8 Bug Fixes
  2. v2.0.7 Removed excessive logging, and fixed issue with editing shipping address
  3. v2.0.6 Only popup shipping field validation when FFL Selector is loaded, and limit AVS to street/zip/city/state
  4. v2.0.4 Bug Fix, code was too aggressive in hiding wordpress admin notices
  5. v2.0.3 Mixed Cart Support and State Ammunition Compliance and State Restriction features, among many other features
  6. v1.4.26 WordPress Compatibility update
  7. v1.4.25 Minor fixes around when to check for the FFL required flag
  8. v1.4.24 Minor Bug fixes
  9. v1.4.23 Fixed an issue where the company name field label was appearing when it shouldn’t
  10. v1.4.22 Improved Security around setting cookies
  11. v1.4.21 Security updates
  12. v1.4.20 Better compatibility with Fortis Payment Plugin
  13. v1.4.19 HPOS compatibility fix for FFL Section in Order Details page
  14. v1.4.18 Minor fix for issue with FFL indicator code on product list
  15. v1.4.17 Styling changes, you may need to adjust any custom CSS if you applied anything to the column or columns CSS classes
  16. v1.4.16 Added a popup message if no FFL selected
  17. v1.4.15 You can now add a FFL to a manually created order (w/HPOS Support)
  18. v1.4.14 You can now add a FFL to a manually created order
  19. v1.4.13 Added C&R Upload bypass
  20. v1.4.11 HPOS Compatibility
  21. v1.4.10 Minor Updates
  22. v1.4.9 Bug Fixes
  23. v1.4.8 You can now change the selected FFL on an Order
  24. v1.4.7 Tested for WordPress 6.3
  25. v1.4.6 Added an auto-refresh after FFL Upload Success
  26. v1.4.5 Changed how FFL Upload validation process works
  27. v1.4.4 Added Phone Number and FFL Name to FFL Information Panel in Order Details view
  28. v1.4.3 PLugin will save a customers previous selected FFL to streamline subsequent checkouts
  29. v1.4.2 Changed background color of selected FFL to address user feedback
  30. v1.4.1 Addressed conflict with other plugins causing FFL upload/download button to not appear
  31. v1.4.0 Added White-labeling Features for Plugin Name and Logo
  32. v1.3.9 Cosmetic Logo Changes
  33. v1.3.8 Minor fix for situation when user changes FFL during checkout
  34. v1.3.7 Fix display of Tax and Shipping Costs after FFL selection
  35. v1.3.6 Improved load speed of orders page, checking for on-file FFL
  36. v1.3.5 Max Zoom issue resolved on Local Pickup option
  37. v1.3.4 FFL-Download button now hitting API to get real-time status
  38. v1.3.3 Added progress indicator to load panel
  39. v1.3.2 Added local pickup option, which is configurable on the admin page
  40. v1.2.5 Unauthorized message on checkout if plugin is not approved, this previously would be a silent alert
  41. v1.2.4 Preload API when no map is selected to improve performance of FFL search
  42. v1.2.3 Page jumps to first and last name after seleecting FFL when map is disabled and plugin above shipping
  43. v1.2.2 Map is now optional, FFL Information now in custom fields instead of notes, and shipping forms are removed if FFL-required purchase
  44. v1.1.3 Resolved an issue with caching shipping address from FFL purchase to non-FFL purchase
  45. v1.1.2 Mapbox conversion, removing need for Google Maps API key and also adding eFile FFL upload/download/ezCheck features to orders details view
  46. v1.0.1 Bug Fixes
  47. v1.0.0 Initial Release of the g-FFL API & Plugin