Coinsnap Bitcoin Donation Installation Guide
If you have a WordPress website or blog, integrating Bitcoin donations is easy with the Coinsnap Bitcoin Donation plugin.
Simply install the plugin, link it to your Coinsnap account and your customers can donate with Bitcoin-Lightning. All incoming sats are immediately forwarded and credited to your Lightning Wallet, either via our Coinsnap or your BTCPay Server payment gateway, at your choice.
- Coinsnap Bitcoin Donation product description: https://coinsnap.io/coinsnap-bitcoin-donation-plugin/
- Coinsnap Bitcoin Shoutout product description: https://coinsnap.io/coinsnap-bitcoin-shoutout-plugin/
- Coinsnap Bitcoin Donation – Demo Store: https://donation.coinsnap.org/
- Coinsnap Bitcoin Shoutout – Demo Store: https://shoutout.coinsnap.org/
- WordPress: https://wordpress.org/plugins/coinsnap-bitcoin-donation/
- GitHub: https://github.com/Coinsnap/Bitcoin-Donation
Bitcoin Donation
Multi-Amount Bitcoin Donation
Bitcoin Shoutout
Works with Coinsnap or BTCPay Server
Coinsnap Bitcoin Donation is suitable for beginners as well as for Bitcoin pros: It let’s you choose wether you want to use our Coinsnap payment gateway with no technical competence at all, or if you want to use it with your own BTCPay Server. Just choose the respective option (as shown below) an fill in the respective data. And you’ll be up-and-running in minutes, one way or the other!
Install the Coinsnap Bitcoin Donation plugin
from the WordPress directory
With the Coinsnap for Contact Form 7 payment plugin, Coinsnap offers the option of integrating Bitcoin payments quickly and easily into any forms on your WordPress website.
You can download the plugin directly from the WordPress Marketplace or install it directly from within your WordPress installation.
Log in to your WordPress account, call up the WordPress backend and go to Plugins > Add New.
Enter “Coinsnap Bitcoin Donation” in the search bar and click on “Install“.
Download Coinsnap Bitcoin Voting from Github
Coinsnap Bitcoin Donation is currently under review by the WordPress organization.
Until it get’s listed there, please go to Github, click on the green button <>code on the top right [1] and choose Download ZIP [2].
Now upload this ZIP in the WordPress plugin admin area, using the Upload Plugin button on top of the add plugin screen. Next, activate the plugin, and you are set!
Then activate the plugin (3).
The Coinsnap Bitcoin Donation is now successfully installed and is listed as Bitcoin Donations in the black, left sidebar in the WordPress backend.
Connect Coinsnap account with the Coinsnap Bitcoin Donation plugin
Bitcoin Donation Coinsnap Settings
After you have installed and activated the Coinsnap Bitcoin Donation plugin, you need to configure the Coinsnap settings. Go to Bitcoin Donations -> Settings [1] in the black sidebar on the left.
Now choose your payment gateway Coinsnap [1]. (You can also choose BTCPay server if you are using one, and then fill in the respective information.)
Then you’ll have to enter your Coinsnap Store ID and your Coinsnap API Key. [2] (See below to learn how to retrieve these from your Coinsnap account.)
As soon as you’ve pasted the Store ID and the API Key into their fields, click on check. If you see a green message next to it saying Connection successful, your plugin is ready to accept Bitcoin donations and credit them to your Lightning wallet.
Don’t forget to klick on Save changes before you start configuring your donation form(s)!
Coinsnap Store Settings
In the Coinsnap backend, go to the Settings menu item, then click on Store in the blue field. There you will find the Coinsnap Store ID [1] and the Coinsnap API Key [2]. Copy these one after the other into the corresponding fields in the Coinsnap settings (see above). Then click on the Save Changes button at the bottom of the page to apply and save the settings.
Once you have entered and saved the Coinsnap data in the Contact Form 7 Coinsnap settings, you are set to receive Bitcoin transactions from your customers’ wallet to your wallet. Now just one last step remains and you can sell for Bitcoin!
Create a Bitcoin donation box for your WordPress website
How you set up a simple donation box
Go to Bitcoin Donations -> Donation Forms [1] in the left sidebar. In the tab Donation button you can now configure your donation settings:
Activate the Donation Button [2], choose your local currency [3], customize your Button Text [4] and the Title Text that will be shown in the donation box on your website [5].
Next choose the donation amount that you wish to be displayed in the donation box on your website [6]. Note: This amount refers to the FIAT currency you’ve chosen in [3]!
You can then set a Default Message [7] which is a placeholder that can be changed at will by your donors.
If you created a Thank you-page, put the URL into the next field [8] – your donors will be redirected to that page the moment they have successfully authorized the Sats they wanted to donate.
Now you can choose between to pre-defined box sizes – wide and narrow [9]. (Narrow, for example, is great for use in sidebars or footers, wide might be your choice below a post or so.)
Last, but not least, you can choose to collect certain information from your donors by checking the box in the Collect donor information line [10].
Collecting information from your donors
If you want to gather some intelligence on your donors, and have clicked the checkbox to do so, you will see this menu.
Now just choose which information you want to gather, and if you want it to be a mandatory information or leave it as an option for your donor to decide.
In this example the first name of the donor is a mandatory information. We do not try to collect their last name (Hidden), leave it to them to leave their Email and a message (Custom Field Name, to be filled by you). Accordingly, these fields are labelled optional.
Placing the Bitcoin donation box on your website
Now you are ready to display the Bitcoin donation box on your website. Simply copy the shortcode [coinsnap_bitcoin_donation] and paste it at any place you choose.
Multi-Amount Bitcoin Donation
The Multi-Amount Donation allows you to pre-define 3 donation values for the donor too choose from. Of course, your donors can still ignore those and set their own amount.
To configure a multi-amount donation, just choose the respective tab in the donation forms, and fill out the displayed form. Since this is very similar to the example above, and very straight forward, we are not going into the details of their setup here. Just give it a try, and you will easily manage to create the Multi-Amount Bitcoin Donation that you envision!
Bitcoin Shoutout
The Bitcoin Shoutout is a form of donation where the donor leaves a message, i.e. “I love your work – thank you so much!”. Also, the plugin provides a display where all the shoutouts from all donors will be shown. You can place this display (via shortcake) next to the donation box, or on a dedicated page of your website/blog.
To configure the Bitcoin shoutout donation, just choose the respective tab in the donation form, and fill out the displayed form. Since this is very similar to the example above, and very straight forward, we are not going into the details of their setup here. Just give it a try, and you will easily manage to create the Shoutout that you envision!
Test the donation payment
After all settings have been made, a test transaction should be carried out.
Fill out a donation box that you created and put up on your website and click on the payment button (“Donate Sats now!“)
If you are gathering donor information, fill out the form you see next.
You will now be redirected to the Bitcoin payment page to complete the purchase.
The Bitcoin payment page is now displayed and offers the payer the option of paying with Bitcoin or Lightning.
Both methods are integrated in the displayed QR code.
After successful payment, the invoice can be viewed in detail.
