Bigcommerce FFL Order Processing Guide

July 20, 2026

Summary

How to connect Master FFL (FFL360) on BigCommerce to Flxpoint via webhook so firearm orders automatically route to the FFL dealer while accessories ship normally.

OVERVIEW

If you sell firearms through BigCommerce and use the Master FFL (FFL360) app to collect FFL dealer information at checkout, this connects Master FFL to Flxpoint. FFL details are pushed to Flxpoint by webhook and attached to the order on import, so firearm items route to the FFL dealer while accessories ship normally, without manual sorting.

SETUP

Step	What to do
1. Channel ID	In Connections → Sales Channels, open your BigCommerce channel and note the numeric Channel ID.
2. Webhook URL	In Master FFL, set the webhook to https://api.flxpoint.com/public/webhook/masterffl/{channelId}/ingest as an HTTP POST.
3. Enable import	In the channel's Get Orders Advanced Configuration, enable Import FFL details from BigCommerce via Master FFL and enter your MasterFFL API Key.

HOW THE FLOW WORKS

Checkout in BigCommerce — the shopper selects an FFL dealer in the Master FFL app.
Webhook ingest — Master FFL sends an HTTP POST to the ingest endpoint; it must complete within 20 seconds and returns HTTP 204 on success.
Payload staged — Flxpoint stores the FFL payload keyed by order and channel, even before the order imports.
Order imports — Get Orders imports the order and checks staging for a matching FFL payload.
FFL applied — the FFL details are attached to the order and the staged record is removed.

IMPORTANT NOTES

Note: The webhook URL and method must be exact, sent as HTTP POST with the numeric Sales Channel ID. Success returns HTTP 204; any other status is treated as a failure by Master FFL.

Note: Firearm items receive the FFL dealer shipping address derived from the FFL details, while accessory items keep the standard checkout address. No manual sorting is required.

Note: Even when MasterFFL data arrives, an order can still be flagged Additional Info Required depending on your FFL validation settings. Turning off automatic validation does not remove the need for validation; it just shifts it to a manual step.

COMMON ISSUES

Master FFL reports a 404 when testing the webhook

Re-check that the URL matches the format exactly, that the channel ID is the correct numeric Flxpoint Sales Channel ID, and that the webhook is configured as HTTP POST.

An FFL field (for example the image URL) is not importing on firearm orders

If FFL data mostly imports but a specific field is missing across all firearm orders, confirm Master FFL is populating that field on its side and that the integration is enabled in the BigCommerce channel settings. Provide an example order to support so the payload can be checked.

Firearm orders are not processing and FFL has to be added manually

When firearm orders repeatedly arrive without complete FFL details, they are flagged for manual review. Verify that the FFL was selected from the app's dealer network at checkout and that the webhook is delivering successfully; incomplete data (for example a missing expiration) forces the manual step.

FAQS

Do I need Master FFL?

Only if you sell firearms through BigCommerce and collect FFL dealer information at checkout. It is what makes FFL details appear automatically on the imported order instead of being chased down.

Why is a firearm order still flagged for manual review when FFL data came through?

Depending on your validation settings, the fulfillment request can be marked Additional Info Required so a person confirms the FFL, even when the data was received successfully.

Can I add or correct FFL details after the order is placed?

Yes. You can edit the FFL data in Flxpoint, and the system re-checks compliance before finalizing the shipment.

Back to Order Management