FFL Connect for WooCommerce

Selling firearms online means every order has to ship to a Federal Firearms Licensee (FFL), not to the customer. FFL Connect adds that step to your WooCommerce checkout.

When a cart contains a product that needs an FFL transfer, the customer searches by ZIP code, sees nearby licensed dealers in a list and on a map, and picks one. The chosen dealer becomes the order’s shipping address and the dealer’s FFL number is saved on the order, so you do not have to chase customers for dealer details after they pay.

What it does

• Adds an FFL dealer picker (ZIP code search, results list and interactive map) to the checkout.
• Appears only when the cart contains a product that needs an FFL transfer.
• Lets you mark products one by one (“Requires FFL transfer”) or by whole product category.
• Sets the order’s shipping address to the chosen dealer.
• Shows the dealer’s FFL number on the order screen and in order emails.
• Re-checks the chosen dealer on your server before the order is accepted. If the check cannot be completed, the order is not placed.
• Works with WooCommerce High-Performance Order Storage.

What you need

• WooCommerce, using the classic checkout (the [woocommerce_checkout] shortcode). The dealer picker does not appear on the block-based checkout.
• An FFL Connect API key. The plugin is free; the dealer database it searches is a paid service.

How to get an API key

1. Go to fflconnect.net/pricing and buy an annual licence for your store. You can pay by credit card or Google Pay.
2. Your API key and the plugin download link are emailed to you as soon as the payment goes through. The key is also shown on your order page.
3. Paste the key into WooCommerce > FFL Connect on your site and press Test connection.

Questions about your key or licence: fflconnect.net/contact.

About the dealer data

Dealer records come from the list of active licensees published by the U.S. Bureau of Alcohol, Tobacco, Firearms and Explosives (ATF) and are refreshed monthly. Dealers known not to accept transfers are left out of results.

This plugin helps you collect a dealer for each firearm order. It does not give legal advice, and it does not replace your own compliance procedures, including obtaining a copy of the receiving dealer’s licence where the law requires it.

External services

This plugin relies on two external services.

FFL Connect API (api.fflconnect.net)

Used to find dealers and to confirm the dealer a customer selected. It is provided by Fuzzy Holdings LLC, the author of this plugin.

• When a customer searches for dealers at checkout, your server sends the ZIP code and search radius they entered, together with your store’s API key.
• When an order with an FFL item is placed, your server sends the selected dealer’s FFL licence number, together with your store’s API key, to confirm the dealer.
• When you press “Test connection” on the settings page, your server sends one test search with your API key.

No customer names, addresses, emails or order contents are sent. Requests are made by your server, so your customers’ browsers do not contact this service.

Terms of Service | Privacy Policy

OpenStreetMap map tiles (tile.openstreetmap.org)

Used to draw the map in the dealer picker. When the picker is shown, the customer’s browser requests map images directly from OpenStreetMap’s servers, which means OpenStreetMap receives the customer’s IP address and the map area being viewed. The service is provided by the OpenStreetMap Foundation.

Tile usage policy | Privacy Policy

The Leaflet map library itself is bundled with the plugin and is not loaded from another site.