Practical overview
When it fits
Consider it when an Easy Digital Downloads store needs to manage Bitcoin refund requests or disputes as part of its order workflow.
Who it is for
- Merchants running WordPress stores with Easy Digital Downloads who handle Bitcoin payments.
- Store operators seeking to manage full or partial Bitcoin refunds alongside EDD orders.
Documented uses
- Create a refund request from an EDD order.
- Manage a partial refund for a digital purchase.
- Track a refund transaction and maintain refund records.
- Configure EDD to trigger a refund under a policy window, as described in the README.
Requirements & limits
- The listed prerequisites are WordPress 5.8 or later, Easy Digital Downloads 3.x, PHP 8.0 or later, and a Bitcoin node or third-party API.
- The README says the merchant's wallet provides funds and UTXOs for refunds; these are new Bitcoin transactions, not reversals of the original payment.
- Network fees are paid from the merchant's wallet, and estimates may vary with network conditions.
- The README identifies the project as MIT-licensed.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Prepare a WordPress site for RecoupPay
Meet the stated platform and Bitcoin connectivity prerequisites before using the refund manager.
Before you start
- WordPress 5.8 or higher
- Easy Digital Downloads 3.x
- PHP 8.0 or higher; PHP 8.1 is recommended
- A Bitcoin node or third-party API, such as Blockonomics or Electrum
- An SSL certificate is recommended for customer privacy
Steps
Ensure the site uses WordPress 5.8 or higher and PHP 8.0 or higher.
Install or use Easy Digital Downloads 3.x on the site.
Provide access to a Bitcoin node or third-party API; the README lists Blockonomics, Electrum, or a fully synced node as examples.
Use an SSL certificate for the store where possible.
Expected outcome
The site meets the README's listed system requirements and has a stated Bitcoin connectivity option.
Guide limitations
- SSL is recommended, not listed as mandatory.
- Refund transactions require sufficient wallet balance or UTXOs and incur network fees; fee estimates may not account for sudden spikes.
Create a refund request from an EDD order
Start a Bitcoin refund request through the Easy Digital Downloads order-edit workflow.
Before you start
- A WordPress site with Easy Digital Downloads 3.x and the stated WordPress and PHP requirements
- A Bitcoin node or third-party API
- Sufficient wallet balance or UTXOs for the refund, plus funds for network fees
Steps
Open the relevant order in the Easy Digital Downloads order edit screen.
Create a refund request from that screen.
Review the estimated network fee and the amount the customer will receive.
Submit the refund transaction from the merchant's wallet to the customer's Bitcoin address.
Expected outcome
The README describes a signed Bitcoin refund transaction sent to the customer's address, with blockchain confirmation tracking until the transaction has at least one confirmation.
Guide limitations
- The README does not specify the exact dashboard controls or a detailed submission procedure.
- Bitcoin refunds create new, irreversible transactions; they are not reversals of the original payment.
- A refund can fail if the wallet lacks sufficient UTXOs or balance, and network fees can vary.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 17 October 2026
- Original website title
- Bermfs/blockonomics-edd-wallet-gateway · Official homepage title · retained in its source language