Coinsnap for Paid Memberships Pro Installation Guide

These requirements must be met for Coinsnap for Easy Digital Downloads (EDD) to function correctly:

WordPress & Paid Memberships Pro

• A self-hosted WordPress website
• Paid Memberships Pro installed and activated

Coinsnap & Payments

• An active Coinsnap account
  -> how to set up a Coinsnap account
• A connected Bitcoin Lightning wallet (self-custodial wallet or BTCPay Server)
  -> how to get a Lightning address
• The installed Coinsnap for Paid Memberships Pro plugin
  -> How to install the plugin and connect it with your Coinsnap account or your BTCPay Server

Server & Access

• Ability to install and activate WordPress plugins
• HTTPS (SSL) enabled on the website

Paid Memberships Pro Setup

• At least one Paid Memberships Pro subscription created

All the requirements listed above are met, and you have successfully installed the plugin in your WordPress.
If not, here is a Step-by-step: How to install a Coinsnap plugin in WordPress guide to help you install the plugin.

You will soon be able to accept Bitcoin payments (on-chain and Lightning) directly from within your Paid Memberships Pro — without the need for a complex shop system like WooCommerce or traditional payment providers such as credit cards or PayPal. But before you can do that, you need to configure Bitcoin payments in your PMPro plugin.

PMPro COINSNAP SETTINGS

Go to Memberships → Settings [1] in the left sidebar of your WordPress backend. Open the Payments [2] tab.

In Global Settings → Payment Gateway, choose Coinsnap [3].

Then scroll down to the Payment Gateway Settings section. In the Coinsnap row, click Edit Settings [4] to configure the Coinsnap payment gateway.

You will now see this screen:

There are four options you need to configure. We’ll now walk you through each one step by step—and explain what it does and why it matters.

1. Choose and set up your payment provider

You now need to choose between two payment gateways: Coinsnap or your own BTCPay Server.

After making your selection, enter the corresponding Store ID and API Key for either Coinsnap or BTCPay Server.

Read here which payment provider is best for you and how to connect it to your plugin:

Coinsnap

Coinsnap is the easiest option. Coinsnap handles the technical setup for you and connects your store to Bitcoin and Lightning payments with just a few clicks. It’s ideal if you want a quick, hassle-free solution without managing your own payment infrastructure.

Learn here how to retrieve your Coinsnap Store ID and API Key:

-> Step-by-step explanation: How to connect your Coinsnap account with your plugin

BTCPay Server

BTCPay Server is a self-hosted option for merchants who want full control. You run your own Bitcoin and Lightning payment server, manage your own wallets, and don’t rely on a third party. This option offers maximum independence but requires more technical setup and maintenance.

Learn how to retrieve your Store ID and API Key using our BTCPay Server wizard here:

-> Step-by-step explanation: How to connect your BTCPay Server with your plugin

2. Customize the Bitcoin payment button shown at checkout

In this section, you can define how the Bitcoin / Lightning payment option is presented to your customers during checkout.

By default, the payment button is labeled “Pay with Bitcoin (Onchain + Lightning)”. You can freely replace this text with wording that better fits your checkout flow or tone, for example “Pay with Bitcoin now!”.

3. Redirect after payment and Return URL after payment

Here you define what happens after a successful payment. If Redirect after payment is enabled, the customer will be redirected back to the page containing the form from which the payment was made.

If you prefer to use a custom thank-you page, create the page and enter its URL in the Return URL after payment field.

4. PMPro  payment statuses

Easy Digital Downloads tracks the status of each payment associated with a form submission. These statuses indicate whether a payment is error, pending, refunded, review, success, or token, and help you understand the current state of each transaction.

The Coinsnap Bitcoin payment plugin only tracks three payment statuses — Expired, Settled, and Processing. You now need to map each of these to the corresponding status option available in Easy Digital Downloads.

We strongly recommend keeping the default payment status mapping (see image below), as it provides the most reliable and consistent behavior in almost all cases; selecting an alternative option from the dropdown should only be done in very specific, exceptional circumstances.

DONE

Save these settings by clicking the Save Changes button below. Your Paid Memberships Pro Coinsnap settings will now look like this:

To ensure everything works fine you should buy a membership on your website with Bitcoin.

Go to the login of your membership (while not being logged in!), and click on Join Now [1].

Select your preferred membership plan (Pro) [1].

You will see information now on your chosen membership plan [1]. If this is ok,

enter a Username [2], a Password [3]  (confirming the next field), and your email address [4] (again, confirm in the next field).

Then click on the payment Button on the bottom (Coinsnap (Bitcoin+Lightning)) [5].

Now you see the qr-code for your payment. Scan it with your Lightning wallet and authorize the payment.

The payment has been accepted, and the Satoshis have already been transferred to your Lightning wallet.

The new subscriber is then forwarded to his membership confirmation:

If you get the same process when creating a membership on your website with PMPro, then all is good — your PMPro is correctly connected with Coinsnap or your BTCPay Server and you are ready to charge Bitcoin with your PMPro plugin!