Description
Coinsnap Bitcoin Donation is a WordPress plugin for accepting voluntary Bitcoin contributions directly on your website.
Visitors can donate with Bitcoin via Lightning or Bitcoin on-chain. You can use Coinsnap for a simple payment setup or connect your own BTCPay Server.
Donation forms
Create unlimited donation forms and place them anywhere with shortcodes.
The plugin includes three form types:
- Simple Donation — visitors choose their own contribution amount.
- Multi Amount Donation — offer predefined donation amounts.
- Shoutout Donation — supporters donate and publish a paid message after successful payment.
Forms support wide and narrow layouts, multiple forms on the same page, configurable donor fields, donor notices and custom checkboxes.
Payment providers
- Coinsnap — accept Bitcoin and Lightning without running your own payment infrastructure.
- BTCPay Server — connect your own BTCPay Server for a self-hosted payment setup.
Key features
- Bitcoin Lightning and on-chain payments
- Unlimited donation forms
- Simple, Multi Amount and Shoutout form types
- Shortcode-based placement
- Multiple forms per page
- Optional donor information
- Public paid shoutouts
- Fiat and Bitcoin amount calculation
- Transactions and payment history in WordPress
- Automatic webhook registration
- Webhook signature verification
- Light and dark themes
- German translation included
- Non-custodial / self-custody payment model
Requirements
- WordPress 5.2 or newer
- PHP 8.0 or newer
- A Coinsnap account or your own BTCPay Server
Shortcodes
Each current donation form has its own shortcode:
[coinsnap_bitcoin_donation_form id=”123″]
Shoutout lists can be displayed with:
[coinsnap_donation_list id=”123″]
Legacy shortcodes remain supported for backward compatibility.
More information
- Product page: https://coinsnap.io/wp-plugins/wp-bitcoin-donation/
- Live demo: https://donation.coinsnap.org/
- GitHub: https://github.com/Coinsnap/Coinsnap-Bitcoin-Donation
- Coinsnap Wallet: https://coinsnap.io/wallet/
- Coinsnap API: https://docs.coinsnap.io/
- Coinsnap account: https://app.coinsnap.io/register
Coinsnap is Bitcoin payment software for merchants and a brand of Onlineshop24 d.o.o., Serbia.
Installation
Install from WordPress.org
- In WordPress, go to Plugins → Add New.
- Search for Coinsnap Bitcoin Donation.
- Click Install Now and activate the plugin.
- Go to Bitcoin Donations → Settings.
- Select Coinsnap or BTCPay Server and enter the required credentials.
- Create a donation form.
- Copy its shortcode into a page, post, sidebar or other shortcode-compatible area.
- Make a test payment.
Install from GitHub
- Download this repository as a ZIP archive.
- Upload it through Plugins → Add New → Upload Plugin.
- Install and activate the plugin.
- Configure Coinsnap or BTCPay Server.
FAQ
Can visitors pay with both Lightning and Bitcoin on-chain?
Yes. The plugin supports both Lightning and Bitcoin on-chain donations.
Can I use my own BTCPay Server?
Yes. BTCPay Server is supported as an alternative to Coinsnap.
How many donation forms can I create?
You can create unlimited donation forms.
Can I use multiple donation forms on the same page?
Yes. Multiple forms can be used independently on one page.
Can I collect donor information?
Yes. Donor information fields, a donor notice and a custom checkbox can be configured.
Do I need my own Lightning node?
No. When using Coinsnap, you do not need to operate your own Lightning node or Bitcoin payment server.
Screenshots
Changelog
1.0.0 :: 2025-03-15
- Initial release.
1.1.0 :: 2025-04-30
- Updated WordPress backend interface
- Updated plugin menu pages
- Added 2 more forms (Shoutout and Multi Amount)
- Added Donor Information collection option
- Added settings tabs for new forms and Donor Information
- Updated frontend interface
- Added QR popup payment
- Added currency selector
- Updated input fields with separators and currency
- Added conversion rate fetching from coinsnap
- Added cleanup on plugin uninstall
- Compatibility with WordPress 6.8.1 is tested.
1.1.1 :: 2025-05-25
- Fixed bug for shoutouts
- Update: Expanded the shoutouts so that they remember sats amount too and highlight based on that
1.1.2 :: 2025-06-04
- Fixed bug for checkRequiredFieds constant in popup.js file
1.2.0 :: 2025-06-18
- Update: BTCPay setup wizard is added in BTCPay server settings.
1.3.0 :: 2025-12-09
- Update: Added payment gateway client class.
- Update: Added support for all the Coinsnap currencies.
- Update: Minimum order amount is added to connection status notice.
- Update: Plugin name is changed in WordPress backend.
- Added QR-code generator for BTCPay server invoice.
- Compatibility with WordPress 6.9 is tested.
1.3.1 :: 2026-02-04
- Updated interface of donor information form.
- Compatibility with WordPress 6.9.1 is tested.
1.3.2 :: 2026-02-15
- Update: Added order ID and all the standard fields for invoice request.
- Update: Added plugin isolation from other Coinsnap plugins in backend.
- Update: Deleted currency exchange check on frontend.
- Update: Added plugin isolation from other plugins in backend.
1.4.0 :: 2026-03-11
- Update: Fiat/Crypto amount calculation in frontend.
- Update: Minimum and premium donation amounts in Shoutout form.
- Udpate: Name and message values in shoutout list in frontend.
- Compatibility with WordPress 6.9.4 is tested.
1.4.1 :: 2026-03-12
- Fixed: CSS and JS files enqueue conditions.
- Fixed: Class Coinsnap_Bitcoin_Donation_Client() call during payment amount check.
- Update: Donation widget theme application.
1.4.2 :: 2026-03-13
- Update: Shortcode check on CSS and JS files enqueue conditions is temporary removed.
1.5.0 :: 2026-03-20
- Major: Migrated to coinsnap-core shared library for payment providers, settings, and webhooks.
- New: Server-side payment creation via WordPress REST API — API keys no longer exposed in frontend JavaScript.
- New: Iframe checkout modal replaces custom QR code popup for consistent payment experience.
- New: Dual webhook endpoints (Coinsnap and BTCPay) with proper signature verification using WP_REST_Request body.
- New: Legacy webhook endpoint for backward compatibility with existing registrations.
- New: Modern card-based admin settings page with connection badge and BTCPay wizard.
- New: Donation Forms admin page redesigned with tabbed card layout matching core design.
- New: Transactions page for viewing payment history.
- New: Logs page for debugging.
- New: Toast notification on settings save across all admin pages.
- New: Click-to-copy shortcodes in admin with visual feedback.
- New: Theme setting (Light/Dark) in shared core settings — supported on frontend forms.
- New: Ngrok URL field in Advanced settings for local webhook testing.
- New: Automatic webhook registration on admin page load.
- Update: Frontend donation forms completely redesigned — modern styling, Bitcoin orange (#f7931a) accents, system font stack, clean input focus states.
- Update: Amount field uses CSS-positioned currency label instead of embedded text — fixes cursor jumping issue.
- Update: Plugin icon updated to dedicated SVG.
- Update: Settings key migration (provider → payment_provider, btcpay_url → btcpay_host) for core compatibility.
- Update: Webhook signature verification uses $request->get_body() instead of php://input for reliability.
- Update: Webhook secrets managed by core with auto-registration.
- Update: Replaced Coingecko API with Kraken API for fiat conversion.
- Fixed: Inverted nonce check in donor meta save — donor edits now save correctly from admin.
- Fixed: Missing null coalescing on form options — no more PHP warnings on fresh installs.
- Fixed: PHP operator precedence bug in shoutout min/premium amounts.
- Fixed: Hardcoded BTCPay URL replaced with dynamic setting from core.
- Fixed: Webhook signature failure now returns 401 instead of 200.
- Fixed: XSS vector in error message display.
- Fixed: Missing wp_reset_postdata() after WP_Query in shoutouts list.
- Fixed: Exchange rate null check prevents crashes when API is unavailable.
- Fixed: JS null errors on pages with only one form type (guard checks for specific elements).
- Fixed: Amount/currency mismatch when paying in fiat currencies.
- Fixed: Duplicate settings page rendering removed.
- New: Re-register Webhook button in Debug Tools (visible when Log Level is Debug).
- New: Disable Webhook Verification toggle for debugging.
- New: Admin notice when payment gateway credentials are not configured.
- New: Payment endpoint returns clear error when gateway is not configured.
- New: Debug Tools section separated from Advanced settings, only visible in Debug mode.
- New: German translation (de_DE) with POT template for additional languages.
- New: load_plugin_textdomain support for translations.
- Update: Submenu reordered — plugin-specific pages first (Donation Forms, Shoutouts, Donor Info), core pages after (Transactions, Settings, Logs).
- Update: Removed Active/Enabled checkbox from all form types — forms are always active.
- Update: Shoutouts submenu always visible (no longer conditional on active checkbox).
- Fixed: Iframe modal not cleaned up on close — donate button stayed disabled after closing modal.
- Fixed: Exchange rate API failure (CoinGecko rate limiting) no longer blocks payment creation.
1.5.6 :: 2026-03-27
- Fixed: SATS/BTC amounts divided by 100 when creating invoices via BTCPay and Coinsnap providers.
1.5.3 :: 2026-03-25
- Fixed: Shortcode “Copied!” text always visible on list table.
- Fixed: Shortcode copy button not working on list table.
- Fixed: Shortcode column overlapping date column in list table.
- Fixed: Old admin URL (admin.php?page=coinsnap-bitcoin-donation) now redirects correctly.
1.5.2 :: 2026-03-25
- New: Empty state page with “Create Your First Form” button when no forms exist.
- New: Admin notice after default forms are created prompting to review settings.
- New: 3 default forms (Simple, Multi Amount, Shoutout) auto-created on first visit.
- Update: “Snap Donations” renamed to “Choose an amount” (German: “Wähle einen Betrag aus”).
- Fixed: Self-healing migration — recovers from failed migration attempts automatically.
- Fixed: Old admin URL redirect — cached bookmarks to the previous menu page now redirect correctly.
- Fixed: Menu now links directly to CPT list — no redirect needed.
1.5.1 :: 2026-03-24
- Major: Donation Forms now use a Custom Post Type — create unlimited forms instead of the previous 3-tab limit.
- New: Visual form type selector with SVG icon cards (Simple Donation, Multi Amount, Shoutout).
- New: Unified shortcode
[coinsnap_bitcoin_donation_form id="123"]renders any form type based on its settings. - New: Shoutout list shortcode
[coinsnap_donation_list id="123"]scoped per form. - New: Multiple forms of the same type on one page — each with independent settings.
- New: Donor Notice text field — display informational text in the donor popup (e.g. tax deduction info).
- New: Custom Checkbox field — configurable checkbox in the donor popup (e.g. “I need a donation receipt”).
- New: Translatable default values for form fields (Button Text, Title, Message) — pre-filled based on site language.
- New: Placeholder text on all admin form fields showing expected values.
- New: Admin list table with Form Type, Layout, and copyable Shortcode columns.
- New: “Add New Form” submenu item for quick form creation.
- New: Automatic migration from old settings to CPT posts on plugin update — existing forms and shortcodes continue to work.
- Update: Legacy shortcodes (
[coinsnap_bitcoin_donation],[multi_amount_donation],[shoutout_form],[shoutout_list], and wide variants) remain fully functional via migration mapping. - Update: Frontend JavaScript refactored to use per-form
data-*attributes instead of global variables — enables multi-form pages. - Update: Default snap amounts changed to 50 / 100 / 200.
- Update: Default shoutout minimum 500 SATS, premium 10,000 SATS.
- Update: Webhook handler stores donation form ID on shoutout and donor posts for per-form scoping.
- Update: Uninstall cleanup includes CPT posts and migration options.
- Fixed: Wide layout shortcodes force correct layout regardless of stored meta value.
1.5.7 :: 2026-06-02
- Fixed: Payment status now syncs even when the provider webhook cannot reach the site (local dev or lost webhooks) — the status check and a new admin “Check status” action query Coinsnap/BTCPay directly.
- Fixed: Shoutout name entered in the form is now saved — previously every shoutout was recorded as “Anonymous”.
- Fixed: Donor and shoutout records created from a confirmed payment read invoice metadata case-insensitively, so name, message and amounts are no longer blank.
- New: Invoice creation sends the buyer’s email, name and description to Coinsnap/BTCPay (buyerEmail, buyerName, itemDesc) and the donation form id.
- New: Transactions list now shows Source (donation form), Invoice Number and Customer, with a per-row “Check status” action and a Source filter.
1.5.8 :: 2026-06-02
- Fixed: The “Invoice Id” link on the Shoutouts list linked to the wrong Coinsnap URL (/td/) — it now opens the transaction detail page (/transactions/).
1.5.9 :: 2026-06-02
- New: Invoice creation now sends orderId and orderNumber in the metadata (set to the unique transaction reference) so the paying wallet can reconcile the payment.
- Fixed: Shoutout list now matches the Shoutout form width (centered 645px card) with spacing between entries — the list layout previously did not apply to per-form (CPT) shoutout lists.









