# Installation

Welcome to the installation guide for CryptoPay! Before we dive into the installation process, it's important to understand the necessary steps to get started with our plugin. In this guide, we will walk you through the entire installation process to ensure a smooth and easy setup.

As BeycanPress, we recommend that you use our product on non-shared VPS, VDS or hosting. Because in shared hosting, service providers can restrict many PHP methods.

### Requirements

* PHP 8.1+
* WordPress 5.0+
* WooCommerce 4.4+ (Optional: if you want using with WooCommerce)

### Start install

### 0 - Preliminary information

The Lite and Premium versions have some necessary PHP extensions for the plugin to work. For example, Ioncube is not required for the Lite version. However, requirements such as **BCMath**, **GMP**, **cURL** are included in the paid and free version.

Therefore, when you activate the plugin after step 4. If you get warnings like CryptoPay is disabled **"because x extension was not found".** <mark style="color:green;">**These are not errors**</mark>. If you read the warnings you are already told what to do.

### 1 - Download zip file

After purchasing the product, download the ".zip" file from the downloads section.

<figure><img src="/files/PNzno2aKE0wZgPa3QdSY" alt=""><figcaption></figcaption></figure>

### 2 - Upload zip

IF YOU PURCHASED THE PLUGIN FROM CODECANYON, UPLOAD THE ACTUAL PLUGIN ZIP FILE CONTAINED WITHIN THE ZIP FILE YOU DOWNLOADED

Then click on plugins and add new from the WordPress wp-admin menu. Then click on the upload plugin button and then click on the select plugin button in the opened section and install the plugin. Then click the download now button.

<figure><img src="/files/DtWgt80EWmxfSan3XtJk" alt=""><figcaption></figcaption></figure>

### 4 - Activate

After waiting for a while, the plugin installation will be completed. If you get a warning about the size. Please increase the upload limit with the "Wp Maximum Upload File Size" plugin. If this limit is set low on hosting, please contact your hosting provider and ask to increase it.

After the installation is complete, activate the plugin with the activate plugin button.

<figure><img src="/files/1mI0WNwxPgpHIrzGuAYu" alt=""><figcaption></figcaption></figure>

### 5 - First adjustments

When you activate the plugin, you will receive two warnings as follows. 1st warning is only in premium version.

<figure><img src="/files/oaTU8AYdHv7VYKLXrHRv" alt=""><figcaption></figcaption></figure>

### 6 - License process (**Just for premium version**)

To solve the 1st warning, enter the license code given to you after the purchase in the license section of the settings under CryptoPay in the menu as follows.&#x20;

You can access all your licenses on the "<https://beycanpress.com/my-account/my-licenses/>" page.

Please read the relevant explanations in detail when starting your license.

<figure><img src="/files/bz85oX3NqsDeSnxz3qjK" alt=""><figcaption></figcaption></figure>

### 7 - Wallet address entry

To solve the second warning, enter the EVM-based, that is, MetaMask or TrustWallet address after purchase, into the wallet address section of the EvmBased settings under CryptoPay in the menu as follows.

<figure><img src="/files/cZc3IAEeNpvMpPBKWQ5J" alt=""><figcaption></figcaption></figure>

### 8 - First adjustments complete

When you complete the above steps, the warnings will be removed as you can see in the picture below. Now it's time to enable Payment Gateway to receive payments via WooCommerce.

<figure><img src="/files/CCVZbszUmUvM1h7DGY5U" alt=""><figcaption></figcaption></figure>

### 9 - Activate WooCommerce gateway

All you have to do is come to WooCommerce - Settings - Payments page as in the picture below and activate CryptoPay Payment Gateway. You are now ready to use CryptoPay and get paid in your WooCommerce store.

<mark style="color:green;">**NOTE:**</mark>**&#x20;If you are going to use CryptoPay with a plugin other than WooCommerce. There should be a section in the settings section of the relevant plugin like WooCommerce and you need to activate CryptoPay from there.**

<figure><img src="/files/ntnfYTuACYifLcXacpUx" alt=""><figcaption></figcaption></figure>

### 10 - Reown Project ID (formerly WalletConnect)

The WalletConnect Project ID is required for the operation of the Web3Modal option, which makes it easy for users to connect to CryptoPay from mobile devices and provides support for 300+ wallets for Web3Modal and EVM-based networks, as well as the WalletConnect option you may see on some other networks.

You can obtain a WalletConnect Project ID by following the steps below.

#### Register to WalletConnect Cloud

Open the general settings and follow the link in the settings to get a WalletConnect Project ID and license code

Get a project ID by signing up for WalletConnect Cloud with your wallet address or email as shown in the image below.

<figure><img src="/files/Ulh9S3wvmeZy0R4Q4ykC" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/kmG9IOhzr1XGoDrrNJe8" alt=""><figcaption></figcaption></figure>

#### Create a project

To create a project id, just follow the pictures below. After entering the name and URL of your site, select AppKit and select JavaScript in the platform section, then copy your project id by scrolling down on the page that opens.

You can then copy your project id from the relevant field and add it to CryptoPay settings. You can do or not do other processes such as domain verification etc. according to your own wishes.

<figure><img src="/files/YCi8dHv8pot1cPAEuJpz" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PHJPHwM7SznBRgTDva5e" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ZM7c4yYM3aMbVnJGSE0n" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/6bo2ThCdAN11zOD06JVK" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/kMNh0b2c3Sq5NTmg1lUp" alt=""><figcaption></figcaption></figure>

### 11 - Information

As the last item, let's briefly talk about the installation of other add-ons. All add-ons are installed as classic WordPress plugin installation as described in the first 4 items. Converter add-ons are listed in the Converter API field under CryptoPay - Settings - API's. Network support add-ons will appear at the bottom of the EVM Based settings page when you install them.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://beycanpress.gitbook.io/cryptopay-docs/overview/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.