WordPress / WooCommerce

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

Features

• Easy Setup: Install and configure in minutes

• Multiple Tokens: Accept USDT, USDC, and more stablecoins

• 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: Upload via WordPress Admin

1. Download the plugin ZIP file from your MakaPay Dashboard

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 2: Manual Upload via FTP

1. Download the plugin ZIP file from your MakaPay Dashboard

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

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)

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

2. Add a new webhook with URL: https://yourstore.com/wc-api/makapay

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

• Dashboard: app.makapay.io

• Email: [email protected]

Changelog

Version 1.0.0

• Initial release

• Support for WooCommerce checkout

• Multiple token support

• Automatic order status updates