Skip to content

IoT Device Setup

🤖 Explain with AI

This guide covers the setup and management of IoT integrations for 4Geeks Perks, enabling real-time tracking and automated perk redemption through connected devices.

Premium Feature

IoT integrations are available exclusively on the Premium plan.

Overview

4Geeks Perks supports various IoT devices to create a seamless, touchless perk redemption experience:

  • Vending Machines: Track snack and beverage consumption in real-time
  • Coffee Stations: Monitor coffee usage and automate restocking alerts
  • Self-Serve Markets: 24/7 unattended retail with automated checkout
  • RFID Readers: Enable card-based authentication and payment at all IoT touchpoints
  • Smart Lockers: Secure package delivery and perk pickup

Supported Devices

Vending Machines

4Geeks Perks integrates with smart vending machines that support:

  • RFID card readers
  • Cashless payment systems
  • Inventory tracking
  • Remote monitoring
  • Real-time sales data

Compatible Brands: - Crane Merchandising Systems - Automatic Products International (API) - Seaga Manufacturing - TCN Vending - Custom solutions (via API)

Coffee Stations

Smart coffee and beverage systems with:

  • RFID authentication
  • Usage tracking
  • Consumption analytics
  • Automatic supply monitoring
  • Quality metrics

Compatible Systems: - Jura professional machines - Franke coffee systems - Necta vending coffee - Custom IoT-enabled machines

Self-Serve Markets

Unattended retail spaces featuring:

  • RFID-gated entry
  • Smart shelves with weight sensors
  • Computer vision for product recognition
  • Automated checkout
  • Real-time inventory management

Supported Solutions: - Amazon Just Walk Out technology partners - Standard RFID-gated micro-markets - Custom smart retail setups

RFID Readers

Standalone RFID readers for perk redemption:

  • HID Global readers
  • AWID readers
  • Multi-technology readers (RFID + NFC)
  • USB desktop readers for admin use

Prerequisites

Before setting up IoT integrations:

  1. Premium Plan: Ensure your account has Premium access
  2. Network Infrastructure:
  3. Stable internet connection at device locations
  4. Wi-Fi or Ethernet connectivity
  5. Adequate bandwidth for real-time data transmission
  6. Power Supply: Reliable electrical connection for all devices
  7. Physical Space: Appropriate location with adequate security
  8. IT Approval: Coordinate with your IT department for network access

Setting Up Vending Machine Integration

Step 1: Device Preparation

  1. Ensure the vending machine has:
  2. IoT controller module installed
  3. Network connectivity configured
  4. RFID reader attached (if not built-in)

  5. Firmware updated to latest version

  6. Test basic functionality:

  7. Product dispensing
  8. Payment processing
  9. Network communication
  10. RFID card reading

Step 2: Register Device in 4Geeks Perks

  1. Log in to the 4Geeks Console
  2. Navigate to Perks > IoT Devices > Add Device
  3. Select device type: Vending Machine
  4. Fill in device details:
  5. Device name: Descriptive name (e.g., “Building A - Floor 2 Vending”)
  6. Location: Physical location
  7. Serial number: Manufacturer’s serial
  8. MAC address: Network identifier
  9. IP address: Current IP (if static)
  10. Choose integration method:
  11. Direct API: For smart vending machines with native API
  12. Middleware: For machines requiring protocol translation
  13. Manual sync: For basic machines with limited connectivity
  14. Click Register

Step 3: Configure Integration

  1. After registration, click Configure on the device
  2. Set up API connection:
  3. API endpoint: Vending machine’s API URL
  4. Authentication: API key or OAuth credentials
  5. Polling interval: How often to sync data (recommended: 5 minutes)
  6. Map products:
  7. Import product catalog from vending machine
  8. Assign perk categories (snacks, beverages, healthy options)
  9. Set pricing and subsidy rules
  10. Configure redemption rules:
  11. Payment method: Wallet points, RFID card, or hybrid
  12. Daily limits: Maximum transactions per employee
  13. Eligible employees: Who can use this machine
  14. Test the connection:
  15. Click Test Connection
  16. Verify data flows correctly
  17. Perform a test transaction
  18. Click Save and Activate

Step 4: Employee Setup

  1. Notify employees about the new vending machine perk
  2. Ensure all employees have:
  3. Active 4Geeks Perks account
  4. Activated RFID card
  5. Sufficient wallet balance
  6. Provide usage instructions:
  7. Approach the vending machine
  8. Tap RFID card on reader
  9. Select product
  10. Confirm redemption
  11. Collect product

Setting Up Coffee Station Integration

Step 1: Machine Preparation

  1. Ensure coffee machine has:
  2. IoT module installed
  3. Network connectivity
  4. RFID reader (built-in or external)

  5. Water and supply lines connected

  6. Configure machine settings:

  7. Available drink types
  8. Cup sizes
  9. Temperature preferences
  10. Maintenance schedule

Step 2: Register Coffee Station

  1. Go to Perks > IoT Devices > Add Device
  2. Select device type: Coffee Station
  3. Fill in details:
  4. Device name: (e.g., “Main Break Room Coffee”)
  5. Location: Specific room or area
  6. Machine model: Manufacturer and model
  7. Serial number: For warranty tracking
  8. Choose integration method:
  9. Direct API: For smart machines
  10. IoT gateway: For machines with basic connectivity
  11. Click Register

Step 3: Configure Coffee Perk

  1. Click Configure on the registered device
  2. Set up drink catalog:
  3. Espresso, americano, cappuccino, etc.
  4. Tea and hot chocolate options
  5. Cold beverages (if applicable)
  6. Define pricing:
  7. Free for all employees
  8. Subsidized (e.g., company pays 80%)
  9. Wallet points deduction
  10. Daily limits (e.g., 3 drinks per day)
  11. Configure usage tracking:
  12. Track consumption by employee
  13. Monitor peak usage times
  14. Set restock alerts
  15. Enable notifications:
  16. Low supply warnings
  17. Maintenance reminders
  18. Usage threshold alerts
  19. Test the setup:
  20. Perform test redemption
  21. Verify tracking works
  22. Check notification delivery
  23. Click Save and Activate

Setting Up Self-Serve Market

Step 1: Market Infrastructure

Self-serve markets require more extensive setup:

  1. Physical Setup:
  2. Secure room or enclosed area
  3. RFID-gated entry system
  4. Smart shelves or computer vision cameras

  5. Checkout station (optional for fully automated)

  6. Technology Stack:

  7. Access control system
  8. Inventory tracking system
  9. Payment processing integration
  10. Security cameras

Step 2: Register Market

  1. Go to Perks > IoT Devices > Add Device
  2. Select device type: Self-Serve Market
  3. Fill in details:
  4. Market name: (e.g., “Building B Micro-Market”)
  5. Location: Full address and room
  6. Operating hours: 24/7 or specific times
  7. Capacity: Maximum concurrent users
  8. Configure access control:
  9. Link to RFID gate system
  10. Set entry authentication method
  11. Define emergency override procedures
  12. Click Register

Step 3: Configure Product Catalog

  1. Click Configure on the market
  2. Import product inventory:
  3. Upload CSV with product list
  4. Scan barcodes for automatic import
  5. Manual entry for small catalogs
  6. Categorize products:
  7. Snacks
  8. Beverages
  9. Meals
  10. Personal care
  11. Office supplies
  12. Set pricing and subsidies:
  13. Full price
  14. Discounted rate
  15. Wallet points only
  16. Mix of payment methods
  17. Configure inventory tracking:
  18. Set reorder thresholds
  19. Define supplier information
  20. Enable automatic reorder alerts
  21. Test the system:
  22. Enter with RFID card
  23. Select products
  24. Complete checkout
  25. Verify inventory update
  26. Check wallet deduction
  27. Click Save and Activate

RFID Reader Setup

Standalone RFID Readers

For locations without full IoT devices:

  1. Purchase compatible RFID reader
  2. Connect to network:
  3. USB to local computer
  4. Ethernet to network
  5. Wi-Fi configuration
  6. Register in 4Geeks Perks:
  7. Go to Perks > IoT Devices > Add Device
  8. Select RFID Reader
  9. Enter device details
  10. Configure endpoint
  11. Test card reading:
  12. Tap employee RFID card
  13. Verify employee identification
  14. Confirm wallet access
  15. Deploy at location

RFID Reader Configuration

  1. Set reader mode:
  2. Authentication only: Verify identity
  3. Payment enabled: Process wallet deductions
  4. Time tracking: Log entry/exit times
  5. Configure security:
  6. Encryption settings
  7. Anti-tampering alerts
  8. Offline mode behavior
  9. Set up notifications:
  10. Connection status
  11. Error alerts
  12. Usage reports

Monitoring IoT Devices

Device Dashboard

  1. Go to Perks > IoT Devices > Dashboard
  2. View all connected devices:
  3. Online/offline status
  4. Last communication time
  5. Transaction count (today/month)
  6. Error status
  7. Filter by:
  8. Device type
  9. Location
  10. Status
  11. Building

Device Details

Click on any device to see: - Real-time status - Transaction history - Inventory levels (if applicable) - Maintenance schedule - Error logs - Performance metrics

Alerts and Notifications

Configure alerts for: - Device offline: Immediate notification - Low inventory: Threshold-based warnings - High usage: Unusual activity detection - Maintenance due: Scheduled reminders - Error detected: System malfunction alerts

Set up at Perks > IoT Devices > Alerts

Troubleshooting

Device Offline

  1. Check physical connections:
  2. Power supply
  3. Network cable
  4. Router/switch status
  5. Verify network connectivity:
  6. Ping the device IP
  7. Check firewall rules
  8. Confirm DNS resolution
  9. Restart device:
  10. Power cycle
  11. Wait 2 minutes
  12. Check if it comes back online
  13. If still offline:
  14. Check device logs
  15. Contact device manufacturer
  16. Reach out to 4Geeks support

Transaction Failures

  1. Verify employee eligibility:
  2. Active account status
  3. Sufficient wallet balance
  4. Perk enabled for employee
  5. Check device status:
  6. Online and responsive
  7. No error states
  8. Recent successful transactions
  9. Review transaction logs:
  10. Go to Perks > Transactions
  11. Filter by device and time
  12. Identify error codes
  13. Common solutions:
  14. Retry transaction
  15. Re-sync device data
  16. Update device firmware

Inventory Discrepancies

  1. Perform physical count
  2. Compare with system inventory
  3. Identify discrepancies
  4. Adjust inventory in system:
  5. Go to device details
  6. Click Adjust Inventory
  7. Enter correct quantities
  8. Add adjustment note
  9. Investigate root cause:
  10. Theft or loss
  11. Sensor malfunction
  12. Sync errors

Security Best Practices

Network Security

  • Use dedicated VLAN for IoT devices
  • Implement firewall rules restricting device communication
  • Enable WPA3 encryption for Wi-Fi devices
  • Regularly update device firmware
  • Monitor network traffic for anomalies

Data Security

  • All data transmitted via TLS 1.3
  • Employee data encrypted at rest
  • Regular security audits
  • Compliance with GDPR and local privacy laws
  • Automatic session timeouts

Physical Security

  • Install devices in monitored areas
  • Use tamper-evident seals
  • Implement access controls for maintenance
  • Regular physical inspections
  • Document all maintenance activities

API Integration

For custom IoT solutions, 4Geeks Perks provides REST APIs:

Authentication

POST /api/v1/auth/token
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

Register Device

POST /api/v1/iot/devices
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_type": "vending_machine",
  "name": "Building A Vending",
  "location": "Floor 2, Break Room",
  "serial_number": "VM-12345",
  "integration_method": "api",
  "api_endpoint": "https://vending-api.example.com"
}

Report Transaction

POST /api/v1/iot/transactions
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_id": "device_uuid",
  "employee_id": "employee_uuid",
  "product_id": "product_uuid",
  "amount": 150,
  "currency": "points",
  "timestamp": "2026-04-24T10:30:00Z"
}

See full API documentation

Maintenance

Regular Maintenance Tasks

Daily: - Review device status dashboard - Check for error alerts - Monitor transaction success rates

Weekly: - Review inventory levels - Check usage analytics - Verify data synchronization

Monthly: - Physical device inspection - Firmware update check - Security audit review - Performance optimization

Quarterly: - Comprehensive system audit - Network security review - Device calibration (if needed) - Vendor performance review

Firmware Updates

  1. Check for updates at Perks > IoT Devices > Updates
  2. Review release notes
  3. Schedule update during low-usage hours
  4. Backup device configuration
  5. Apply update
  6. Test functionality
  7. Monitor for 24 hours

Support

  • Documentation: 4Geeks Perks guides
  • Technical Support: iot-support@4geeks.io
  • Device Compatibility: Check compatibility list or contact sales
  • Custom Integration: Professional services available for custom solutions

Next Steps

Still questions? Ask the community or explore tutorials