Skip to navigation
DigitalOcean Referral Badge

Get $200 credit on DigitalOcean

Hostinger logo

Hostinger: Lightning-fast hosting, unbeatable uptime, top-notch support!

Open extra topbar

Install with CoinPayments (3rd party wallet)

⚠ NOTICE:
These installation instructions are for installing Bitcoin and Altcoin Wallets versions before 6.0.0 with CoinPayments Adapter extension versions before 2.0.0.
Since 6.0.0, installation instructions are found in the built-in documentation. In your WordPress admin screens, navigate to: Wallets Admin Docswallets-cpInstallation instructions.
The same instructions can be found at the homepage for the CoinPayments Wallets Adapter extension.

IMPORTANT NOTE: If you follow the installation instructions in the video, make sure to also assign the get_callback_address permission to your CoinPayments API key. This is missing from the video.

Overview

This howto guide will help you to install the Bitcoin and Altcoin Wallets WordPress plugin with a cloud wallet back-end, using the CoinPayments.net platform, and the coin adapter for it.

If you are interested in installing the plugin and connecting it to a full node, please see this guide instead.

Installing the Bitcoin and Altcoin Wallets plugin from WordPress.org

1. Log in to your WordPress installation as an admin.

2. Navigate to PluginsAdd new.

Menu item to add a new plugin to WordPress
3. Search for “wallets”.

Search for a plugin by keyword on WordPress.org

4. Find the Bitcoin and Altcoin Wallets plugin in the results, and click on the Install Now button:

Installing Bitcoin and Altcoin Wallets from WordPress.org

5. Make sure to also activate the plugin. Click on Activate. (If you are installing network-wide in a multi-site environment, click on Network active to make the plugin available to all sites on your network.)

Activating Bitcoin and Altcoin Wallets after installation

6. Once your plugin is activated, you will get an error message: The Bitcoin RPC API cannot be contacted. This is only relevant if you are attempting to connect to a full node Bitcoin wallet.

Bitcoin code node adapter error message

The plugin comes with one coin adapter built-in: The Bitcoin full node coin adapter. Since we will be installing the plugin with a web wallet, start by disabling the built-in coin adapter.

First, use the menu to navigate to WalletsBitcoin core node (BTC).

Bitcoin code node adapter in wallets menu

7. Then, disable the adapter. Untick the Enabled checkbox:

Bitcoin code node adapter settings page

8. Finally, click on Save changes at the bottom of the page:

Save changes button

The error message should now disappear.

If you visit the WalletsAdapters screen, you should not see any coin adapters listed at this stage.

Install the CoinPayments adapter extension from dashed-slug.net

You can now install the CoinPayments adapter to interface with the CoinPayments web wallets. To do this, you must first download the adapter extension.

Coin adapters are plugins that you can install to extend the parent plugin. All coin adapters are available for free download to anyone who signs up to dashed-slug.net.

9. Visit the signup page at https://www.dashed-slug.net/dashed-slug/subscribe/.

Signing up on the dashed-slug website

Fill in the form and make sure to tick the check boxes to indicate that you accept the legalese. You will get a confirmation message in your email.

10. Visit the dashed-slug homepage and log in using the email and password you entered in the previous step:

Logging in to the dashed-slug website

11. Use the menu to navigate to the homepage of the CoinPayments coin adapter extension, or use this direct link.

The CoinPayments adapter in the coin adapters menu on the dashed-slug website12. This page contains some information on the coin adapter, including a Troubleshooting section that lists some common pitfalls and solutions. For now, scroll down to the Download section, and click on the zip file with the latest version. Your browser will download the zip file.

The CoinPayments adapter downloads on the dashed-slug website

13. Go back to the admin screens of your WordPress installation, and visit PluginsAdd new again.

Menu item to add a new plugin to WordPress

14. This time, click on the Upload plugin button at the top of the screen.

Uploading a plugin from a downloaded zip file

15. Click on Browse and select the zip file you downloaded. Then click on Install now.

Selecting a plugin zip file to install

16. Once the plugin is unpacked, click on Activate.

Installing a plugin from zip file

Configure your CoinPayments.net account

17. To use the CoinPayments adapter, you must create an account on CoinPayments.net. While not strictly necessary, it is best if you use a separate account for each site you setup.

18. Go through the account registration process, then login to your CoinPayments account. You will also need to go through the Verification process, because the coin adapter requires API access.

19. This wallet will hold the cryptocurrencies of all users on your site. It is best that you set up two-factor authentication. Visit your Account Settings, then go to the Login & Security tab to setup 2FA.

The Login & Security tab in the CoinPayments account settings page

If you are not already using Google Authenticator on your phone or tablet, the link is here:

https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2

20. Go to the Coin Settings screen and select a few coins. It is best if you do not enable all the coins at once. For now, enable the Litecoin testnet coin. With this you can test connectivity with the wallet without transacting any actual coins. Click on Update Coin Preferences. You can later enable more coins as needed.

Enabling Litcoin testnet in the CoinPayments wallets page

21. You will need to create an API key for the plugin to use. Visit the API keys section of your CoinPayments account.

The API Keys menu item in CoinPayments

22. Generate an API key if none exist. Click on the Edit Permissions button for that key.

Button to edit API key permissions in CoinPayments

23. Make sure that at least the following permissions are set: get_callback_address, rates, balances, create_withdrawal, Allow auto_confirm = 1 in create_withdrawal, get_withdrawal_info. Then, click Update Permissions.

Configuring API key permissions in CoinPayments

Configure your plugin

24. In your WordPress installation, go to the coin adapter settings via the menu WalletsCoinPayments.

CoinPayments adapter in Wallets menu

25. You will need to provide four pieces of information to connect to the online wallet.

  • The Public and Private keys are those of the API key you created in step 21. Revisit the API Keys section and paste the two keys into the plugin form.
  • Your Merchant ID can be found in your Account Settings under the Basic Settings tab.
  • Your IPN Secret is a string that you choose. Enter a random string in your Account Settings under the Merchant Settings tab. Enter the same string in your plugin.

CoinPayments adapter connection settings

Once all the information is entered correctly, click on Save Changes.

26. To make sure that the list of available coins is downloaded, go to the HTTP Settings tab, and click on Clear HTTP cache.

CoinPayments adapter clear cache button

27. Visit the Coin options tab. Here you will see a list of all the coins you have enabled on the CoinPayments platform, such as the Litecoin testnet (LTCT) coin. Check to enable the coins you wish to make available to your users. Then, hit the Save changes button.

Enabling available coins in the CoinPayments adapter

28. To allow ERC-20 withdrawals, visit the WalletsCoinPaymentsERC-20 gas management tab, introduced in version 1.2.0 of the adapter. To ensure that ERC-20 tokens can be withdrawn, fill in the required details. Follow the instructions on the screen. You need to enter a free etherscan.io API key, so that the plugin knows which ERC-20 deposit addresses managed by CoinPayments hold tokens, and how much Ether they hold, if any. For each ERC-20 token you have enabled, you must specify the contract address, and two thresholds, as detailed on the screen. The plugin will run a cron job that finds addresses with tokens and no Ether, and will withdraw Ether to these addresses. This makes the deposited tokens withdrawable.

Making sure that everything works as expected

29. Visit the coin adapters list via the menu WalletsAdapters. You should see the Litecoin Testnet on CoinPayments adapter. Its Status should be Responding.

CoinPayments Litecoin testnet adapter in adapters list

30. Visit the Capabilities section to make sure that users with the correct capability have wallets. Go to WalletsCapabilities in your menu. The default user role in WordPress is the Subscriber role. If you wish subscribers to be able to use all of the wallet features, assign all the available capabilities to them, except manage_wallets. The manage_wallets capability must be reserved for administrators only, as it gives access to the Wallets admin menu.

Managing wallets capabilities

31. At this point, you may use the wallet shortcodes on your site’s pages. Alternatively, you can use the same UIs as Widgets in your theme’s widget areas.

32. To test deposits, first enter the

Not allowed. Please login or signup first!
shortcode into a page. Display that page in your front-end. You will see an LTCT deposit address and a QR code for it.

The <div class="dashed-slug-wallets deposit error">Not allowed. Please <a href="/membership-login/">login</a> or <a href="/dashed-slug/subscribe/">signup</a> first!</div> UI

33. Test a deposit by sending some Litecoin testnet coins to that address, using this testnet faucet: http://testnet.litecointools.com/

Allow a few minutes for the deposit to be mined, and to be discovered by the CoinPayments platform and the WordPress plugin.

If the deposit appears in your CoinPayments account but not in the plugin, please check the special troubleshooting guide for this issue.

34. If you have followed this tutorial, you have downloaded the coin adapter as a free subscriber to dashed-slug.net. If you decide to become a premium member, you will gain access to automatic updates to this extension, and to all other extensions you choose to install. To enable easy updates via the Plugins admin screen, you should follow these instructions to enter your member code.

If you are not a paying member, you can still keep your coin adapter up-to-date by manually downloading and installing the latest zip file from the dashed-slug page.

Getting help

That is all!

Install with CoinPayments (3rd party wallet)

Updated on 2022-08-08T08:08:30+00:00, by alexg.