Bitcoin Faucet WordPress Plugin by 99Bitcoins

This faucet plugin is still in Beta in probably has bugs and glitches. I can’t give it 24/7 support but I will try to fix anything that comes up if I have the time. If you have any issues, comments or suggestions please let me know through the comment section below.

Its’ finally here! The first ever Bitcoin Faucet WordPress plugin. Now you can start your own Bitcoin faucet in less than 5 minutes.

This page will basically be the official documentation of the plugin and will explain everything you need to know from start to finish in order to start your own Bitcoin faucet with WordPress.

Keep in mind that this is a free plugin and I don’t have a lot of time to maintain it, that’s why so of the user interface looks a bit weird and I will have limited time to answer support requests. However I will do the best I can in order to keep this plugin working and up to date. Also I will mainly use video tutorials in order to explain about the faucet and not written tutorials (it’s just faster for me to create them).

If you don’t know what a Bitcoin faucet is I suggest starting with this post that will describe most of what you need to know about the subject and how you can make a business from it. When you get to the part on how to build a Bitcoin faucet come back to this page to learn the easier way than what is described in the original post.

So let’s get down to building your WordPress Bitcoin Faucet:

1. Get a hosting provider and install WordPress on it

This is the very basics of what you’ll need. I’m assuming you already know how to do this, if you don’t then I’m posting a video here that explains how to set up WordPress. Any hosting provider should do the trick, I personally use Bluehost for these types of project.

2.  Install the Bitcoin Faucet WordPress Plugin

  • Download the Bitcoin Faucet WordPress Plugin – Download link
  • Go to “plugins” -> Add new -> Upload plugin
  • Choose the file you’ve just downloaded and upload it to your site
  • After the upload is compete click on “activate plugin”

3. Get a FaucetBox and SolveMedia account

  • Go to FaucetBox and create an account
  • Add your site’s URL to the account
  • Go to SolveMedia and create an account
  • Add your site’s URL to the account

Faucetbox is going out of business – we will soon update the plugin with a worthy alternative.

4. Set up the plugin

This faucet has A LOT of options. Since I don’t have time to write them all down I created a video explaining everything you need to know about the faucet:


5. Require registration for your faucet (optional)

Once of the best ways I’ve found to fight off spam is by requiring users to register to my site in order to use it. This deters most spammers and bots from the site. I use a paid plugin called “Wishlist Member” that takes care of setting up this registration process. This is not a must, but if you feel like you’re getting too many scammers on your site it’s worth to look into it.

If you’re looking for the “quick start guide” here are the musts:

Under the “general” tab

  • Enter your payouts and timer settings
  • Enter your SolveMedia API keys
  • Enter the URLs for your faucet page and “check address” page
  • The referral link URL scheme is this:

Under the “payment” tab

  • Enter your Faucetbox API keys

Faucetbox is going out of business – we will soon update the plugin with a worthy alternative.

On your faucet page:

  • Enter the faucet shortcode


Now that you’re good to go I suggest going back to the original post and reading everything that doesn’t involve setting up the faucet – it’s crucial information.

A few important things to remember:

  • Payments are made through FaucetBox but you will have to click the “make payment” button in order to send all addresses that qualify for payment to FaucetBox.
  • Make sure your FaucetBox account is funded or addresses won’t be queued for payout.
  • From personal experience I suggest allowing user comments on your faucet – it’s the fastest way to know that something is not working right.
  • At the moment the only data I gather from these faucets is how much is being paid – that’s all. No passwords, bitcoin addresses or any other sensitive information is being passed along. Just a number of how many Satoshis have been queued for payment each time you click “make payment”.

This faucet is still in Beta in probably has bugs and glitches. I can’t give it 24/7 support but I will try to fix anything that comes up if I have the time. If you have any issues, comments or suggestions please let me know through the comment section below.

Version Updates:

Version 1.3.5 (November 23rd 2016) – You can now update the plugin within from with the WP admin area

Version 1.3.4 (November 22nd 2016) – ePay issue fixed, displaying info about payouts on claims page

Version 1.3.3 (November 13th 2016) – DB query bug fix

Version 1.3.2 (November 13th 2016) – Fixing calculation of claims

Version 1.3.1 (November 13th 2016) – Minor text changes and updated user profile page with seniority

Version 1.3.0 (November 12th 2016) – Limited registered users to only one address, added seniority info on claims tab

Version 1.2.7 (November 8th 2016) – Added as payment option

Version 1.2.6 (November 4th 2016) – Ability to add admin bonuses / penalties, remove ref info if no referral was set

Version 1.2.4 (October 31th 2016) – Bug fixes, added timer and sound

Version 1.2.3 (October 28th 2016) – Bug fixes, fixed issue of payouts display in BTC instead of Satoshi

Version 1.2.1 (October 21th 2016) – Bug fixes

Version 1.2.0 (October 21th 2016) – Added registered user functionality, bot protection

Version 1.1.5 (October 20th 2016) – Bugs fixed, admin tool tips added

Version 1.1.4 (October 10th 2016) – Bugs fixed

Version 1.1.3 (September 29th 2016) – Fixed additional issue with “check address” URL.

Version 1.1.2 (September 26th 2016) – Fixed issue with “check address” URL, can be also a dynamic URL.

Version 1.1.1 (September 12th 2016) – Fixed SolveMedia issue, plugin is now compatible with php 5.2 and up.

If you feel this plugin helped you, feel free to reference it on your site, I appreciate your support.


  1. Hi OFIR, you are doing a wonderful job. I have followed your tutorial to the letter but my website doesnt load after i install the plugin. what could be the problem?

  2. Hi Ofir,

    since today morning, I’m having issues with payouts on ePay:
    Payouts status:
    Not enough balance [2016-11-28 13:33:54]
    Not enough balance [2016-11-28 13:13:52]
    Not enough balance [2016-11-28 12:54:09]
    No scheduled payouts were found [2016-11-28 12:33:50]
    No scheduled payouts were found [2016-11-28 12:13:49]
    No scheduled payouts were found [2016-11-28 11:53:49]
    No scheduled payouts were found [2016-11-28 11:33:50]
    No scheduled payouts were found [2016-11-28 11:13:48]
    No scheduled payouts were found [2016-11-28 10:55:22]
    Not enough balance [2016-11-28 10:34:03]

    When I click on Wallet it shows the right balance, which is 50x larger that Scheduled payout amount. I’ve tried changing API key on ePay admin and entered it again, but no luck.

    I have same version of your plugin on my other site, and there it works properly…

    Any thoughts?

    • Something seems wrong, are you sure you’re using the same account that has the 50x balance with the faucet. Is there any chance you can send me privately your wp-admin access so I can investigate?

  3. Hi OFIR, thanks for such a awesome plugin! Would it be possible to allow more than one faucet on a single site? I would like to offer multiple pages each with it’s own individual faucet on it.

    I have basic php skills and would appreciate any help you can assist me with as it is for a client and I need the work.

    Thanks again!

      • Hi, I would like to restrict individual faucets using the paid memberships pro. Basically I want to offer difference membership levels each having it own unique faucet and payout.


  4. Hi Orfir
    Thanks for the plugin, it works.. until the payout apparently.
    In your plugin “payout”, I have a list of supposely paid items. But my balance in epay does not change. It seems that your server is paying, without using my account ..

    Another thing, after deleting the cache this morning, all payout listing in the plugin have desappeared.

    Many thanks

  5. I don’t know if this is a different DB bug from the one fixed on November 13 but it has already cuased my website to go dow three times this weekend. investigations showed the following in the error log:

    [20-Nov-2016 23:24:11 UTC] WordPress database error Table ‘bitveuba_wp868.wpdr_99btc_bf_info_ip’ doesn’t exist for query SELECT * FROM wpdr_99btc_bf_info_ip WHERE ip = ‘2790817215’ made by require(‘wp-blog-header.php’), require_once(‘wp-includes/template-loader.php’), include(‘/themes/Newspaper/page.php’), the_content, apply_filters(‘the_content’), do_shortcode, preg_replace_callback, do_shortcode_tag, The99Bitcoins_BtcFaucet_Plugin->wpPageForm, The99Bitcoins_BtcFaucet_Info_Ips->get

    I have turned off the plugin completely for the first time since the downtimes hence i will reply to this comment if it goes down even when the plugin is not active but all errors lead to a Database problem which has not been fixed even after applying the November 13th updates.

    Thanks for your time.

Leave A Reply