Flexible Donations for Stripe

Flexible Donations for Stripe lets you accept donations directly through Stripe Checkout, the PCI-compliant hosted payment page. Donations go straight to your Stripe account - no transaction fees beyond Stripe's own. Key Features

• One-time & recurring donations - donors choose either payment type
• Custom amount input - donors enter any amount they want
• Predefined amount buttons - quick-select popular donation amounts
• Flexible billing intervals - daily, weekly, monthly, quarterly, or yearly
• Sandbox / Test mode - store separate test keys and switch live/test anytime without touching your live keys
• Email confirmations - automatic thank-you emails with dynamic placeholders
• Donation tracking - every session logged in the database
• Webhook support - real-time payment confirmation via Stripe webhooks
• AJAX or REST API submission - choose between admin-ajax.php and the WordPress REST API if your host blocks AJAX for visitors
• Multi-currency - works with any Stripe-supported currency

How it works The plugin renders a shortcode form. When a donor submits it, a Stripe Checkout Session is created and the donor is redirected to Stripe's hosted payment page. Stripe sends a webhook back to your site to confirm the payment, mark the donation completed, and send the thank-you email. This plugin is an interface to the Stripe payment service. By configuring it with your Stripe API keys you consent to sending donation data (donor email and amount) to Stripe for processing. Review Stripe's Terms of Service and Privacy Policy before use. Live vs Test mode

• Live mode - processes real payments with your sk_live_ keys
• Test mode - processes test payments with sk_test_ keys (use test card 4242 4242 4242 4242)

Your live keys are stored separately and are never touched when you switch modes. A warning banner is shown in settings while test mode is active.

1. Upload the flexible-donations-for-stripe folder to /wp-content/plugins/
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Settings → Stripe Integration and enter your Stripe Secret Key, Publishable Key, and Webhook Secret (from Stripe Dashboard → Developers)
4. Add the [fdfs_donation_form] shortcode to any page

Webhook setup

1. In Stripe Dashboard, go to Developers → Webhooks and click Add endpoint
2. Enter your webhook URL: https://yoursite.com/wp-json/fdfs/v1/webhook
3. Subscribe to these events:
4. checkout.session.completed - Confirms one-time donations and starts recurring subscriptions
5. invoice.payment_succeeded - Confirms recurring payment renewals (monthly, yearly, etc.)
6. customer.subscription.deleted - Marks subscription as cancelled when donor cancels
7. Copy the signing secret (whsec_...) and paste it in the plugin settings (Webhook Secret field)
8. If using test mode, create a second webhook endpoint in Stripe's test mode (toggle at top of Dashboard) and paste its secret in the Test Webhook Secret field

Currency Configuration The plugin supports any Stripe-supported currency. Set the Currency field in Settings → Stripe Integration to a 3-letter ISO code (e.g., usd, eur, gbp, inr, cad, aud, jpy). The correct currency symbol will be displayed on the donation form and in confirmation emails automatically. Composer note The Stripe PHP SDK is bundled with the plugin, so no Composer installation is required.

3.3.1

• Added comprehensive webhook configuration instructions in settings page
• Fixed currency symbol display (now shows correct symbol €, £, ₹, etc. based on Currency setting)
• Added currency symbol helper with 90+ ISO currency mappings
• Updated readme with detailed webhook setup and currency configuration sections
• Changed settings menu name from "Stripe Integration" to "Flexible Donations"

3.3.0

• Rebranded as Flexible Donations for Stripe with the flexible-donations-for-stripe slug
• Upgraded Stripe PHP SDK to v21.1.1
• Fixed settings page slug to use the plugin prefix instead of a generic word
• Added automatic migration of legacy settings, donations table, shortcode, and webhook endpoint from the pre-3.3.0 version
• Added cache-proof nonce refresh so donations work on pages served from cache
• Added optional donation note field (configurable in settings) stored in Stripe metadata and the donations table

3.2.0

• Renamed to Custom Donations for Stripe
• Fixed escaping and input sanitization issues flagged by the Plugin Check tool
• Fixed direct database query warnings flagged by the Plugin Check tool

3.1.0

• Added Sandbox / Test mode with separate test keys and a live/test toggle
• Added warning banner when test mode is active
• Added donation page path setting for Stripe redirect URLs
• Added configurable statement descriptor shown on donor bank statements
• General cleanup for WordPress.org compliance

3.0.0

• Added REST API submission method to work around admin-ajax.php 403 errors for non-logged-in users
• Added email template support with dynamic placeholders

2.0.0

• Added email template support with dynamic placeholders

1.0.0

• Initial release
• One-time and recurring donation support
• Custom amount input
• Predefined amount buttons
• Multi-interval recurring options (daily, weekly, monthly, quarterly, yearly)
• Stripe webhook integration
• Email confirmations
• Database donation tracking
• Admin settings page with secure key storage