RKEEPER Admin Guide
Complete guide for platform administration and licensee management
Creating Your Admin Account:
- Register a new account on the platform using your email
- Use Base44 dashboard to change your user role to "admin"
- You now have full access to all admin features and dashboards
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.
Review Application
Navigate to Admin Dashboard → Manage Licensees → Pending tab. Review business details, EIN, banking info, and POS system.
Set Pricing
Click "Set Pricing" to configure: Setup Fee (one-time), Monthly Fee (recurring), Revenue Percentage (default 10%, paid quarterly).
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").
Review POS Integration Request
Go to Admin Dashboard → POS Integrations. Review submitted POS system. Mark as "approved" or note if upgrade required.
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.
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
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
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