Documentation
Everything you need to add FFL selection to your checkout in minutes.
1Create Your Account
Sign up at fflbridge.com/signup to get your API key instantly.
After signing up, you'll see your API key on the onboarding page:
ffl_live_abc123...xyz789
⚠️ Save this key immediately — it's only shown once!
2Add the Widget to Your Page
Copy and paste this code into your checkout page where you want the FFL selector to appear:
<!-- FFL Bridge Widget --> <script src="https://fflbridge.com/widget.js" data-api-key="YOUR_API_KEY" data-theme="dark"> </script> <!-- This div will contain the FFL search form --> <div id="ffl-bridge"></div>
Replace YOUR_API_KEY with your actual API key.
3Capture the Selected FFL
When a customer selects an FFL, the widget fires an event. Listen for it to capture their selection:
<script>
document.addEventListener('ffl-select', function(e) {
const selectedFFL = e.detail;
console.log('Customer selected:', selectedFFL.businessName);
console.log('Address:', selectedFFL.address, selectedFFL.city, selectedFFL.state);
console.log('License:', selectedFFL.licenseNumber);
// Store in a hidden input for form submission
document.getElementById('selected-ffl').value = JSON.stringify(selectedFFL);
});
</script>
<!-- Hidden input to store selection -->
<input type="hidden" id="selected-ffl" name="selectedFFL">4That's It!
Your customers can now search for FFL dealers by ZIP code and select one for their firearm transfer.