Donorbox Plugin

Integrate Donorbox donation campaigns into your nSelf-powered app. Receive webhooks, sync donors and donations to your local database, and trigger app-level actions when goals are met.

Overview

• Webhook Receiver — receives donation.created, donation.updated, campaign.goal_reached events
• Donor Sync — stores donor records in np_donorbox_donors
• Campaign Tracking — goal progress queryable via GraphQL
• Notification Hooks — fire nSelf notifications on new donations or goal milestones

Installation

nself plugin install donorbox

nself plugin status donorbox

Configuration

# Donorbox API credentials
DONORBOX_API_KEY=your_api_key
DONORBOX_CAMPAIGN_ID=your_campaign_id

# Webhook secret (set in Donorbox dashboard)
DONORBOX_WEBHOOK_SECRET=your_webhook_secret

Webhook Setup

In your Donorbox dashboard, add a webhook pointing to:

https://your-domain.com/plugins/donorbox/webhook