Easy Digital Downloads (EDD) integration

WARNING

Please be aware that this integration is not maintained by the BTCPay Server team. If you have any feature requests or bug reports, please do so on coinsnap repository (opens new window) directly.

## Requirements

Please ensure that you meet the following requirements before installing this plugin.

• PHP version 8.0 or newer
• The cURL, gd, intl, json, and mbstring PHP extensions are available
• A WordPress site with Easy Digital Downloads (EDD) installed (Installation instructions (opens new window) Note: you don't need the Pro version of EDD to get started
• You have a BTCPay Server version 2.0.0 or later, either self-hosted or hosted by a third-party
• You've a registered account on the instance
• You've a BTCPay store on the instance
• You've a wallet connected to your store

1. Install Bitcoin for Easy Digital Downloads Plugin

Thanks to Coinsnap (opens new window), with their Bitcoin for Easy Digital Downloads plugin you can also connect it to BTCPay Server.

There are three ways to install the plugin:

• From within WordPress via the Admin Dashboard (recommended, see below)
• WordPress plugin directory (opens new window)
• GitHub Repository (opens new window)

1.1 Install plugin from WordPress Admin Dashboard (recommended)

1. On left sidebar click Plugins -> Add New.
2. In Search, type "easy digital downloads btcpay".
3. Click Install now and then Activate.

1.2 Download and install plugin from GitHub

Alternatively, you can download the plugin from GitHub and install it manually:

1. Go to the plugin repository (opens new window).
2. Download the .zip by clicking on Code -> Download ZIP.
3. On WordPress admin dashboard click on Plugins -> Add Plugin.
4. Click on Upload Plugin button and select the .zip file you just downloaded.
5. Click Install Now and then Activate.

2. Connecting EDD and BTCPay Server

Bitcoin for EDD plugin is a bridge between your BTCPay Server (payment processor) and your EDD store. No matter if you're using a self-hosted or third-party solution, the connection process is identical.

2.1 Enable Bitcoin support in EDD

:::info After the installation above the payment gateway will be listed as "Coinsnap" in the EDD payment gateways. :::

1. In WordPress admin UI: click on [Settings] inside your EDD (Downloads) section on the left sidebar
2. Click on "Payments" tab at the top
3. Switch Coinsnap toggle to enable it.
4. Click [Save Changes] button at the bottom.

2.2 Configure Coinsnap gateway

1. Make sure you are on the Coinsnap settings form, if not click on the _"Coinsnap" tab at the top.
2. On the field "Payment provider" make sure you select "BTCPay Server".
3. You will see the "BTCPay Server URL" input field, enter the URL to your BTCPay Server instance (e.g., https://btcpay.example.com).
4. Now you can click on the [Generate API key] button.

You will get redirected to the BTCPay Server instance and follow the steps below:

2.3 On BTCPay Server: Authorize the plugin access

On your BTCPay Server instance:

1. You will see an authorization page where you need to select your store, in our case "EDD". Click on [Continue].
2. On the next screen you will see the permissions required by the plugin. Enter a label and click on [Authorize app] button at the bottom.
3. You will get redirected back to the EDD settings form. You should now see that the "Connection status" says BTCPay Server is connected and the "Store ID" and "API key" fields are filled already.
4. To be sure all has beens saved, click on [Save Changes] button at the bottom.

Congratulations, you are now ready to sell your downloads for Bitcoin via BTCPay Server!

3. Testing the checkout

Making a small test-payment from your store will give you peace of mind. Always make sure that everything is set up correctly before going live.

On Checkout place your order:

You will get redirected to BTCPay Server and qr-code for the invoice will be shown:

After you paid the invoice you can go back to your site:

You will see the order confirmation page, with a completed payment satus:

On admin backend under "Downloads" -> "Orders" you will also see the order is completed:

Get support

You can open an issue on Coinsnap Github repository (opens new window) or reach us on Telegram (opens new window) or Mattermost chat (opens new window).