Getting Started

Install AgarCo Donate and have donations flowing in under 10 minutes.

Installing AgarCo Donate
3 min 4 steps
Download the plugin
After purchasing, download agarco-donate.zip from your order confirmation email or your account dashboard at agarco.org.
Upload to WordPress
Go to Plugins → Add New → Upload Plugin in your WordPress admin. Choose the zip file and click Install Now.
Requires WordPress 6.0+ and PHP 7.4+
Activate the plugin
Click Activate Plugin. You'll see a new AgarCo Donate menu appear in your admin sidebar with Dashboard, Transactions, Campaigns, and more.
Enter your license key
Go to AgarCo Donate → Settings → License. Paste your license key from the purchase email and click Activate. Your plan and all enabled features are confirmed instantly.
No license key? Start with the 30-day free trial — no key needed.
Creating Your First Campaign
5 min 4 steps
Open Campaigns
Navigate to AgarCo Donate → Campaigns and click + New Campaign.
Fill in the details
Enter the campaign name (e.g., "Medical Fund"), description, and optionally set a fundraising goal amount. Upload a campaign image.
Set donation amounts
Configure preset amounts ($25, $50, $100, $250) or enable custom amounts. Choose whether to allow recurring donations for this campaign.
Publish
Click Save Campaign. Your campaign is live and ready to receive donations. Copy the shortcode or use the Elementor widget to embed it.
Embedding the Donation Form
2 min 3 steps
Copy the shortcode
On your campaign page, copy: [agarco_donate campaign="medical-fund"]
Paste into any page
Edit any WordPress page. Paste the shortcode, or drag the AgarCo Donate Elementor widget onto your page.
Preview and test
The form adapts to each visitor's location — right currency, right gateway, right payment methods. Automatic.
Testing with Sandbox Mode
3 min 4 steps
Enable sandbox
Go to AgarCo Donate → Settings → Gateways. Each gateway has a Sandbox/Test Mode toggle.
Use test credentials
Enter sandbox API keys. Stripe: starts with sk_test_, Paystack: starts with sk_test_.
Make a test donation
Use Stripe test card: 4242 4242 4242 4242, any future date, any CVC. Submit and verify everything works.
Verify the full flow
Check: receipt email sent ✓ journal entry created ✓ dashboard stats updated ✓. Then switch to live mode.
Always test with sandbox first. Never use real credentials until everything works.
Setting Up Paystack
5 min3 steps
1
Get Paystack API Keys
Log in to your Paystack Dashboard → Settings → API Keys. Copy both your Test Secret Key and Live Secret Key.
2
Configure in AgarCo
Go to AgarCo Donate → Settings → Gateways → Paystack. Paste your secret key. Enable test mode while setting up.
3
Set Webhook URL
In Paystack Dashboard → Settings → Webhooks, add: https://yoursite.com/wp-json/agarco/v1/webhook/paystack
Setting Up Stripe
4 min3 steps
1
Get Stripe API Keys
Go to Stripe Dashboard → Developers → API Keys. Copy your Publishable and Secret keys.
2
Configure in AgarCo
Go to AgarCo Donate → Settings → Gateways → Stripe. Paste both keys. Toggle test mode.
3
Set Webhook Endpoint
In Stripe Dashboard → Developers → Webhooks, add endpoint: https://yoursite.com/wp-json/agarco/v1/webhook/stripe. Select events: payment_intent.succeeded, payment_intent.payment_failed.
Setting Up PayPal
4 min3 steps
1
Create PayPal App
Go to PayPal Developer → My Apps → Create App. Get your Client ID and Secret.
2
Configure in AgarCo
Go to AgarCo Donate → Settings → Gateways → PayPal. Enter Client ID and Secret. Toggle Sandbox/Live.
3
Configure Webhook
PayPal webhook URL: https://yoursite.com/wp-json/agarco/v1/webhook/paypal
Understanding the Accounting Ledger
8 min6 steps
1
How Double-Entry Works
Every donation creates two journal entries: a debit to your asset account (cash/gateway) and a credit to your revenue account (donations). This ensures your books always balance.
2
Viewing the Ledger
Go to AgarCo Donate → Accounting → Journal. Each row shows date, account, debit, credit, and the linked donation.
Configuring AI Donor Recovery
5 min4 steps
1
Enable AI Recovery
Go to AgarCo Donate → Settings → AI → Recovery. Toggle on. AI will monitor all failed donations and send personalized follow-up emails.
2
Configure Email Template
Customize the recovery email template. AI auto-fills the reason (card expired, insufficient funds, etc.) and includes a direct retry link.
Setting Up the Email Centre
6 min4 steps
1
Connect SMTP Provider
Go to AgarCo Donate → Email Centre → SMTP. Enter your provider details (Mailgun, SendGrid, Amazon SES, Zoho, or any SMTP server).
2
Configure Templates
Customize receipt, thank-you, and campaign email templates with your branding and messaging.
Setting Up Recurring Donations
5 min3 steps
1
Enable Recurring
Go to AgarCo Donate → Settings → Recurring. Enable and choose default billing cycle (monthly, quarterly, yearly).
2
Add to Donation Form
In your campaign settings, toggle "Allow recurring". Donors see a frequency selector on the form.
Hooks, Filters & REST API
10 min5 sections
1
Available Hooks
agarco_donation_completed — fires after successful donation. agarco_donation_failed — fires on failure with error details.
2
REST API Endpoints
GET /wp-json/agarco/v1/donations — list donations. GET /wp-json/agarco/v1/donors — list donors. Authentication via application passwords.