Allows your Bitcoin and Altcoin Wallets WordPress plugin to interface with your cloud wallet account.

The Bitcoin and Altcoin Wallets WordPress plugin by default lets you connect a Bitcoin wallet daemon with your WordPress site. This normally requires that you run a full Bitcoin node on a machine that you own.

If you do not wish to do so, you can connect to an online cloud wallet service such as is a service that provides online merchants with wallets for a growing number of cryptocurrencies.


To install Bitcoin and Altcoin Wallets with the CoinPayments adapter, please follow the installation instructions detailed in the following article:

Install with CoinPayments (cloud wallet)


  • Deposits are implemented over CoinPayments callback addresses and rely on the IPN callback mechanism of that service. This introduces the following limitations:
    • The site where this adapter is installed must be contactable over the internet. IPN callbacks will not work if your WordPress installation is behind a firewall.
    • The site where this adapter is installed must be on the default HTTP port for Web (80). IPN callbacks will not work over other ports. This is a limitation of CoinPayments.
    • Do not enter an IPN URL in your settings. It is being set automatically
    • If you do not enter the IPN secret as mentioned in the installation instruction above, deposits will not work.
  • Since version 1.2.0, ERC-20 tokens, such as the popular USDT.ERC20 token, require special treatment, due to how the Ethereum blockchain and the CoinPayments platform work. TL;DR you must deposit Ethereum to your private Ethereum address to pay for gas. The plugin will distribute the Ethereum to the appropriate addresses, so that ERC-20 tokens do not get “stuck” in ERC-20 deposit addresses. The withdrawal fees that you set on these coins can pay for this Ethereum. Read the installation instructions for more details.

to enable a currency:

  1. Enable the currency in your settings.
  2. Enable the same currency in the Enabled Coins admin screen of this plugin extension.


I noticed that the provides a way to swap coins for one another. Is it possible to use its convert feature with this plugin?

The whole idea around Bitcoin and Altcoin Wallets is that app extensions are decoupled from coin adapters. This makes the plugin future-proof, as many new wallet types can be integrated in the future. It also places a restriction that coin adapters needs to be an abstraction that presents a uniform API.

If I were to split coin adapters into ones that do support swapping and ones that do not, how would that be communicated to the end user via the API? Moreover, what if two different types of coin adapters were to offer swapping features, but only for coins that they themselves provide, and not across wallet back-ends? This would be near impossible to manage and communicate to the end user effectively. The solution to this problem is a design principle called the Separation of Concerns.

The conversion feature provided by the CoinPayments platform uses ShapeShift as a backend. Rather than implementing this in the coin adapter, it has been implemented where it belongs: as an app extension. For integration with ShapeShift, please click here. This solution works whether you use CoinPayments or a full node wallet, or both. Plus, this includes both Bitcoin-like and Cryptonote full node wallets. As long as a coin is supported by ShapeShift, it can be exchanged. In the future there will be implementations for Changelly and other swapping services too.

On the other hand, if you wish to provide the full exchange experience to the user, use the Exchange extension.


Deposits come through to the CoinPayments platform but do not show up in the plugin.

Usually this is due to your host’s firewalls not allowing incoming IPNs on port 443, but please consult the special HOWTO guide on this issue.

I have recently changed server and the coin adapters are not showing. Adapter status is not responding.

If you have created an API key with IP filtering, go to your API key settings and change the IP to the one of your new server. Deactivate your coin adapter for two minutes, then try the adapter again.

The coin adapter works and the front-end UIs are showing but withdrawals fail.

  1. Check to see if you have entered the IPN secret correctly in the coin adapter settings.
  2. Check the error message emailed by the failed withdrawal transactions.
  3. Make sure the live wallet has enough funds for user withdrawals.

Deposits do not work at all, AND when I visit the IPN history page in CoinPayments I do not see any IPN messages being attempted.

Make sure that you have not specified any IPN URL in your CoinPayments account. The IPN URL is set automatically by the plugin.

After entering the codes, I am getting the error: “Bitcoin and Altcoin Wallets: CoinPayments Adapter failed to discover list of available coins: The API call returned error: Too many errors in the last two minutes from XXX.XXX.XXX.XXX – please fix your code and try again…”

Make sure that all four codes you entered are correct, then stop using your site for two minutes. If necessary, you can deactivate the plugin for two minutes. Once activated again, the coin adapter will now respond and you can check again that you have entered the correct codes.

Withdrawals for ERC-20 tokens don’t work.

This is a known issue, resolved in version 1.2.0 of the adapter. The deposit addresses generated for these tokens do not hold any Ether, and therefore the ERC-20 tokens deposited on these addresses are not movable. The plugin can distribute Ether to these addresses as needed, to make the tokens movable. But this can only be done if sufficient Ether is available. Check the ERC-20 Gas Management settings section, the installation instructions, and the relevant HOWTO on gas management for more details.

Withdrawals are executed but the CoinPayments internal transaction ID is never replaced by a blockchain TXID even after several minutes have elapsed.

Withdrawals are first assigned a temporary unique ID coming from the CoinPayments platform. Once withdrawals are executed, they are assigned an actual blockchain TXID. The plugin will discover the TXID via polling on the next cron job, and will replace the provisional ID with the TXID.

If this is not working, check to see if the cron jobs are running.

The coin adapter is listed under Adapters as Responding, and I have enabled some coins in the CoinPayments platform and in the coin adapter’s settings, but the enabled coins do not show up in the frontend.

Check steps 21 to 23 of the installation instructions to make sure that the correct permissions are given to your API key. This problem can be caused by a missing get_callback_address permission.

A coin that I had previously enabled is now disabled.

Sometimes one particular wallet does not return deposit addresses, either because the wallet is in maintenance or for some other reason. This counts as an error, and the API can temporarily become unavailable for you if you trigger too many errors. To avoid this situation, wallets that do not return deposit addresses are automatically disabled. You can safely re-enable them later to see if they work now.

I recently installed version 1.0.8 or later and my site is slow.

This is temporary. Previously, coin icons and logos were hot-linked from the CoinPayments web server. This is not a good idea, since the images have a cross-origin policy that disallows browsers from displaying them in your site. Instead, the adapter, beginning from version 1.0.8, caches the icons into your wp-content/uploads/wallets-cp directory on your server, and subsequently serves the icons from that location. This also means that the directory must be writable (you will get a warning in the admin screens if it is not). If you have many coins enabled, visit the Adapters list admin screen one or two times. This will force the plugin to cache all the icons. Once this is done, no more delays will be caused.


Available for free to subscribers and premium members only (you need to be logged in).


Please visit the support area for any issues, suggestions, feedback regarding this plugin extension.

For support regarding the parent plugin, Bitcoin and Altcoin Wallets, please use the support forums on Coin Adapter extension

Updated on 2021-08-10T10:11:10+00:00, by alexg.