# WordPress / WooCommerce

Accept cryptocurrency payments on your WooCommerce store with the official MakaPay plugin.

{% embed url="<https://youtu.be/TzidhW1F25M>" %}
Plugin Tutorial
{% endembed %}

## Features

* **Easy Setup**: Install and configure in minutes
* **Multiple Tokens**: Accept USDT, USDC, and more stablecoins
* **Native Token Support**: Accept ETH, BNB, MATIC and other native chain currencies
* **Auto Confirmation**: Orders update automatically when payment is confirmed
* **Multi-Network**: Support for MakaChain and other EVM networks
* **Secure**: Direct wallet-to-wallet payments with no intermediaries

## Requirements

* WordPress 5.0 or higher
* WooCommerce 5.0 or higher
* PHP 7.4 or higher
* SSL certificate (HTTPS) - required for secure API communication

## Installation

### Method 1: Install from WordPress Plugin Directory (Recommended)

1. Go to **WordPress Admin > Plugins > Add New**
2. Search for **"MakaPay"**
3. Click **Install Now** on the [MakaPay Payment Gateway](https://wordpress.org/plugins/makapay-payment-gateway/) plugin
4. Click **Activate Plugin**

### Method 2: Upload via WordPress Admin

1. Download the plugin ZIP file from [WordPress.org](https://wordpress.org/plugins/makapay-payment-gateway/)
2. Go to **WordPress Admin > Plugins > Add New > Upload Plugin**
3. Choose the downloaded ZIP file and click **Install Now**
4. Click **Activate Plugin**

### Method 3: Manual Upload via FTP

1. Download the plugin ZIP file from [WordPress.org](https://wordpress.org/plugins/makapay-payment-gateway/)
2. Extract the ZIP file
3. Upload the `makapay-payment-gateway` folder to `/wp-content/plugins/`
4. Go to **WordPress Admin > Plugins**
5. Find "MakaPay Payment Gateway" and click **Activate**

## Configuration

### Step 1: Access Payment Settings

1. Go to **WooCommerce > Settings > Payments**
2. Find "MakaPay" in the payment methods list
3. Click **Manage** to configure settings

### Step 2: Enable the Payment Method

1. Check the **Enable MakaPay** checkbox
2. Set a custom **Title** (shown to customers at checkout)
3. Set a custom **Description** (optional)

### Step 3: Enter API Credentials

1. Go to your [MakaPay Dashboard > API Keys](https://app.makapay.io/dashboard/api-keys)
2. Create a new API key if you don't have one
3. Copy the API key and paste it in the **API Key** field

### Step 4: Configure Payment Settings

1. **Merchant Wallet Address**: Enter the wallet address where you want to receive payments
2. **Network**: Select your preferred blockchain network (e.g., MakaChain)
3. **Token**: Select the token you want to accept (e.g., USDT, USDC). You can also select native tokens like ETH, BNB, or MATIC — these use the zero address (`0x0000000000000000000000000000000000000000`) internally.

### Step 5: Save and Test

1. Click **Save changes**
2. Place a test order on your store to verify the integration works correctly

## How It Works

1. Customer selects MakaPay at checkout
2. Customer is redirected to the MakaPay payment page
3. Customer pays with their crypto wallet
4. MakaPay confirms the payment on-chain
5. Order status updates automatically to "Processing"
6. You receive funds directly in your merchant wallet

## Webhook Configuration (Optional)

For instant order updates, configure webhooks:

1. Go to your [MakaPay Dashboard > Webhooks](https://app.makapay.io/dashboard/webhooks)
2. Add a new webhook with URL: `https://yourstore.com/?wc-api=makapay_webhook`
3. Select the events you want to receive (e.g., `payment.completed`)

## Troubleshooting

### Payment not showing at checkout

* Verify the plugin is activated
* Check that WooCommerce is installed and active
* Ensure the payment method is enabled in WooCommerce settings

### API connection errors

* Verify your API key is correct and active
* Ensure your site has a valid SSL certificate (HTTPS)
* Check that your server can make outbound HTTPS requests

### Orders not updating after payment

* Configure webhooks as described above
* Check your server's error logs for webhook delivery issues
* Verify your webhook URL is publicly accessible

## Support

* **Documentation**: [docs.makapay.io](https://docs.makapay.io)
* **Dashboard**: [app.makapay.io](https://app.makapay.io)
* **Email**: <support@makapay.io>

## Changelog

### Version 1.0.0

* Initial release
* Support for WooCommerce checkout
* Multiple token support
* Automatic order status updates


---

# 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://docs.makapay.io/plugins/wordpress-plugin.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.