.github/ISSUE_TEMPLATE | ||
assets | ||
include | ||
templates/monero-gateway | ||
.gitignore | ||
.travis.yml | ||
LICENSE | ||
monero-woocommerce-gateway.php | ||
README.md | ||
readme.txt |
Monero Gateway for WooCommerce
Features
- Payment validation done through either
monero-wallet-rpc
or the xmrchain.net blockchain explorer. - Validates payments with
cron
, so does not require users to stay on the order confirmation page for their order to validate. - Order status updates are done through AJAX instead of Javascript page reloads.
- Customers can pay with multiple transactions and are notified as soon as transactions hit the mempool.
- Configurable block confirmations, from
0
for zero confirm to60
for high ticket purchases. - Live price updates every minute; total amount due is locked in after the order is placed for a configurable amount of time (default 60 minutes) so the price does not change after order has been made.
- Hooks into emails, order confirmation page, customer order history page, and admin order details page.
- View all payments received to your wallet with links to the blockchain explorer and associated orders.
- Optionally display all prices on your store in terms of Monero.
- Shortcodes! Display exchange rates in numerous currencies.
Requirements
- Monero wallet to receive payments - GUI - CLI - Paper
- BCMath - A PHP extension used for arbitrary precision maths
Installing the plugin
Automatic Method
In the "Add Plugins" section of the WordPress admin UI, search for "monero" and click the Install Now button next to "Monero WooCommerce Extension" by mosu-forge, SerHack. This will enable auto-updates, but only for official releases, so if you need to work from git master or your local fork, please use the manual method below.
Manual Method
- Download the plugin from the releases page or clone with
git clone https://github.com/monero-integrations/monerowp
- Unzip or place the
monero-woocommerce-gateway
folder in thewp-content/plugins
directory. - Activate "Monero Woocommerce Gateway" in your WordPress admin dashboard.
- It is highly recommended that you use native cronjobs instead of WordPress's "Poor Man's Cron" by adding
define('DISABLE_WP_CRON', true);
into yourwp-config.php
file and adding* * * * * wget -q -O - https://yourstore.com/wp-cron.php?doing_wp_cron >/dev/null 2>&1
to your crontab.
Option 1: Use your wallet address and viewkey
This is the easiest way to start accepting Monero on your website. You'll need:
- Your Monero wallet address starting with
4
- Your wallet's secret viewkey
Then simply select the viewkey
option in the settings page and paste your address and viewkey. You're all set!
Note on privacy: when you validate transactions with your private viewkey, your viewkey is sent to (but not stored on) xmrchain.net over HTTPS. This could potentially allow an attacker to see your incoming, but not outgoing, transactions if they were to get his hands on your viewkey. Even if this were to happen, your funds would still be safe and it would be impossible for somebody to steal your money. For maximum privacy use your own monero-wallet-rpc
instance.
Option 2: Using monero-wallet-rpc
The most secure way to accept Monero on your website. You'll need:
- Root access to your webserver
- Latest Monero-currency binaries
After downloading (or compiling) the Monero binaries on your server, install the systemd unit files or run monerod
and monero-wallet-rpc
with screen
or tmux
. You can skip running monerod
by using a remote node with monero-wallet-rpc
by adding --daemon-address node.moneroworld.com:18089
to the monero-wallet-rpc.service
file.
Note on security: using this option, while the most secure, requires you to run the Monero wallet RPC program on your server. Best practice for this is to use a view-only wallet since otherwise your server would be running a hot-wallet and a security breach could allow hackers to empty your funds.
Configuration
Enable / Disable
- Turn on or off Monero gateway. (Default: Disable)Title
- Name of the payment gateway as displayed to the customer. (Default: Monero Gateway)Discount for using Monero
- Percentage discount applied to orders for paying with Monero. Can also be negative to apply a surcharge. (Default: 0)Order valid time
- Number of seconds after order is placed that the transaction must be seen in the mempool. (Default: 3600 [1 hour])Number of confirmations
- Number of confirmations the transaction must recieve before the order is marked as complete. Use0
for nearly instant confirmation. (Default: 5)Confirmation Type
- Confirm transactions with either your viewkey, or by usingmonero-wallet-rpc
. (Default: viewkey)Monero Address
(if confirmation type is viewkey) - Your public Monero address starting with 4. (No default)Secret Viewkey
(if confirmation type is viewkey) - Your private viewkey (No default)Monero wallet RPC Host/IP
(if confirmation type ismonero-wallet-rpc
) - IP address where the wallet rpc is running. It is highly discouraged to run the wallet anywhere other than the local server! (Default: 127.0.0.1)Monero wallet RPC port
(if confirmation type ismonero-wallet-rpc
) - Port the wallet rpc is bound to with the--rpc-bind-port
argument. (Default 18080)Testnet
- Check this to change the blockchain explorer links to the testnet explorer. (Default: unchecked)SSL warnings
- Check this to silence SSL warnings. (Default: unchecked)Show QR Code
- Show payment QR codes. (Default: unchecked)Show Prices in Monero
- Convert all prices on the frontend to Monero. Experimental feature, only use if you do not accept any other payment option. (Default: unchecked)Display Decimals
(if show prices in Monero is enabled) - Number of decimals to round prices to on the frontend. The final order amount will not be rounded and will be displayed down to the nanoMonero. (Default: 12)
Shortcodes
This plugin makes available two shortcodes that you can use in your theme.
Live price shortcode
This will display the price of Monero in the selected currency. If no currency is provided, the store's default currency will be used.
[monero-price]
[monero-price currency="BTC"]
[monero-price currency="USD"]
[monero-price currency="CAD"]
[monero-price currency="EUR"]
[monero-price currency="GBP"]
Will display:
1 XMR = 123.68000 USD
1 XMR = 0.01827000 BTC
1 XMR = 123.68000 USD
1 XMR = 168.43000 CAD
1 XMR = 105.54000 EUR
1 XMR = 94.84000 GBP
Monero accepted here badge
This will display a badge showing that you accept Monero-currency.
[monero-accepted-here]
Donations
monero-integrations: 44krVcL6TPkANjpFwS2GWvg1kJhTrN7y9heVeQiDJ3rP8iGbCd5GeA4f3c2NKYHC1R4mCgnW7dsUUUae2m9GiNBGT4T8s2X
ryo-currency: 4A6BQp7do5MTxpCguq1kAS27yMLpbHcf89Ha2a8Shayt2vXkCr6QRpAXr1gLYRV5esfzoK3vLJTm5bDWk5gKmNrT6s6xZep