# Woocommerce
The WooCommerce 8Pay Payment Gateway plugin allows merchants to receive crypto payments on their stores.
## Ensure Compatibility with WooCommerce 8.3+
As of WooCommerce version 8.3, the default checkout experience has shifted from classic shortcodes to a new block-based checkout. To continue using the plugin , you must switch the checkout back to the classic shortcode.
> ***Leaving the default block-based checkout experience will result in a payment method not being detected it***** ****will result in the checkout page displaying an error message stating,**** ****“There are no payment methods available.”**
We will provide three methods to ensure that you are utilizing the Classic Cart and Checkout.
{% tabs %}
{% tab title="First Method" %}
From your wordpress admin page go to **Pages -> All Pages**, and then locate and edit the **Cart/Checkout** page.
1. Click to the **Document Overview**
2. Click on **Checkout** under the **List View** 
3. Click on **Checkout Totals** 
4. Click on Switch to classic Checkout
Please refer to the attached screenshot for a comprehensive overview of all the steps involved.
{% endtab %}
{% tab title="Second Method" %}
> *Please refer to the WooCommerce documentation section titled* [*Reverting to the Classic Cart and Checkout*](https://woocommerce.com/document/woocommerce-store-editing/customizing-cart-and-checkout/#reverting-to-the-classic-cart-and-checkout)
1. **If using a block theme**: Go to **Appearance -> Editor -> Pages ->** Select Cart or Checkout -> click the *Edit icon*\
**localIf using a non-block theme**: Go to ***Pages -> All Pages***, and then locate and edit the Cart/Checkout page.
2. Open the List View and select the Cart or Checkout block.
3. Click the “**Transform**” button, which is leftmost in the block toolbar
4. Choose “**Classic Shortcode**”.
5. The block will be transformed into a Classic Shortcode placeholder block.
6. Save your changes by clicking the Save button in the top bar.
{% endtab %}
{% tab title="Third Method" %}
> The following youtube video shows how to manually switch the checkout to the short-code version
{% embed url="" %}
{% endtab %}
{% endtabs %}
## Installation
#### Automatic installation
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of the 8Pay Payment Gateway plugin, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.
In the search field type “8Pay Payment Gateway” and click Search Plugins. Once you’ve found our plugin you can view details about it such as the point release, rating, and description. Most importantly, of course, you can install it by simply clicking "Install Now", then "Activate".
#### Manual installation
The manual installation method involves downloading our plugin from [here](https://it.wordpress.org/plugins/8pay-payment-gateway/) and uploading it to your web server via your favorite FTP application. The WordPress codex contains instructions on how to do this [here](http://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).
## Setup
### One-Time Payment
Navigate to the "Plugin" menu and click on "Settings" in the 8Pay Payment Gateway row.
Fill the following fields:
* Description: the payment method description visible on the checkout page
* API Key: the api key generated from the [API keys](https://app.8pay.network/keys) section of the web app
* Tokens: the tokens available at checkout
* Receiver: the blockchain address where payments will be received
### Recurring Payments
The plugin also supports recurring payment on subscription products created with the [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) plugin.
To setup a recurring payment for a product follow these steps:
* Create one or more Automatic Payment on the [Payments](https://app.8pay.network/payments) section of the web-app
* Go to the WooCommerce "Products" section
* Click on your subscription product
* Scroll down to the product data section and select "Attributes"
* Add a new attribute "8pay\_plan\_ids" containing a comma separated list of plan ids that you want to associate to the product (up to one per chain)
2. Click on **Checkout** under the **List View** 
3. Click on **Checkout Totals** 
4. Click on Switch to classic Checkout
Please refer to the attached screenshot for a comprehensive overview of all the steps involved.
