This version of Xadrez is not being updated anymore. Get the best version at the official BTCPay Server Documentation
======================
Seeking the best open source setup for an e-commerce store that accepts Litecoin (LTC) and Bitcoin (BTC)
Author: Ricardo Sodré Andrade (Twitter)
This guide is not finished yet (I expect to put images and describe everything step-by-step). At this stage you can get good ideas and directions to build your own e-store. If you consider this useful, contribute with some lites to LTC address: LdMwrnsBoggWVcHcM7yeg242e8QqetYAzU
Short URL to this guide: http://xadrez.yndexa.com
I personally run an online bookstore which uses Xadrez to give the option for customers pay with Litecoin and Bitcoin: 9Bravos. At same time that e-store let me validate what I've documented here. The store is in Brazilian Portuguese.
- Introduction
- Components
- Wordpress
- WooCommerce plugin
- BTCpay Server
- "Wordpress-Woocommerce-BTCpay" plugin
- Fiat2LTC-WooCommerce plugin
- Electrum (desktop and mobile wallet)
- Electrum-LTC (desktop wallet)
- Samourai Wallet (mobile wallet)
- Loafwallet (mobile wallet)
This tutorial expect to give directions and tools to anyone who want to setup an ecommerce store that accepts Litecoin (LTC) and Bitcoin (BTC). Old payment methods like credit card and stuff can be enabled too. All components in this solution are open source software and can be obtained at their websites.
This setup is called Xadrez just to be easier to anyone who want to refer the proposal presented here. Xadrez is Chess in portuguese language and we will change the pieces (the components) on the board until we reach a very nice full featured setup for a stable and definitive ecommerce store (the Checkmate).
The e-commerce store setup need to use stable software, be easy to configure by merchants with no more than basic tech skills and be able to show products, handle carts, inventory, customer accounts, generate reports and others expected capabilities. All the Litecoin and Bitcoin received need to go directly to the merchant's (preferable mobile) wallets.
I personally run an online bookstore which uses Xadrez to give the option for customers pay with Litecoin and Bitcoin: 9Bravos. At same time that e-store let me validate what I've documented here. The store is in Brazilian Portuguese.
Currently setup of Xadrez is formed by the components listed and described below.
"WordPress started in 2003 with a single bit of code to enhance the typography of everyday writing and with fewer users than you can count on your fingers and toes. Since then it has grown to be the largest self-hosted blogging tool in the world, used on millions of sites and seen by tens of millions of people every day."
Wordpress is a popular Content Management System (CMS) used to run portals, websites, blogs and many different kinds of websites. We will use it to run the store. A plugin (Woocommerce) will convert this content management system into a full featured ecommerce store as described below.
The minimum infrastructure to setup this can be purchased at Digital Ocean. You can create your Droplet for Wordpress using an One-click apps image called Wordpress 4.9.1 on 16.04 or higher on the plan described as 1 GB, 1 vCPU, 25 GB, 1 TB - that will costs $5/mo.
WooCommerce is an open-source, completely customizable eCommerce platform for entrepreneurs worldwide. Go beyond the confines of traditional eCommerce solutions, and be limited only by your own imagination.
This is the plugin mentioned above. WooCommerce is widely used and offer a bunch of good quality addons to improve your store.
BTCpay Server will will turn the merchant into a self sovereign one. The merchant (or some merchants who trust themselves) will run a payment gateway and link the store (Wordpress + WooCommerce) to it using a Woocommerce addon plugin from BTCpayServer project.
The minimum infrastructure to setup this can be purchased at Digital Ocean. You can create your Droplet for BTCpay Server (check about BTCpay below) using an One-click apps image called Docker 17.12.0~ce on 16.04 on the plan described as 2 GB, 1 vCPU, 50 GB, 2 TB - that will costs $10/mo.
You will need to prune the bitcoind including a new line with argument prune=2000M at BITCOIN_EXTRA_ARGS in docker-compose.btc-ltc.yml file. Do not prune litecoind.
You can read a lot of additional information about BTCpay Server at The Merchants Guide to accepting Bitcoin directly with no intermediates through BTCPay.
You should follow the BTCPay Server Twitter acoount too.
Add the ability to accept Bitcoin and Litecoin in WooCommerce via BTCpay Server.
This plugin will link BTCpay Server and Wordpress+WooCommerce.
This is a plugin for WooCommerce/Wordpress to display live Litecoin (and Bitcoin/Ethereum) prices in your shop.
This handy plugin will help your customers to know the price in fiat (USD, EUR, BRL...) and BTC or LTC (ETH too but Xadrez do not support this crypto).
You can check our test e-store 9Bravos how it works. You can put a widget anywhere to let people change between Bitcoin or Litecoin or put the price switcher below every price of each product.
Fiat2LTC-WooCommerce will let you show prices in BTC/LTC format or bits/lites format.
Don't forget to disable ETH in Fiat2LTC Price Settings at Wordpress Dashboard.
Electrum is a lightweight Bitcoin wallet.
At this moment Electrum is the best choice of Bitcoin wallet for Xadrez and fulfill all the needs of store manager and the best choice. The addresses generated at invoices will use the Segwit native Bech32 format.
You need to create a new Segwit wallet or just use any you already have and copy the Master Public Key from the menu Wallet > Information and paste it at BTCpay Server at Stores > Settings (if you already added a store) > Add or modify a derivation scheme.
Another change is the gap limit of wallet. The standard gap limit is low but to reach the best peace of mind level we will change it to a higher number like 200. You will need to observe this number because it counts how many unpaid invoices inbetween occurs - if you do not want to pay attention on this details and want to be very sure will not be a problem, set it as 2000.
Go to menu View and be sure the last submenu is Hide console if it isn't click at Show console. Open the Console tab and use the following commands at prompt: wallet.change_gap_limit(200) and press enter at your keyboard, wallet.storage.write() and press enter again.
Electrum-LTC is a simple, but powerful Litecoin wallet. A twelve-word security passphrase (or “seed”) leaves intruders stranded and your peace of mind intact.
Electurm-LTC is a fork of Electrum and handle with Litecoin. At this moment Electrum is the best choice of Litecoin wallet for Xadrez. The addresses generated at invoices will use the Segwit native Bech32 format.
You need to create a Segwit wallet or just use any you already have and copy the Master Public Key from the menu Wallet > Information and paste it at BTCpay Server at Stores > Settings (if you already added a store) > Add or modify a derivation scheme.
Another change is the gap limit of wallet. The standard gap limit is low but to reach the best peace of mind level we will change it to a higher number like 200. You will need to observe this number because it counts how many unpaid invoices inbetween occurs - if you do not want to pay attention on this details and want to be very sure will not be a problem, set it as 2000.
Go to menu View and be sure the last submenu is Hide console if it isn't click at Show console. Open the Console tab and use the following commands at prompt: wallet.change_gap_limit(200) and press enter at your keyboard, wallet.storage.write() and press enter again.
A modern bitcoin wallet hand forged to keep your transactions private, your identity masked, and your funds secure.
Samourai will provide us the Derivation Scheme necessary to inform BTCpay Server. Derivation Scheme will generate different addresses (public keys) to every order at store.
To get the Derivation Scheme - at Samourai Wallet - you need to click upper right icon, choose Settings, Choose Wallets and decide if you want or not to use segwit addresses. Segwit is extremely recommended. Use the Segwit YPUB code at BTCpay Server to generate Segwit addresses which will send the funds to your Samourai wallet.
TODO: Nicolas Dorier, BTCpay Server maintener, was in doubt about the gap limit of Samourai.
Loafwallet is the best standalone Litecoin wallet built for iOS and Android. It is available to download for free on the Apple App Store and Play Store!
Loafwallet will be the best choice for accept LTC in Xadrez setup when archive some requirements as listed:
- Be compatible with segwit (probably at 2.1 version)
- Inform the Derivation Scheme
- Has the a high gap limit of 20 addresses or option to config it