For the complete documentation index, see llms.txt. This page is also available as Markdown.

WordPress / WooCommerce

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

Plugin Tutorial

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

  1. Go to WordPress Admin > Plugins > Add New

  2. Search for "MakaPay"

  3. Click Install Now on the MakaPay Payment Gateway plugin

  4. Click Activate Plugin

Method 2: Upload via WordPress Admin

  1. Download the plugin ZIP file from WordPress.org

  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

  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. Create a new API key if you don't have one

  2. 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. Add a new webhook with URL: https://yourstore.com/?wc-api=makapay_webhook

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

Changelog

Version 1.0.0

  • Initial release

  • Support for WooCommerce checkout

  • Multiple token support

  • Automatic order status updates

Last updated