Accept IFR Lock — Business Onboarding

Standard Operating Procedure for onboarding new builder businesses into the IFR Benefits Network.

Step 1: Initial Contact & Eligibility

Minimum Requirements

• Legal business registration (sole proprietor, LLC, GmbH, etc.)
• Willingness to set IFR lock requirements (minimum 1,000 IFR)
• Smartphone or tablet for QR scanner
• Acceptance of IFR Builder Terms

Exclusion Criteria

The following categories are excluded from the IFR Benefits Network:

• Gambling, tobacco, or weapons businesses
• Businesses without a physical or digital location
• Blocked entities (sanctioned individuals or organizations)

Step 2: Technical Setup

Option A: Hosted Solution (Recommended)

The fastest way to get started. No technical knowledge required.

1. Register your business at the IFR Benefits Network portal
2. Receive your unique Business ID and QR scanner URL
3. Configure your discount tiers (see Step 3 below)
4. Add your business logo and display name
5. Bookmark the scanner URL on your point-of-sale device

Option B: Self-Hosted (For Developers)

For businesses that want full control over the verification flow.

1. Clone the Benefits Network repository:

   git clone https://github.com/NeaBouli/inferno.git
   cd inferno/apps/benefits-network

2. Install dependencies and configure environment:

   cd backend && npm install
   cp .env.example .env
   # Edit .env with your Business ID and API keys

3. Start the backend server:

   npm run dev
   # Server runs on http://localhost:3001

4. Start the frontend:

   cd ../frontend && npm install
   npm run dev
   # Frontend runs on http://localhost:3000

5. Verify the lock check endpoint works:

   curl http://localhost:3001/api/health
   # Expected: { "status": "ok" }

Step 3: Tier Configuration

Configure the discount tiers your customers can access based on their IFR lock amount. These are recommended starting values — you can customize them for your business.

Step 4: Cashier Staff Training (5 Minutes)

The QR Flow

That is the entire flow. The cashier applies the displayed discount and completes the sale as usual.

What Cashier Staff Does NOT Need

• No crypto knowledge required
• No MetaMask or wallet software
• No blockchain understanding
• No handling of tokens or private keys
• No special hardware — any device with a camera works

Step 5: Go-Live Checklist

• Business registration completed and approved
• Discount tiers configured (at least one tier active)
• Scanner URL bookmarked on POS device(s)
• Test scan performed with a known locked wallet
• Cashier staff briefed on the 3-step QR flow
• Business signage or sticker placed at point of sale (optional but recommended)
• Support contact saved for troubleshooting

Step 6: Ongoing Operations

Monthly Checks

• Review discount redemption stats in your business dashboard
• Adjust tier thresholds if needed (e.g., seasonal promotions)
• Ensure POS device software is up to date
• Verify scanner URL is still bookmarked and accessible

Support Channels

• Technical issues: Open an issue on GitHub
• Business inquiries: Contact via X / Twitter (@IFRtoken)
• Integration help: See the Integration Guide for developer documentation

FAQ for Businesses