Charity Portal

The Charity Portal enables charitable organizations to manage partnerships, create volunteer opportunities, verify hours, and track donations.

Dashboard Overview

The Charity dashboard (/charity) displays:

Pending Verifications: Volunteer hours awaiting approval
Partner Activity: Recent activity from corporate partners
Opportunity Metrics: Signup rates and completion stats
Donation Summary: YTD received donations

Key Features

Opportunity Creation

Create and manage volunteer opportunities with skills matching

Hour Verification

Review and approve volunteer hours with evidence

Partner Management

Invite and manage corporate partner relationships

Donation Tracking

Track received donations with Gift Aid support

Volunteer Verification

Verification Queue

Navigate to /charity/verification to review pending hours:

View Queue

See all pending verification requests from partner organizations

Review Details

Click to view GPS data, photos, timestamps, and outcome descriptions

Approve or Reject

Approve valid hours or reject with feedback

Bulk Process

Select up to 50 items for batch approval/rejection

Verification Details

Each verification request shows:

Field	Description
Volunteer Name	Who logged the hours
Opportunity	Which activity
Hours Claimed	Time logged
Check-in Method	QR, GPS, or manual
Evidence	Photos, notes, GPS coordinates
Outcomes	What was achieved

Verification Tiers After Approval

Original Tier	After Charity Approval
Any tier	Upgraded to 100% (System Verified)

Opportunity Management

Creating Opportunities

POST /api/charity/opportunities
{
  "title": "Beach Cleanup",
  "description": "Help us clean the local beach",
  "skillsNeeded": ["outdoor", "physical"],
  "location": {
    "address": "Brighton Beach",
    "lat": 50.8225,
    "lng": -0.1372
  },
  "startTime": "2025-04-15T09:00:00Z",
  "duration": 3,
  "spotsAvailable": 20
}

Auto-Matching

When you create an opportunity, RippleCore automatically:

Matches all partner organization members
Calculates skill compatibility scores
Sends notifications for 80%+ matches
Updates the opportunity’s match list

Partner Management

Inviting Partners

POST /api/charity/partners/invite
{
  "email": "hr@company.com",
  "organizationName": "Example Corp",
  "message": "We'd love to partner with you!"
}

Partner Status

Status	Description
Pending	Invitation sent, awaiting response
Active	Partnership confirmed
Inactive	Partnership paused
Declined	Invitation rejected

Donation Management

Tracking Donations

View all donations received from partner organizations:

Filter by date range, partner, or amount
Export CSV for accounting
Track Gift Aid eligibility

Verification

POST /api/charity/donations/{id}/verify
{
  "verified": true,
  "notes": "Receipt confirmed"
}

Messaging

Communicate with partner organizations:

// Send message
POST /api/charity/messages
{
  "partnerId": "partner_123",
  "subject": "Upcoming Event",
  "body": "We have a new opportunity..."
}

// Mark as read
PUT /api/charity/messages/{id}
{
  "read": true
}

Custom Branding

Configure your portal appearance:

POST /api/charity/branding/save
{
  "logo": "https://...",
  "primaryColor": "#2563eb",
  "secondaryColor": "#7c3aed"
}

API Endpoints

Endpoint	Method	Description
`/api/charity/donations`	GET, POST	List/create donations
`/api/charity/donations/{id}/verify`	POST	Verify donation
`/api/charity/donations/export`	GET	Export CSV
`/api/charity/partners`	GET	List partners
`/api/charity/partners/{id}`	GET, PATCH	Manage partner
`/api/charity/partners/invite`	POST	Invite partner
`/api/charity/opportunities`	GET, POST	List/create opportunities
`/api/charity/opportunities/{id}`	GET, PATCH, DELETE	Manage opportunity
`/api/charity/messages`	GET, POST	List/send messages
`/api/charity/branding/save`	POST	Save branding

All endpoints require authentication and CSRF protection for mutations.

Get Started

Core Modules

Portals

Charity Portal

Charity Portal

Dashboard Overview

Key Features

Opportunity Creation

Hour Verification

Partner Management

Donation Tracking

Volunteer Verification

Verification Queue

Verification Details

Verification Tiers After Approval

Opportunity Management

Creating Opportunities

Auto-Matching

Partner Management

Inviting Partners

Partner Status

Donation Management

Tracking Donations

Verification

Messaging

Custom Branding

API Endpoints

​Charity Portal

​Dashboard Overview

​Key Features

Opportunity Creation

Hour Verification

Partner Management

Donation Tracking

​Volunteer Verification

​Verification Queue

​Verification Details

​Verification Tiers After Approval

​Opportunity Management

​Creating Opportunities

​Auto-Matching

​Partner Management

​Inviting Partners

​Partner Status

​Donation Management

​Tracking Donations

​Verification

​Messaging

​Custom Branding

​API Endpoints

Charity Portal

Dashboard Overview

Key Features

Volunteer Verification

Verification Queue

Verification Details

Verification Tiers After Approval

Opportunity Management

Creating Opportunities

Auto-Matching

Partner Management

Inviting Partners

Partner Status

Donation Management

Tracking Donations

Verification

Messaging

Custom Branding

API Endpoints