# WooCommerce

## 1. Installing the Copperx Plugin

* In your WordPress dashboard, Choose **`Plugins > Add New`**.
* Search for "Copperx Payment Gateway for WooCommerce" and select the official plugin from Copperx.
* Click **`Install Now`**.
* Once installed, click **`Activate`** to use the plugin.

## **2. Creating a Copperx Account**

* If you haven't already, sign up for a Copperx account.
* Follow the onboarding process:
  * Add your business details.
  * Upload your company's logo and brand colors.
  * Configure wallet addresses for supported cryptocurrencies: Ethereum, Polygon, Solana, and BNB chain.

## **3. Linking to Copperx and Configuring the Plugin**

* In the WordPress admin area, navigate to **`WooCommerce > Settings > Payments`**.
* Locate "Copperx" in the list of available payment gateways.
* Click on the **`Manage`** button alongside Copperx.
* This will direct you to the plugin settings page for further configurations.

## **4. Adding the API Key**

* In your Copperx dashboard, navigate to the **`Developer > API keys`** section.
* Click on "Generate API Key" to produce a unique key that will link your WooCommerce store to your Copperx account.
* Copy the generated API key.
* Return to your WordPress plugin settings and paste the API key into the designated field.

## **5. Setting Up Webhooks**

* In Copperx, navigate to the `**Developer > Webhooks**`
* Under webhook configurations or similar, select **`Add endpoint`**, and insert the URL provided in your WooCommerce plugin settings page.
* Ensure you copy and input any shared secret or additional authentication details as required in the plugin settings to ensure secure communication between Copperx and your WooCommerce store.

## **Testing Integration with Test Mode**

Before fully integrating Copperx crypto payments into your WooCommerce store, utilizing the Test Mode is recommended to ensure smooth and accurate transactions.

### **Steps to Enable Test Mode:**

**Important Note:** Ensure to use the Test Secret Key from [**dashboard.copperx.dev**](http://dashboard.copperx.dev/) for activating Test Mode. This specialized test mode not only ensures a secure and isolated environment for your test transactions but also allows you to view and verify all test payments distinctly from your live mode operations, maintaining a clean and safe separation.

1. **Access WooCommerce Dashboard**:
   * Navigate to **`Payments > Settings`**.
2. **Activate Copperx Test Mode**:
   * Find Copperx in the available payment gateways list.
   * Click on the **`Manage`** button to access its settings.
   * Activate the 'Test Mode' option from the settings.
3. **Retrieve Test Secret Key from Copperx**:

* Navigate to **`Developer > Generate Key`** within your Copperx dev dashboard and copy the 'Test Secret Key'.
* Return to the WooCommerce Copperx settings and paste the key into the designated field.

**Note:** Always obtain the Test Secret Key from [**dashboard.copperx.dev**](http://dashboard.copperx.dev/) to ensure secure and accurate testing.

1. **Perform Test Transactions**:
   * Using the [Copperx faucet](https://dashboard.copperx.dev/faucet), acquire test tokens (e.g., USDC).
   * Initiate test transactions in your WooCommerce store using these tokens.
2. **Verify Transactions**:
   * After conducting test transactions, confirm that the funds reflect correctly in your test wallet.

**Note**: Always ensure you switch off 'Test Mode' and use the live API key when you're ready to accept real crypto payments.

***

**Further Resources**:

* [How to generate an API Key](https://docs.copperx.io/how-to-generate-an-api-key)
* [How to setup a Webhook](https://docs.copperx.io/webhook/how-to-setup-a-webhook)
* [Accept your first payment](https://docs.copperx.io/examples/accept-your-first-payment)

For any queries or assistance, the Copperx support team is available to guide you every step of the way.