LEGAL NOTICE: All materials, source code, methodologies, and documentation herein are exclusively owned by Richard Dale Keeper Jr as an individual. Protected under U.S. Copyright Law (17 U.S.C.), Defend Trade Secrets Act (18 U.S.C. § 1836), and USPTO provisional patent applications. Any unauthorized reproduction, reverse engineering, or competitive use is subject to immediate injunctive relief and damages up to $50M + full business valuation. This NDA-protected disclosure is for qualified acquisition evaluation only.

RKEEPER Admin Guide

Complete guide for platform administration and licensee management

Getting Your Admin Account

Creating Your Admin Account:

  1. Register a new account on the platform using your email
  2. Use Base44 dashboard to change your user role to "admin"
  3. You now have full access to all admin features and dashboards
Licensee Registration

Self-Registration Process

Establishments register through the /onboarding page, providing business info, EIN, banking details, and POS selection. Applications automatically enter "pending_approval" status for your review.

Licensee Approval Workflow
1

Review Application

Navigate to Admin Dashboard → Manage Licensees → Pending tab. Review business details, EIN, banking info, and POS system.

2

Set Pricing

Click "Set Pricing" to configure: Setup Fee (one-time), Monthly Fee (recurring), Revenue Percentage (default 10%, paid quarterly).

3

Approve or Reject

Click "Approve" to activate license (sets status to "active" and records your approval). Click "Reject" to deny application (sets status to "suspended").

4

Review POS Integration Request

Go to Admin Dashboard → POS Integrations. Review submitted POS system. Mark as "approved" or note if upgrade required.

Setting Up POS Integration

After approving a licensee, configure their POS integration:

Step 1: Generate API Credentials

Navigate to establishment's detail view → Click "Create API App" → Provide app name (e.g., "Main Location POS") → System generates API Key and Webhook Secret.

Step 2: Configure Webhook

Provide establishment with:

  • Webhook URL: https://app.base44.com/api/functions/posWebhook
  • Authentication: X-Webhook-Secret header with generated secret
  • POS System Header: X-POS-System: square|toast|clover|generic

Step 3: Test Integration

Send test transaction through POS system → Verify transaction appears in Transactions dashboard → Check audit logs for webhook receipt → Confirm revenue tracking is accurate.

Recording Payments

Track licensee payments through the admin dashboard:

Setup Fee

One-time payment recorded when establishment first activates

Monthly Fee

Recurring monthly license fee - record each month via "Record Payment" button

Quarterly Revenue Share

10% of tracked revenue - automatically calculated from quarterly_revenue field

Monitoring & Compliance

Key admin responsibilities for platform compliance:

  • Audit Logs: Review transaction logs regularly for compliance violations or suspicious activity
  • Revenue Tracking: Monitor quarterly revenue accumulation for accurate revenue share calculations
  • License Renewals: Track license_end_date and contact establishments for renewal before expiration
  • POS Integration Health: Check pos_integration_status regularly and address "failed" integrations
  • Payment Collection: Send payment reminders for overdue monthly fees, suspend licenses if necessary
Quick Reference

Admin Pages

  • • Admin Dashboard: Overview and quick actions
  • • Manage Licensees: Approve/reject applications
  • • POS Integrations: Review integration requests
  • • Audit Logs: View all system events

Key Actions

  • • Generate API credentials: API Apps page
  • • Record payment: Active licensees table
  • • Suspend license: Update status to "suspended"
  • • Download compliance PDF: Establishments page