=== Coinsnap for WooCommerce ===
Contributors: coinsnap
Tags: Lightning, SATS, bitcoin, WooCommerce, payment gateway
Requires at least: 5.2
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.1.6
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Coinsnap payment plug-in is intended for online stores based on WooCommerce to accept Bitcoin and Lightning payments via Coinsnap payment gateway.

== Description ==

* WooCommerce Coinsnap Demo Store: https://woocommerce.coinsnap.org/
* Blog Article: https://coinsnap.io/en/coinsnap-for-woocommerce-plugin/
* WordPress: https://wordpress.org/plugins/coinsnap-for-woocommerce/
* GitHub: https://github.com/Coinsnap/Coinsnap-for-Woocommerce

[Coinsnap](https://coinsnap.io/en/) for WooCommerce allows you to process Bitcoin Lightning payments over the Lightning network in your WooCommerce online shop. 
With the Coinsnap Bitcoin-Lightning payment plugin for WooCommerce you only need a Lightning wallet with a Lightning address to accept Bitcoin Lightning payments in your WooCommerce online store.

Coinsnap’s payment plugin for WooCommerce makes it amazingly simple for your customers to purchase your offerings with Bitcoin-Lightning: They can make their transactions with just a scan of the QR code generated by the Coinsnap plugin for WooCommerce, and the authorization of the payment. 
When authorized, the payment will be credited to your Lightning wallet in real time.


= Bitcoin and Lightning payments in your WooCommerce store with Coinsnap =

With Coinsnap payment processing, you can accept Bitcoin and Lightning payments on your website or online store. You don’t need your own Lightning Node or other technical requirements.

Bitcoin and Lightning payments from your customers will be credited directly to your own Lightning address.

With Coinsnap Payment Plugin you can integrate Bitcoin and Lightning payments into your website or online store without any technical effort.

Simply register in [Coinsnap](https://app.coinsnap.io/), enter your own Lightning address and your customers can pay you with Bitcoin and Lightning.


= Features: =

* **All you need is a Lightning Wallet with a Lightning address. [Here you can find an overview of the matching Lightning Wallets](https://coinsnap.io/en/lightning-wallet-with-lightning-address/)**

* **Accept Bitcoin and Lightning payments** in your online store **without running your own technical infrastructure.** You do not need your own server, nor do you need to run your own Lightning Node.

* **Quick and easy registration at Coinsnap**: Just enter your email address and your Lightning address – and you are ready to integrate the payment module and start selling for Bitcoin Lightning. You will find the necessary IDs and Keys here, too.

* **100% protected privacy**:
    * We do not collect personal data.
    * For the registration you only need an e-mail address, which we will also use to inform you when we have received a payment.
    * No other personal information is required as long as you request a withdrawal to a Lightning address or Bitcoin address.

* **Only 1 % fees!**:
    * No basic fee, no transaction fee, only 1% on the invoice amount with referrer code.
    * Without referrer code the fee is 1.25%.
    * Get a referrer code from our partners and customers and save 0.25% fee.

* **No KYC needed**:
    * Direct, P2P payments (instantly to your Lightning wallet)
    * No intermediaries and paperwork
    * Transaction information is only shared between you and your customer

* **Sophisticated merchant’s admin dashboard in Coinsnap:**:
    * See all your transactions at a glance
    * Follow-up on individual payments
    * See issues with payments
    * Export reports

* **A Bitcoin payment via Lightning offers significant advantages**:
    * Lightning **payments are executed immediately.**
    * Lightning **payments are credited directly to the recipient.**
    * Lightning **payments are inexpensive.**
    * Lightning **payments are guaranteed.** No chargeback risk for the merchant.
    * Lightning **payments can be used worldwide.**
    * Lightning **payments are perfect for micropayments.**

* **Multilingual interface and support**: We speak your language


= Documentation: =

* [Coinsnap API (1.0) documentation](https://docs.coinsnap.io/)
* [Frequently Asked Questions](https://coinsnap.io/en/faq/) 
* [Terms and Conditions](https://coinsnap.io/en/general-terms-and-conditions/)
* [Privacy Policy](https://coinsnap.io/en/privacy/)


== Installation ==

### 1.1 Install the Coinsnap WooCommerce plugin from the WordPress directory ###

The Coinsnap WooCommerce plugin can be searched and installed in the WordPress plugin directory.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-1.jpg)

You can easily find the Coinsnap for Woocommerce plugin under Plugins/Install new plugin if you enter Coinsnap in the search field. Simply click on the Coinsnap plugin and WordPress will install it for you.

Then you can continue with point 2 Connect Coinsnap with WooCommerce plugin

### 1.2. Install the Coinsnap WooCommerce plugin from Github page ###

If you don’t want to install Coinsnap WooCommerce plugin directly via plugin, you can download Coinsnap WooCommerce plugin from Coinsnap Github page here.
Find the green button labeled Code. When you click on it, the menu opens and Download ZIP appears. Here you can download the latest version of the Coinsnap plugin to your computer.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-2.jpg)

Then use the “Upload plugin” function to install it. Click on “Install now” and the Coinsnap for WooCommerce plugin will be added to your WordPress website. It can then be connected to the Coinsnap payment gateway.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-3.jpg)

As soon as the Coinsnap for WooCommerce plugin is installed and activated, a message will appear asking you to configure the plugin settings.

# 2. Connect Coinsnap account with WooCommerce plugin #

### 2.1. WooCommerce Coinsnap Settings ###

After you have installed and activated the Coinsnap for WooCommerce plugin, you need to make the Coinsnap settings. You can access this area via WooCommerce and Settings. On the far right you will find Coinsnap Settings.
![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-4.png)

After clicking on the link provided or going to the Coinsnap settings tab, a form will appear asking you for your Coinsnap Store ID and your Coinsnap API key.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-5.png)

These details are provided via your Coinsnap account in the store settings section. If you do not yet have a Coinsnap account, you can register under the following link: [Coinsnap registration](https://app.coinsnap.io/register).

### 2.1.1. Coinsnap Store Settings needed for configuration ###

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-6.png)

Go to the Settings menu item in the Coinsnap backend. There you will find the Coinsnap Store ID and the Coinsnap API Key in the Store Settings section.

Click on the “Save changes” button at the bottom of the page to apply and save the settings.

### 3. WooCommerce payment settings ###

Navigate to the Payment tab under the WooCommerce settings to see a list of all available payment methods. Coinsnap is shown at the end of the list.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-7.png)

##### (1) Activate Coinsnap #####
You must activate Coinsnap as a payment option.

##### (2) Additional configurations #####
To do this, click on the “End setup” or “Manage” button.

--------------------------------------------------------------------------------------------------
Adjustments can be made here, which are displayed to the customer during the payment process.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-8.png)

##### (1) Title field #####
In the Title field, for example, you can specify that you accept “Bitcoin and Lightning”.

##### (2) Notes field #####
A note can also be entered in the Customer message field to inform the payer of the next steps.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-9.png)

##### (3) Gateway symbol #####
By selecting the “Upload or select icon” button, you have the option of adding a personalized icon or image that symbolizes a payment gateway or payment method for your online store. This image serves as a visual indicator for a specific payment option or gateway that is displayed to the customer at the time of checkout.

##### (4) Enforce payment coins #####
Enforce payment tokens refers to a system setting that ensures that only certain types of tokens are accepted for a specific payment method or gateway. This ensures that promotional tokens (which may represent discounts, special offers or other non-traditional forms of payment) are not mistakenly processed as regular payment tokens within this gateway.

### 4. Test the payment in the WooCommerce store ###

After all settings have been made, a test transaction should be carried out.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-10.png)

Place an order in your WooCommerce online store and search for Bitcoin and Lightning Payment among the available payment options. Choose this method and click on Pay with Bitcoin.
You will be redirected to the Bitcoin-Lightning payment page to complete the purchase.

![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-11.png)
![](https://ps.w.org/coinsnap-for-woocommerce/assets/screenshot-12.png)

The Bitcoin payment page is now displayed and offers the payer the option of paying with Bitcoin or Lightning. Both methods are integrated in the displayed QR code. After successful payment, the invoice can be viewed in detail.

== Upgrade Notice ==

Follow updates on plugin's GitHub page:
https://github.com/Coinsnap/coinsnap-woocommerce/

== Frequently Asked Questions ==

Plugin's page on Coinsnap website: https://coinsnap.io/en/coinsnap-woocommerce-plugin/

== Screenshots ==

1. Plugin installation from WordPress plugin directory
2. Plugin downloading from Github repository
3. Manual plugin installation
4. Connect website with Coinsnap
5. Store settings
6. Coinsnap Website ID and APIKey
7. WooCommerce payment settings
8. Coinsnap Woocommerce payment fields 
9. Custom gateway icon
10. Checkout page
11. QR code on the Bitcoin payment page
12. Invoice is paid

== Changelog ==
= 1.0.0 :: 2023-08-03 =
* First public release for testing.

= 1.0.5 :: 2023-12-12 =
* Payment button text setting is added.

= 1.1.0 :: 2024-02-28 =
* Basic Wordpress Blocks support is added.

= 1.1.1 :: 2024-03-22 =
* Restructured loader.

= 1.1.2 :: 2024-05-08 =
* Payment status display update.
* Fix: Payment status changing.

= 1.1.3 :: 2024-07-03 =
* Order number and order ID separation.
* Full order metadata array transmission.

= 1.1.4 :: 2024-10-03 =
* Wordpress library update.
* Data output security update.
* Compatibility with WooCommerce 9.3.x. is tested
* Fix: order ID variable type is ?string.

= 1.1.5 :: 2024-10-11 =
* Wordpress library update.
* Fixed error on checkout.

= 1.1.6 :: 2024-11-06 =
* Coinsnap connection errors exception update.
* Update of Coinsnap gateway icon upload functionality.
* Update of payment method name by default (Bitcoin-Lightning)

