Description
Accept Bitcoin and Ethereum donations with QR Code and automatic blockchain confirmation — no third-party checkout.
Turn Your GiveWP Donations into Cryptocurrency
WordPress integration Cryptocurrency Payment for GiveWP adds Bitcoin and Ethereum as native payment gateways to GiveWP. The donor picks the cryptocurrency, gets a QR Code with the exact amount, pays from any wallet and the donation is confirmed by reading the blockchain — the money goes straight to your wallet, with no intermediary and no chargeback.
The plugin keeps the donation flow inside your GiveWP forms (classic and legacy templates), converts the donation amount using the current exchange rate and checks every received transaction against the expected amount and destination wallet.
Why Choose Cryptocurrency Payment for GiveWP?
- No intermediary: donations go directly to the Bitcoin or Ethereum wallet you configure.
- Native to GiveWP: two new gateways appear in GiveWP → Settings → Payment Gateways, ready to be enabled per form.
- Automatic confirmation: the plugin queries the blockchain and completes the donation when a matching transaction arrives.
- Exchange rate on the fly: the donation amount is converted to the cryptocurrency at the moment of payment.
- Error margin: tolerate small differences between the amount sent and the amount expected (network and exchange variations).
- Transparent for the donor: QR Code, copy-to-clipboard wallet address and a countdown timer on the payment screen.
- Works with WordPress and GiveWP blocks: the gateway ships its own scripts for the GiveWP 3.x (Visual Form Builder) donation form.
Features at a Glance
- Bitcoin and Ethereum gateways, enabled separately.
- QR Code generated on the front end (no external image service).
- Amount converted to BTC/ETH with 8 and 18 decimals respectively.
- Transaction verification against destination wallet, amount and fees.
- Configurable error margin (percentage) for the amount comparison.
- Donation details block in the GiveWP donation screen, with a “Consult Transaction” button to re-check the blockchain.
- Debug log integrated with the GiveWP logs.
- Multi-currency: the exchange rate follows the currency configured in GiveWP.
** Recommended Plugins **
* Rede Itaú for WooCommerce – Accept PIX, credit and debit cards in your WooCommerce store.
* Shipping Calculator for Brazil – Provide accurate freight calculation for Brazilian addresses directly in your WooCommerce checkout.
* Link Invoice Payment for WooCommerce – Integrate custom payment methods and offer invoice-based payments in your WooCommerce store.
Configuration
- In the WordPress sidebar, go to the GiveWP settings menu.
- Select Payment Gateways and open the CriptoCurrencies section.
- Enter the Bitcoin wallet and the Ethereum wallet that will receive the donations.
- Optionally enable the Error margin and set a percentage (for example,
2for 2%) to accept small differences between the expected and the received amount. - Optionally enable the Debug Mode (logs in GiveWP → Tools → Logs) and the Advanced Debug Mode (console messages on the front end).
- Click on Save changes.
- Still in Payment Gateways, open the Gateways tab.
- In the Enabled Gateways table, enable Crypto Bitcoin and/or Crypto Ethereum.
- In the same table, click on the Visual Form Builder tab and enable the gateways for the new donation form template as well.
- Optionally reorder the gateways and set one of them as default, then click on Save changes.
External services
This plugin connects to an API to obtain the cryptocurrency blockchain transactions, it’s needed for transaction validation and confirmation after payment.
It sends the user cryptocurrency public wallet address every time a donation is being processed to check for all transactions received. This service is provided by BlockCypher: Terms of service, privacy policy.
This plugin connects to an API to obtain the cryptocurrency price for conversion, it’s needed for transaction amount definition.
It sends the donation currency and the cryptocurrency used in the donation. This service is provided by CoinGecko: Terms of service, privacy policy.
External Libraries
This plugin bundles the following third-party library:
- QR Code JS by davidshimjs: generates the payment QR Code on the front end, so the wallet address and the amount never leave the donor’s browser to a third-party image service. Source: davidshimjs/qrcodejs (MIT license).
Installation
1. Using the WordPress Admin Dashboard (Recommended)
- Navigate to Plugins → Add New.
- Click Upload Plugin and select the
lkngc-cryptocurrency-for-givewp.zipfile. - Click Install Now and then Activate.
- Go to GiveWP plugin → Settings → Payment Gateways to configure the plugin.
2. Manual Installation via FTP
- Extract the plugin ZIP file.
- Upload the extracted folder to
wp-content/plugins/. - Activate the plugin in the WordPress admin dashboard under Plugins.
3. WP-CLI Installation
- Upload the plugin folder to
wp-content/plugins/. - Run:
bash
wp plugin activate lkngc-cryptocurrency-for-givewp
FAQ
Q: What is the license of the plugin?
A: This plugin is released under the GPLv3 license.
Q: What do I need to use this plugin?
A: You need GiveWP version 2.3.0 or later installed and active, and a Bitcoin and/or Ethereum wallet to receive the donations.
Q: What PHP version do I need?
A: PHP 8.1 or later. The minimum is declared in the plugin header, so WordPress blocks the activation on older versions instead of failing at runtime.
Q: Which cryptocurrencies are supported?
A: Bitcoin (BTC) and Ethereum (ETH), each one as a separate gateway that can be enabled per form.
Q: When is a donation marked as complete?
A: When the blockchain returns a transaction that pays the configured wallet with the expected amount (converted to BTC/ETH and, optionally, within the configured error margin).
Q: What is the error margin for?
A: Because of exchange rate and network variations, the amount that arrives can differ by a few cents. The margin defines how much difference is still accepted before the plugin considers the transaction as not matching.
Q: Do I need an account on a payment gateway?
A: No. There is no intermediary: the donation goes directly to your wallet. The plugin only reads public blockchain data and the cryptocurrency price.
Q: The donation stayed pending — what now?
A: Open the donation in GiveWP and use the Consult Transaction button in the donation details block to verify the blockchain again, after the transaction is confirmed by the network.
Q: Does it work with the new GiveWP donation form (Visual Form Builder)?
A: Yes. Both gateways are registered for the GiveWP 3.x form, and the QR Code and the amount are rendered by the plugin scripts.
Q: Does it work with the classic (legacy) form template?
A: Yes. In forms using the classic template the gateway renders its own markup with the QR Code, the wallet address and the confirmation buttons.
Q: Is the plugin compatible with the latest WordPress version?
A: Yes — tested up to WordPress 7.1.
Screenshots
Changelog
4.0.4 – 18/11/2026
- Fix: the Ethereum gateway queried the Bitcoin chain, so ETH donations were never confirmed automatically.
- Fix: the version constant check used a name that does not exist, which served every asset with the fixed version 1.0.0 (broken cache busting after updates).
- Fix: the admin class received the version in the wrong constructor argument.
- Fix: the donation details block rendered empty because load_template() does not expose its third argument to the template.
- Fix: the form template lookup had the WordPress table prefix hardcoded and crashed on sites that do not use the “wp_” prefix.
- Fix: the REST verification route killed the JSON response (exit) when the request was missing parameters, and crashed when the donation was not found or the blockchain API was unavailable.
- Fix: uninstall now removes only the plugin options and no longer breaks if GiveWP was already deleted.
- Tweak: code standard cleanup and removal of the deprecated accesses flagged by the Plugin Check.
- Tweak: minimum required PHP raised to 8.1, aligned in the plugin header, the readme and the release workflows.
- Tweak: readme rewritten, with the external services, libraries and configuration documented.
- Tweak: removed the unused npm/eslint boilerplate from the repository (the plugin has no JavaScript build step and never used those packages), so the release package no longer ships a package.json and the outdated dependencies reported by Dependabot are gone.
4.0.3 – 12/03/2026
- Addition of new icons and banners.
4.0.2 – 11/02/2025
- WordPress guidelines update
- Fixed script errors;
- Updated slug to lkngc-cryptocurrency-for-givewp.
4.0.1 – 03/02/2025
- WordPress guidelines update
4.0.0 – 16/09/2024
- Refatoração completa do plugin com uso de boilerplate.
- Implementação de boilerplate para padronização e melhores práticas no desenvolvimento.
- Compatibilidade com o Give 3.0.
- Correção na geração do QrCode.
- Otimização e limpeza geral do código para melhor desempenho e manutenção.
- Implementação de caching de consultas para otimizar o tempo e reduzir o número de requisições à API.
3.0.0 – 10/10/23
- Complete refactoring for best practices.
- Integration for new GiveWP v3.0.0 form.
- Added configuration for margin of error, used in payments verification.
- Fixed bug that causing multiple API requests.
2.1.2
- Fixed missing translation.
- Fixed decimal handling.
- Fixed decimal handling with PagHiper.
2.1.1
- Fixed bug of unimported files.
- Improved plugin activation function.
2.1.0
- Implemented translation for English and Portuguese.
- Corrected multi-currency compatibility.
- Added compatibility with native Bitcoin donations from GiveWP.
2.0.0
- Refactored donation metadata.
- Added attribute sanitization.
- Code cleaning and optimization.
- Changed endpoint for automatic updates.
1.1.1
- Fixed license verification script bug.
1.1.0
- Added option to activate and register Waves wallet.
- Minor display adjustments.
- Updated donation metadata.
1.0.0
- Plugin release.



