Complete Setup & Documentation

Everything you need to deploy and configure Connect2Give, OMI Chat, and all integrated services

Quick Navigation

OMI Chat Setup Platform Setup Mobile Apps Text-to-Give Card Reader / Terminal VOIP Service Device Insurance All Features API Configuration Troubleshooting Storage Management

OMI Chat - AI Assistant

What is OMI Chat?

OMI is an AI-powered chatbot assistant built into Connect2Give that helps users navigate the platform, answer questions about features, and provide real-time support. It uses OpenAI's GPT models to deliver intelligent, context-aware responses.

Key Features:

24/7 automated support for donors and organizations
Answers questions about donations, campaigns, and subscriptions
Guides users through platform features
Provides troubleshooting assistance
Streaming responses for real-time interaction

Setup Instructions

Get OpenAI API Key
- Go to platform.openai.com
- Sign up or log in to your account
- Navigate to API Keys section
- Create a new API key and copy it
Add to Environment Variables
OPENAI_API_KEY=sk-your-api-key-here
Deploy to Vercel
- Add the environment variable in Vercel dashboard
- Redeploy your application
- OMI Chat will appear in the bottom-right corner

Technical Details

API Endpoint:

/api/chat/omi

Model:

OpenAI GPT-4o-mini (configurable)

Features:

Streaming responses for real-time interaction
Context-aware conversations with message history
Custom system prompt trained on Connect2Give features
Error handling and retry logic
Mobile-responsive chat interface

Customization:

Edit the system prompt in app/api/chat/omi/route.ts to customize OMI's personality and knowledge base.

Connect2Give Platform Setup

Prerequisites

Node.js 18+ installed
Firebase account (free tier works)
Stripe account for payments
Vercel account for deployment
Domain name (optional but recommended)

Step 1: Firebase Setup

Create Firebase Project
- Go to console.firebase.google.com
- Click "Add project" and follow the wizard
- Enable Google Analytics (optional)
Enable Authentication
- Go to Authentication → Sign-in method
- Enable Email/Password authentication
- Configure email templates for verification
Create Firestore Database
- Go to Firestore Database → Create database
- Start in production mode
- Choose a location close to your users
Get Configuration
- Go to Project Settings → General
- Scroll to "Your apps" and add a web app
- Copy the Firebase config object
Generate Service Account
- Go to Project Settings → Service accounts
- Click "Generate new private key"
- Save the JSON file securely

Step 2: Stripe Setup

Create Stripe Account
- Go to dashboard.stripe.com
- Complete business verification
- Enable Stripe Connect for marketplace functionality
Get API Keys
- Go to Developers → API keys
- Copy Publishable key and Secret key
- Use test keys for development
Configure Webhooks
- Go to Developers → Webhooks
- Add endpoint: https://yourdomain.com/api/stripe/webhook
- Select events: checkout.session.completed, payment_intent.succeeded
- Copy webhook signing secret

Step 3: Environment Variables

Add these to your Vercel project or .env.local file:

# Firebase Client (Public)

NEXT_PUBLIC_FIREBASE_API_KEY=your-api-key

NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com

NEXT_PUBLIC_FIREBASE_PROJECT_ID=your-project-id

NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your-project.appspot.com

NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your-sender-id

NEXT_PUBLIC_FIREBASE_APP_ID=your-app-id

# Firebase Admin (Server-side)

FIREBASE_PROJECT_ID=your-project-id

FIREBASE_CLIENT_EMAIL=firebase-adminsdk@your-project.iam.gserviceaccount.com

FIREBASE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"

# Stripe

STRIPE_SECRET_KEY=sk_test_...

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...

STRIPE_WEBHOOK_SECRET=whsec_...

# OpenAI (for OMI Chat)

OPENAI_API_KEY=sk-...

# Optional Services

RESEND_API_KEY=re_... (for emails)

VONAGE_API_KEY=... (for SMS)

VONAGE_API_SECRET=...

CHANGENOW_API_KEY=... (for crypto)

Mobile App Deployment (iOS & Android)

Overview

Connect2Give uses Capacitor to wrap the Next.js web app into native iOS and Android applications. This approach allows you to maintain a single codebase while deploying to multiple platforms.

Setup Instructions

Install Dependencies
npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android
Initialize Capacitor
npx cap init
Build Next.js App
npm run build
Add Platforms
npx cap add ios
npx cap add android
Configure Firebase for Mobile
- iOS: Add GoogleService-Info.plist to ios/App/App/
- Android: Add google-services.json to android/app/
Open in Native IDEs
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio

Requirements

iOS Development:

Mac computer with macOS
Xcode 14+ installed
Apple Developer Account ($99/year)
iOS device or simulator for testing

Android Development:

Any OS (Windows, Mac, Linux)
Android Studio installed
Google Play Developer Account ($25 one-time)
Android device or emulator for testing

PWA Alternative

Connect2Give is also a Progressive Web App (PWA), which means users can install it directly from their browser without going through app stores. This is perfect for quick deployment and testing.

Works on all modern browsers (Chrome, Safari, Edge, Firefox)
No app store approval required
Instant updates without user action
Offline support with service workers
Add to home screen functionality

Text-to-Give (SMS Donations)

What is Text-to-Give?

Text-to-Give allows donors to initiate donations by sending a simple text message. The system responds with a secure payment link, making it incredibly easy to give on the go.

Example Flow:

Donor texts "GIVE 50" to your organization's number
System responds with a secure payment link
Donor clicks link and completes payment
Instant confirmation via SMS and email

Setup with Vonage

Create Vonage Account
- Go to dashboard.nexmo.com
- Complete account verification
- Add payment method
Purchase Phone Number
- Go to Numbers → Buy numbers
- Choose country and features (SMS required)
- Select a memorable number
Configure Webhook
- Go to Settings → API settings
- Set Inbound Messages webhook: https://yourdomain.com/api/vonage/webhook
- Set HTTP method to POST
Add Environment Variables
VONAGE_API_KEY=your-api-key
VONAGE_API_SECRET=your-api-secret
VONAGE_PHONE_NUMBER=+1234567890
NEXT_PUBLIC_VONAGE_PHONE_NUMBER=+1234567890

Features

Parse donation amounts from text messages
Support for multiple organizations via text codes
Automatic payment link generation
SMS confirmations and receipts
Donor account auto-creation
Admin dashboard for SMS donation tracking

Card Reader / Terminal (In-Person Donations)

What is Stripe Terminal?

Stripe Terminal allows organizations to accept in-person card payments using physical card readers. Perfect for events, Sunday services, fundraising dinners, or any in-person gathering where you need to accept donations on the spot.

Supported Payment Methods:

Card swipe (magnetic stripe)
Chip insert (EMV)
Contactless tap (NFC)
Apple Pay & Google Pay
Samsung Pay

Setup Instructions

Connect Stripe Account
- Organizations must first connect their Stripe Connect account from the dashboard
- Go to Dashboard → Payment Settings → Connect Stripe
- Complete Stripe Connect onboarding
Purchase Card Reader Hardware
- BBPOS WisePad 3 (~$59) - Bluetooth mobile reader
- Stripe Reader M2 (~$299) - WiFi countertop reader
- BBPOS Chipper 2X BT (~$59) - Budget Bluetooth option
- Order from Stripe Terminal Store
Create Location in Stripe
- Go to Stripe Dashboard → Terminal → Locations
- Click "Add location"
- Enter your organization's physical address
- Save location ID for configuration
Register Card Reader
- Go to Stripe Dashboard → Terminal → Readers
- Click "Add reader"
- Follow pairing instructions for your reader model
- Assign reader to your location
Access Terminal in Connect2Give
- Log in to your organization dashboard
- Click "Card Reader / Terminal" in the payment settings section
- Enter donation amount and optional purpose
- Click "Process Card Payment"
- Have donor swipe, insert, or tap their card
- Wait for confirmation

Features

Real-time payment processing with instant confirmation
Automatic receipt generation and donor account creation
Integrated with dashboard analytics and reporting
Support for multiple card readers per organization
Offline payment queueing (reader-dependent)
Staff access from organization dashboard only
PCI-compliant and fully encrypted transactions

Pricing

Platform Fee:

2% platform fee (same as online donations)
Organizations receive 98% of terminal donations

Stripe Processing Fees:

In-person transactions: 2.7% + $0.05 per transaction
Lower than online rates (2.9% + $0.30)

Hardware Cost:

One-time hardware purchase ($59-$299)
No monthly fees or subscriptions

Use Cases

Sunday Services: Accept tithes and offerings with card readers at exits or usher stations
Fundraising Events: Process donations at galas, dinners, or charity auctions
Community Festivals: Set up donation booths at outdoor events
Office Donations: Accept walk-in donations at your organization's office
Mobile Outreach: Bring portable readers to off-site events and missions

Technical Details

API Endpoints:

/api/stripe/terminal/create-payment-intent

Creates payment intent for terminal transaction

/api/stripe/terminal/create-location

Creates Stripe Terminal location

/api/stripe/terminal/list-readers

Lists available card readers

Security:

End-to-end encryption from reader to Stripe
PCI DSS Level 1 compliant
No card data stored on Connect2Give servers
Automatic fraud detection and prevention

VOIP Business Phone Service

Overview

Connect2Give partners with Phone.com to offer VOIP business phone services. Organizations earn 10% of monthly subscription fees when supporters sign up through their LinkHub.

Plans & Pricing

Basic Plan - $19.99/month

1 phone number
Unlimited calling & texting
Voicemail to email
Mobile & desktop apps

Professional Plan - $29.99/month

Everything in Basic
Call recording
Auto attendant
Call analytics

How Organizations Benefit

Earn 10% of monthly subscription fees automatically
Recurring revenue stream
No additional work required
Track orders in dashboard
Supporters get valuable business phone service

Device Insurance (AKKO)

Overview

Connect2Give partners with AKKO to offer comprehensive device protection for phones, tablets, and laptops. Organizations earn 10% of monthly premiums when supporters purchase insurance through their LinkHub.

Coverage & Pricing

Smartphone Protection - $14.95/month

Cracked screen repair
Water damage protection
Theft coverage
$50 deductible

Tablet Protection - $19.95/month

All smartphone coverage
Accidental damage
Hardware malfunction
$75 deductible

Laptop Protection - $29.95/month

Complete device protection
Liquid damage coverage
Power surge protection
$100 deductible

How It Works

Supporter visits organization's LinkHub
Selects device insurance option
Chooses device type and coverage level
Completes signup and payment
Organization receives 10% of monthly premium automatically

Complete Feature List

Donation Features

One-time donations
Recurring monthly donations
Custom donation amounts
Anonymous giving option
Cover processing fees option
Cryptocurrency donations
Text-to-Give (SMS donations)
QR code donations
Donor portal with history
Automatic tax receipts

Campaign Features

Unlimited fundraising campaigns
Goal tracking with progress bars
Campaign updates and stories
Social media sharing
Donor wall and leaderboards
Campaign categories
End date scheduling
Draft and publish workflow
Campaign analytics
Export donor data

Dashboard & Analytics

Real-time donation tracking
Donor management
Revenue analytics
Growth projections
Monthly recurring revenue (MRR)
Donor retention metrics
Campaign performance
Subscription tracking
Export reports
Custom date ranges

Marketing & Outreach

Customizable LinkHub pages
QR code generation
Social media integration
Email notifications
SMS notifications
AI-powered content generation
Story generation for campaigns
Marketing playbook
Grant search tool
SEO optimization

Subscription Services

Mobile phone plans (Omnipoint)
VOIP business phones (Phone.com)
Device insurance (AKKO)
10% recurring revenue share
Order tracking
Automatic payouts
Customer support integration
Service activation
Billing management
Cancellation handling

AI & Automation

OMI AI chatbot assistant
Automated donor account creation
Welcome email automation
SMS donation processing
AI content generation
Story writing assistance
Social media post generation
Grant opportunity matching
Automated receipts
Smart notifications

API Configuration Reference

Required Environment Variables

Variable	Purpose	Required
NEXT_PUBLIC_FIREBASE_API_KEY	Firebase client authentication	✅ Yes
FIREBASE_PRIVATE_KEY	Firebase Admin SDK	✅ Yes
STRIPE_SECRET_KEY	Stripe payment processing	✅ Yes
STRIPE_WEBHOOK_SECRET	Stripe webhook verification	✅ Yes
OPENAI_API_KEY	OMI Chat AI assistant	⚠️ Recommended
RESEND_API_KEY	Email notifications	⚠️ Recommended
VONAGE_API_KEY	SMS Text-to-Give	Optional
CHANGENOW_API_KEY	Cryptocurrency donations	Optional

API Endpoints

/api/stripe/webhook

Handles Stripe payment events

/api/vonage/webhook

Processes incoming SMS donations

/api/chat/omi

OMI AI chatbot endpoint

/api/admin/sync-sms-donations

Syncs SMS donations with Stripe payments

/api/stripe/terminal/create-payment-intent

Creates payment intent for terminal transaction

/api/stripe/terminal/create-location

Creates Stripe Terminal location

/api/stripe/terminal/list-readers

Lists available card readers

Troubleshooting

Common Issues

OMI Chat not responding

Verify OPENAI_API_KEY is set correctly
Check OpenAI account has available credits
Review browser console for error messages
Ensure API endpoint /api/chat/omi is accessible

SMS donations not working

Verify Vonage webhook URL is configured correctly
Check VONAGE_API_KEY and VONAGE_API_SECRET
Ensure phone number is SMS-enabled
Test with admin SMS simulator first

Donations not showing in dashboard

Verify Stripe webhook is configured and receiving events
Check Firebase Firestore rules allow writes
Review server logs for webhook errors
Use admin search tool to find donations

Mobile app not connecting to API

Verify capacitor.config.json has correct server URL
Check CORS settings allow mobile app origin
Ensure SSL certificate is valid
Test API endpoints in browser first

Card reader not connecting or processing payments

Ensure reader is paired and assigned to correct location in Stripe Dashboard
Verify Stripe Connect account is fully onboarded
Check internet connection on reader and device running Connect2Give
Ensure donation amount and purpose are correctly entered
Review Stripe logs for transaction errors
Test reader with Stripe's official app if available

Getting Help

Email: support@connect2give.app
Use OMI Chat for quick questions
Check browser console for error messages
Review server logs in Vercel dashboard
Test in incognito mode to rule out cache issues

Storage & Data Management

Storage System Overview

Connect2Give uses Vercel Blob for file storage and Firestore for database records. The platform tracks storage usage across campaigns, events, LinkHub, and donor data to help organizations manage their resources effectively.

Storage Tiers

Free Tier

1GB media storage (images, videos, documents)
5,000 donor records
Perfect for small churches and new nonprofits
No credit card required

Pro Tier - $15/month

25GB media storage
25,000 donor records
85% profit margin for platform
Ideal for growing organizations

Large Group Tier - $40/month

100GB media storage
100,000 donor records
Best for established churches and large nonprofits
Advanced analytics included

Enterprise Tier - $100/month

500GB media storage
Unlimited donor records
Multi-site organizations and denominational networks
White-label options available

API Endpoints

/api/storage/calculate-usage

Calculates current storage and donor usage for an organization

/api/storage/get-usage

Retrieves cached storage usage data

/api/storage/upgrade-tier

Upgrades organization to higher storage tier via Stripe

Technical Implementation

Storage Tracking:

Vercel Blob API used to list and calculate file sizes
Firestore queries count donor records by organization
Usage data cached in organization document
Real-time updates when files are uploaded/deleted

Billing Integration:

Stripe subscriptions for tier upgrades
Automatic payment collection
Prorated billing for mid-cycle upgrades
Webhook handling for subscription changes

Cost Structure:

Vercel Blob: $0.15/GB storage + $0.40/GB bandwidth
Firestore: ~$0.18/GB for database storage
60-85% profit margins on storage tiers
Scalable as platform grows

Usage Dashboard Component

The storage dashboard component displays real-time usage with visual progress bars, detailed breakdowns, and upgrade prompts when limits are approached.

User Documentation Privacy Policy Terms of Service Back to Home

Complete Setup & Documentation

Everything you need to deploy and configure Connect2Give, OMI Chat, and all integrated services

Quick Navigation

OMI Chat Setup Platform Setup Mobile Apps Text-to-Give Card Reader / Terminal VOIP Service Device Insurance All Features API Configuration Troubleshooting Storage Management

OMI Chat - AI Assistant

What is OMI Chat?

Key Features:

24/7 automated support for donors and organizations
Answers questions about donations, campaigns, and subscriptions
Guides users through platform features
Provides troubleshooting assistance
Streaming responses for real-time interaction

Setup Instructions

Get OpenAI API Key
- Go to platform.openai.com
- Sign up or log in to your account
- Navigate to API Keys section
- Create a new API key and copy it
Add to Environment Variables
OPENAI_API_KEY=sk-your-api-key-here
Deploy to Vercel
- Add the environment variable in Vercel dashboard
- Redeploy your application
- OMI Chat will appear in the bottom-right corner

Technical Details

API Endpoint:

/api/chat/omi

Model:

OpenAI GPT-4o-mini (configurable)

Features:

Streaming responses for real-time interaction
Context-aware conversations with message history
Custom system prompt trained on Connect2Give features
Error handling and retry logic
Mobile-responsive chat interface

Customization:

Edit the system prompt in app/api/chat/omi/route.ts to customize OMI's personality and knowledge base.

Connect2Give Platform Setup

Prerequisites

Node.js 18+ installed
Firebase account (free tier works)
Stripe account for payments
Vercel account for deployment
Domain name (optional but recommended)

Step 1: Firebase Setup

Create Firebase Project
- Go to console.firebase.google.com
- Click "Add project" and follow the wizard
- Enable Google Analytics (optional)
Enable Authentication
- Go to Authentication → Sign-in method
- Enable Email/Password authentication
- Configure email templates for verification
Create Firestore Database
- Go to Firestore Database → Create database
- Start in production mode
- Choose a location close to your users
Get Configuration
- Go to Project Settings → General
- Scroll to "Your apps" and add a web app
- Copy the Firebase config object
Generate Service Account
- Go to Project Settings → Service accounts
- Click "Generate new private key"
- Save the JSON file securely

Step 2: Stripe Setup

Create Stripe Account
- Go to dashboard.stripe.com
- Complete business verification
- Enable Stripe Connect for marketplace functionality
Get API Keys
- Go to Developers → API keys
- Copy Publishable key and Secret key
- Use test keys for development
Configure Webhooks
- Go to Developers → Webhooks
- Add endpoint: https://yourdomain.com/api/stripe/webhook
- Select events: checkout.session.completed, payment_intent.succeeded
- Copy webhook signing secret

Step 3: Environment Variables

Add these to your Vercel project or .env.local file:

# Firebase Client (Public)

NEXT_PUBLIC_FIREBASE_API_KEY=your-api-key

NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com

NEXT_PUBLIC_FIREBASE_PROJECT_ID=your-project-id

NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your-project.appspot.com

NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your-sender-id

NEXT_PUBLIC_FIREBASE_APP_ID=your-app-id

# Firebase Admin (Server-side)

FIREBASE_PROJECT_ID=your-project-id

FIREBASE_CLIENT_EMAIL=firebase-adminsdk@your-project.iam.gserviceaccount.com

FIREBASE_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"

# Stripe

STRIPE_SECRET_KEY=sk_test_...

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...

STRIPE_WEBHOOK_SECRET=whsec_...

# OpenAI (for OMI Chat)

OPENAI_API_KEY=sk-...

# Optional Services

RESEND_API_KEY=re_... (for emails)

VONAGE_API_KEY=... (for SMS)

VONAGE_API_SECRET=...

CHANGENOW_API_KEY=... (for crypto)

Mobile App Deployment (iOS & Android)

Overview

Connect2Give uses Capacitor to wrap the Next.js web app into native iOS and Android applications. This approach allows you to maintain a single codebase while deploying to multiple platforms.

Setup Instructions

Install Dependencies
npm install @capacitor/core @capacitor/cli @capacitor/ios @capacitor/android
Initialize Capacitor
npx cap init
Build Next.js App
npm run build
Add Platforms
npx cap add ios
npx cap add android
Configure Firebase for Mobile
- iOS: Add GoogleService-Info.plist to ios/App/App/
- Android: Add google-services.json to android/app/
Open in Native IDEs
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio

Requirements

iOS Development:

Mac computer with macOS
Xcode 14+ installed
Apple Developer Account ($99/year)
iOS device or simulator for testing

Android Development:

Any OS (Windows, Mac, Linux)
Android Studio installed
Google Play Developer Account ($25 one-time)
Android device or emulator for testing

PWA Alternative

Connect2Give is also a Progressive Web App (PWA), which means users can install it directly from their browser without going through app stores. This is perfect for quick deployment and testing.

Works on all modern browsers (Chrome, Safari, Edge, Firefox)
No app store approval required
Instant updates without user action
Offline support with service workers
Add to home screen functionality

Text-to-Give (SMS Donations)

What is Text-to-Give?

Text-to-Give allows donors to initiate donations by sending a simple text message. The system responds with a secure payment link, making it incredibly easy to give on the go.

Example Flow:

Donor texts "GIVE 50" to your organization's number
System responds with a secure payment link
Donor clicks link and completes payment
Instant confirmation via SMS and email

Setup with Vonage

Create Vonage Account
- Go to dashboard.nexmo.com
- Complete account verification
- Add payment method
Purchase Phone Number
- Go to Numbers → Buy numbers
- Choose country and features (SMS required)
- Select a memorable number
Configure Webhook
- Go to Settings → API settings
- Set Inbound Messages webhook: https://yourdomain.com/api/vonage/webhook
- Set HTTP method to POST
Add Environment Variables
VONAGE_API_KEY=your-api-key
VONAGE_API_SECRET=your-api-secret
VONAGE_PHONE_NUMBER=+1234567890
NEXT_PUBLIC_VONAGE_PHONE_NUMBER=+1234567890

Features

Parse donation amounts from text messages
Support for multiple organizations via text codes
Automatic payment link generation
SMS confirmations and receipts
Donor account auto-creation
Admin dashboard for SMS donation tracking

Card Reader / Terminal (In-Person Donations)

What is Stripe Terminal?

Supported Payment Methods:

Card swipe (magnetic stripe)
Chip insert (EMV)
Contactless tap (NFC)
Apple Pay & Google Pay
Samsung Pay

Setup Instructions

Connect Stripe Account
- Organizations must first connect their Stripe Connect account from the dashboard
- Go to Dashboard → Payment Settings → Connect Stripe
- Complete Stripe Connect onboarding
Purchase Card Reader Hardware
- BBPOS WisePad 3 (~$59) - Bluetooth mobile reader
- Stripe Reader M2 (~$299) - WiFi countertop reader
- BBPOS Chipper 2X BT (~$59) - Budget Bluetooth option
- Order from Stripe Terminal Store
Create Location in Stripe
- Go to Stripe Dashboard → Terminal → Locations
- Click "Add location"
- Enter your organization's physical address
- Save location ID for configuration
Register Card Reader
- Go to Stripe Dashboard → Terminal → Readers
- Click "Add reader"
- Follow pairing instructions for your reader model
- Assign reader to your location
Access Terminal in Connect2Give
- Log in to your organization dashboard
- Click "Card Reader / Terminal" in the payment settings section
- Enter donation amount and optional purpose
- Click "Process Card Payment"
- Have donor swipe, insert, or tap their card
- Wait for confirmation

Features

Real-time payment processing with instant confirmation
Automatic receipt generation and donor account creation
Integrated with dashboard analytics and reporting
Support for multiple card readers per organization
Offline payment queueing (reader-dependent)
Staff access from organization dashboard only
PCI-compliant and fully encrypted transactions

Pricing

Platform Fee:

2% platform fee (same as online donations)
Organizations receive 98% of terminal donations

Stripe Processing Fees:

In-person transactions: 2.7% + $0.05 per transaction
Lower than online rates (2.9% + $0.30)

Hardware Cost:

One-time hardware purchase ($59-$299)
No monthly fees or subscriptions

Use Cases

Sunday Services: Accept tithes and offerings with card readers at exits or usher stations
Fundraising Events: Process donations at galas, dinners, or charity auctions
Community Festivals: Set up donation booths at outdoor events
Office Donations: Accept walk-in donations at your organization's office
Mobile Outreach: Bring portable readers to off-site events and missions

Technical Details

API Endpoints:

/api/stripe/terminal/create-payment-intent

Creates payment intent for terminal transaction

/api/stripe/terminal/create-location

Creates Stripe Terminal location

/api/stripe/terminal/list-readers

Lists available card readers

Security:

End-to-end encryption from reader to Stripe
PCI DSS Level 1 compliant
No card data stored on Connect2Give servers
Automatic fraud detection and prevention

VOIP Business Phone Service

Overview

Connect2Give partners with Phone.com to offer VOIP business phone services. Organizations earn 10% of monthly subscription fees when supporters sign up through their LinkHub.

Plans & Pricing

Basic Plan - $19.99/month

1 phone number
Unlimited calling & texting
Voicemail to email
Mobile & desktop apps

Professional Plan - $29.99/month

Everything in Basic
Call recording
Auto attendant
Call analytics

How Organizations Benefit

Earn 10% of monthly subscription fees automatically
Recurring revenue stream
No additional work required
Track orders in dashboard
Supporters get valuable business phone service

Device Insurance (AKKO)

Overview

Coverage & Pricing

Smartphone Protection - $14.95/month

Cracked screen repair
Water damage protection
Theft coverage
$50 deductible

Tablet Protection - $19.95/month

All smartphone coverage
Accidental damage
Hardware malfunction
$75 deductible

Laptop Protection - $29.95/month

Complete device protection
Liquid damage coverage
Power surge protection
$100 deductible

How It Works

Supporter visits organization's LinkHub
Selects device insurance option
Chooses device type and coverage level
Completes signup and payment
Organization receives 10% of monthly premium automatically

Complete Feature List

Donation Features

One-time donations
Recurring monthly donations
Custom donation amounts
Anonymous giving option
Cover processing fees option
Cryptocurrency donations
Text-to-Give (SMS donations)
QR code donations
Donor portal with history
Automatic tax receipts

Campaign Features

Unlimited fundraising campaigns
Goal tracking with progress bars
Campaign updates and stories
Social media sharing
Donor wall and leaderboards
Campaign categories
End date scheduling
Draft and publish workflow
Campaign analytics
Export donor data

Dashboard & Analytics

Real-time donation tracking
Donor management
Revenue analytics
Growth projections
Monthly recurring revenue (MRR)
Donor retention metrics
Campaign performance
Subscription tracking
Export reports
Custom date ranges

Marketing & Outreach

Customizable LinkHub pages
QR code generation
Social media integration
Email notifications
SMS notifications
AI-powered content generation
Story generation for campaigns
Marketing playbook
Grant search tool
SEO optimization

Subscription Services

Mobile phone plans (Omnipoint)
VOIP business phones (Phone.com)
Device insurance (AKKO)
10% recurring revenue share
Order tracking
Automatic payouts
Customer support integration
Service activation
Billing management
Cancellation handling

AI & Automation

OMI AI chatbot assistant
Automated donor account creation
Welcome email automation
SMS donation processing
AI content generation
Story writing assistance
Social media post generation
Grant opportunity matching
Automated receipts
Smart notifications

API Configuration Reference

Required Environment Variables

Variable	Purpose	Required
NEXT_PUBLIC_FIREBASE_API_KEY	Firebase client authentication	✅ Yes
FIREBASE_PRIVATE_KEY	Firebase Admin SDK	✅ Yes
STRIPE_SECRET_KEY	Stripe payment processing	✅ Yes
STRIPE_WEBHOOK_SECRET	Stripe webhook verification	✅ Yes
OPENAI_API_KEY	OMI Chat AI assistant	⚠️ Recommended
RESEND_API_KEY	Email notifications	⚠️ Recommended
VONAGE_API_KEY	SMS Text-to-Give	Optional
CHANGENOW_API_KEY	Cryptocurrency donations	Optional

API Endpoints

/api/stripe/webhook

Handles Stripe payment events

/api/vonage/webhook

Processes incoming SMS donations

/api/chat/omi

OMI AI chatbot endpoint

/api/admin/sync-sms-donations

Syncs SMS donations with Stripe payments

/api/stripe/terminal/create-payment-intent

Creates payment intent for terminal transaction

/api/stripe/terminal/create-location

Creates Stripe Terminal location

/api/stripe/terminal/list-readers

Lists available card readers

Troubleshooting

Common Issues

OMI Chat not responding

Verify OPENAI_API_KEY is set correctly
Check OpenAI account has available credits
Review browser console for error messages
Ensure API endpoint /api/chat/omi is accessible

SMS donations not working

Verify Vonage webhook URL is configured correctly
Check VONAGE_API_KEY and VONAGE_API_SECRET
Ensure phone number is SMS-enabled
Test with admin SMS simulator first

Donations not showing in dashboard

Verify Stripe webhook is configured and receiving events
Check Firebase Firestore rules allow writes
Review server logs for webhook errors
Use admin search tool to find donations

Mobile app not connecting to API

Verify capacitor.config.json has correct server URL
Check CORS settings allow mobile app origin
Ensure SSL certificate is valid
Test API endpoints in browser first

Card reader not connecting or processing payments

Ensure reader is paired and assigned to correct location in Stripe Dashboard
Verify Stripe Connect account is fully onboarded
Check internet connection on reader and device running Connect2Give
Ensure donation amount and purpose are correctly entered
Review Stripe logs for transaction errors
Test reader with Stripe's official app if available

Getting Help

Email: support@connect2give.app
Use OMI Chat for quick questions
Check browser console for error messages
Review server logs in Vercel dashboard
Test in incognito mode to rule out cache issues

Storage & Data Management

Storage System Overview

Storage Tiers

Free Tier

1GB media storage (images, videos, documents)
5,000 donor records
Perfect for small churches and new nonprofits
No credit card required

Pro Tier - $15/month

25GB media storage
25,000 donor records
85% profit margin for platform
Ideal for growing organizations

Large Group Tier - $40/month

100GB media storage
100,000 donor records
Best for established churches and large nonprofits
Advanced analytics included

Enterprise Tier - $100/month

500GB media storage
Unlimited donor records
Multi-site organizations and denominational networks
White-label options available

API Endpoints

/api/storage/calculate-usage

Calculates current storage and donor usage for an organization

/api/storage/get-usage

Retrieves cached storage usage data

/api/storage/upgrade-tier

Upgrades organization to higher storage tier via Stripe

Technical Implementation

Storage Tracking:

Vercel Blob API used to list and calculate file sizes
Firestore queries count donor records by organization
Usage data cached in organization document
Real-time updates when files are uploaded/deleted

Billing Integration:

Stripe subscriptions for tier upgrades
Automatic payment collection
Prorated billing for mid-cycle upgrades
Webhook handling for subscription changes

Cost Structure:

Vercel Blob: $0.15/GB storage + $0.40/GB bandwidth
Firestore: ~$0.18/GB for database storage
60-85% profit margins on storage tiers
Scalable as platform grows

Usage Dashboard Component

The storage dashboard component displays real-time usage with visual progress bars, detailed breakdowns, and upgrade prompts when limits are approached.

User Documentation Privacy Policy Terms of Service Back to Home

OMI Assistant

Hi! I'm OMI, your Connect2Give assistant. How can I help you today?

Try asking: