GunBroker Integration – Support Guide

Disclaimer: This guide is for illustrative purposes only and should not be used as a substitute for professional advice. Procedures and examples may vary based on your store's settings and applicable state/local regulations.

Overview

The GunBroker integration with Orchid POS allows you to list inventory directly from the POS, sync order statuses automatically, and manage fulfilled orders — all from one place. This guide walks through initial setup, listing items, and completing orders.

Part 1: Initial Setup

Step 1: Enable the Integration

Contact Orchid Support to activate your GunBroker integration. If you have existing active GunBroker listings you'd like imported, include an export of those listings in the same support ticket.

Note: It is recommended to close all open auction orders before enabling the integration.

Step 2: Enter Your GunBroker Credentials

Once support has enabled the integration, go to:

Manage > Store Configuration > Integrations > eCommerce

Enter your GunBroker username and password in the GunBroker Integration fields.

Step 3: Configure Webhooks in GunBroker

1. In Orchid POS, click the information icon (i) next to "For Order Sync" to retrieve the three webhooks required for setup.
2. In GunBroker, navigate to your Toolbox and select View under Manage Webhooks.
3. In the "Base URL to call your Webhooks" field, enter the first webhook: https://webhook.orchidpos.com. Re-enter your GunBroker credentials as prompted.
4. Configure the remaining webhooks for Items Sold and Items Unsold using the exact webhooks provided in the POS integration page (these include your unique store number).

Your integration is now active and ready to use.

Part 2: Receiving Inventory Before Listing

Before listing a firearm on GunBroker, make sure it has been received into Orchid POS with quantity and serial numbers on hand.

To receive an item:

1. Create an External Order / Receive from your vendor.
2. Select the item and enter the quantity being received.
3. Enter serial numbers as prompted.
4. Click Save and complete the receive. Once finished, your quantity will be available in POS and serial numbers will be automatically recorded in your bound book — no additional action required.

Part 3: Setting Up a Listing

Step 1: Navigate to the Product

Go to Inventory > Manage Products > Inventory, then search for and select the item you want to list.

Step 2: Open the Sales Channel Tab

Select the Sales Channel tab on the product detail page. The upper section contains your Orchid eCommerce settings. Below that, under Marketplace Applications, toggle on GunBroker.com.

Step 3: Complete Listing Details

Step 4: Save

Click Update to save your listing settings. This information is stored and does not need to be re-entered each time — it will remain on the product for all future listings.

Tip: This step sets up the foundation of the listing. You are not yet posting it live to GunBroker.

Part 4: Posting a Live Listing on GunBroker

Step 1: Open the GunBroker Listings Tab

On the product detail page, select the GunBroker.com Listings tab (visible once the GunBroker toggle is enabled).

Step 2: Add a Listing

Click the green Add Listing button. A window will appear with the following listing types:

• Standard Auction – time-based bidding listing
• Fixed Price – set price, no bidding

Select the appropriate type, complete any additional required fields (including your Shipping Profile, which comes from GunBroker), and click Add to post the listing live.

Step 3: Monitor Listings

The GunBroker.com Listings tab shows all your listings and their live statuses. When an item sells in the POS, its corresponding GunBroker listing is automatically closed. Inventory is also reserved for listings marked as closed to maintain accuracy across platforms.

Part 5: Completing a GunBroker Order

When a buyer completes a purchase on GunBroker, the order will appear in Orchid POS at:

Sell > Invoices and Online Orders

Orders will have the status "Order Received". Open the invoice and fulfill the order by assigning the available quantity or specific serial number. Once fulfilled, the item is considered delivered and the firearm is automatically disposed of in your bound book.

Part 6: GunBroker Orders & Layaways (Unpaid Orders)

Unpaid GunBroker orders are handled through a layaway workflow. Here's how it works:

How an Unpaid Order Becomes a Layaway

When Orchid receives a webhook from GunBroker flagging an order as unpaid, the system automatically saves that order as a layaway rather than a completed invoice.

Converting a Layaway to an Invoice

There are two ways a layaway can be converted to a full invoice:

Option 1 – Automatic (every 30 minutes) A background process runs every 30 minutes to check whether each GunBroker layaway order has been paid. If payment is confirmed on GunBroker's end, the layaway is automatically converted to an invoice. If not yet paid, it remains as a layaway until the next check.

Option 2 – Manual Conversion via the Review Layaway Screen A staff member can manually convert a layaway from the Review Layaway screen. There are two scenarios here:

• Order is already paid on GunBroker: A "Convert to Invoice" button will be available. Click it to convert the layaway directly.
• Order is not yet paid and you are collecting payment in-store (e.g., cash or check): A popup will appear to record payment details. If the payment method is check, fields will be provided to capture check information. Once you click Receive Payment, the system will:
  1. Trigger an API call to mark the corresponding GunBroker order as paid.
  2. Convert the layaway to a completed invoice.

Quick Reference