Title: Coinsnap Bitcoin Donation
Author: Coinsnap
Published: <strong>March 15, 2025</strong>
Last modified: October 20, 2026

---

Search plugins

![](https://ps.w.org/coinsnap-bitcoin-donation/assets/banner-772x250.png?rev=3256487)

![](https://ps.w.org/coinsnap-bitcoin-donation/assets/icon.svg?rev=3256522)

# Coinsnap Bitcoin Donation

 By [Coinsnap](https://profiles.wordpress.org/coinsnap/)

[Download](https://downloads.wordpress.org/plugin/coinsnap-bitcoin-donation.1.5.9.zip)

 * [Details](https://en-ca.wordpress.org/plugins/coinsnap-bitcoin-donation/#description)
 * [Reviews](https://en-ca.wordpress.org/plugins/coinsnap-bitcoin-donation/#reviews)
 *  [Installation](https://en-ca.wordpress.org/plugins/coinsnap-bitcoin-donation/#installation)
 * [Development](https://en-ca.wordpress.org/plugins/coinsnap-bitcoin-donation/#developers)

 [Support](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/)

## 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.

## Screenshots

[⌊Coinsnap Bitcoin Donation plugin installation⌉⌊Coinsnap Bitcoin Donation plugin
installation⌉[

Coinsnap Bitcoin Donation plugin installation

[⌊Coinsnap payment settings⌉⌊Coinsnap payment settings⌉[

Coinsnap payment settings

[⌊BTCPay Server payment settings⌉⌊BTCPay Server payment settings⌉[

BTCPay Server payment settings

[⌊Donation form⌉⌊Donation form⌉[

Donation form

[⌊Donation and transaction list⌉⌊Donation and transaction list⌉[

Donation and transaction list

[⌊Bitcoin and Lightning payment⌉⌊Bitcoin and Lightning payment⌉[

Bitcoin and Lightning payment

[⌊Donation form configuration⌉⌊Donation form configuration⌉[

Donation form configuration

[⌊Shoutout form⌉⌊Shoutout form⌉[

Shoutout form

[⌊Shoutout list⌉⌊Shoutout list⌉[

Shoutout list

## Installation

#### Install from WordPress.org

 1. In WordPress, go to **Plugins  Add New**.
 2. Search for **Coinsnap Bitcoin Donation**.
 3. Click **Install Now** and activate the plugin.
 4. Go to **Bitcoin Donations  Settings**.
 5. Select Coinsnap or BTCPay Server and enter the required credentials.
 6. Create a donation form.
 7. Copy its shortcode into a page, post, sidebar or other shortcode-compatible area.
 8. Make a test payment.

#### Install from GitHub

 1. Download this repository as a ZIP archive.
 2. Upload it through **Plugins  Add New  Upload Plugin**.
 3. Install and activate the plugin.
 4. 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.

## Reviews

![](https://secure.gravatar.com/avatar/1cca9259eed6eaed8b6f265b8ab0e0abed60fea6b044ca4f930b92610a0a984a?
s=60&d=retro&r=g)

### 󠀁[Perfect use](https://wordpress.org/support/topic/perfect-use/)󠁿

 [ul71m0](https://profiles.wordpress.org/ul71m0/) November 28, 2025

It is great module.

 [ Read all 1 review ](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/)

## Contributors & Developers

“Coinsnap Bitcoin Donation” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Coinsnap ](https://profiles.wordpress.org/coinsnap/)

[Translate “Coinsnap Bitcoin Donation” into your language.](https://translate.wordpress.org/projects/wp-plugins/coinsnap-bitcoin-donation)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/coinsnap-bitcoin-donation/),
check out the [SVN repository](https://plugins.svn.wordpress.org/coinsnap-bitcoin-donation/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/coinsnap-bitcoin-donation/)
by [RSS](https://plugins.trac.wordpress.org/log/coinsnap-bitcoin-donation/?limit=100&mode=stop_on_copy&format=rss).

## 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.

## Meta

 *  Version **1.5.9**
 *  Last updated: **2 weeks ago**
 *  Active installations: **10+**
 *  WordPress Version: ** 5.2 or higher **
 *  Tested up to: **6.9.11**
 *  PHP Version: ** 8.0 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/coinsnap-bitcoin-donation/)
 * Tags:
 * [bitcoin](https://en-ca.wordpress.org/plugins/tags/bitcoin/)[bitcoin donations](https://en-ca.wordpress.org/plugins/tags/bitcoin-donations/)
   [donation](https://en-ca.wordpress.org/plugins/tags/donation/)[Lightning](https://en-ca.wordpress.org/plugins/tags/lightning/)
   [SATS](https://en-ca.wordpress.org/plugins/tags/sats/)
 *  [Advanced View](https://en-ca.wordpress.org/plugins/coinsnap-bitcoin-donation/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/reviews/)

## Contributors

 *   [ Coinsnap ](https://profiles.wordpress.org/coinsnap/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/coinsnap-bitcoin-donation/)