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.

First Method

Second Method

Third 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.

Please refer to the WooCommerce documentation section titled 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.

The following youtube video shows how to manually switch the checkout to the short-code version

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 and uploading it to your web server via your favorite FTP application. The WordPress codex contains instructions on how to do this here.

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 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 plugin.

To setup a recurring payment for a product follow these steps:

• Create one or more Automatic Payment on the 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)