WordPress plugin

Overview

MakePay for WooCommerce lets your store accept crypto payments through the hosted MakePay checkout. Customers choose the MakePay payment method in WooCommerce, are redirected to MakePay to pay, and return to your store after checkout.

The plugin creates a MakePay payment link for each WooCommerce order and listens for signed MakePay webhooks so the WooCommerce order status can update automatically. It supports both classic WooCommerce checkout and WooCommerce Checkout Blocks.

Before you start

You will need:

• WordPress 6.7 or newer
• WooCommerce 10.x
• PHP 7.4 or newer with OpenSSL enabled
• An HTTPS WordPress admin and checkout URL
• A WordPress admin account that can manage WooCommerce
• A MakeCrypto company with MakePay settlement configured

PHP Sodium is recommended. When it is available, the plugin uses it with your WordPress salts to encrypt stored connection and webhook credentials.

Set up MakeCrypto

Complete the merchant setup in MakeCrypto before connecting WooCommerce.

1. Sign in at https://www.makecrypto.io and select the company that should receive WooCommerce payments.
2. Open Wallet > Balances, then choose Set up settlement or Edit settlement. Select the settlement currency, chain, and destination wallet. Save the settlement configuration.
3. Open Merchant > Payment settings. Choose whether payment fees are paid by the merchant or the customer.
4. Review the post-payment redirect settings. WooCommerce sends order-specific return, success, and failure URLs for checkout orders, so most stores can leave the global redirect fields blank unless they want a fallback page.
5. Configure the allowed underpayment rules. A small tolerance can help with network fee and quote variance, while a stricter setting requires the customer to pay the full amount.
6. Optional: open Settings > Merchant to add your merchant name, support email, logo, checkout colors, hosted payment theme, and custom domains.

You do not need to create a developer application for WooCommerce. The official plugin creates a store-specific connection when you click Connect MakePay.

Install the plugin

Download the latest official plugin ZIP:

https://plugins.makecrypto.io/downloads/wordpress/latest.zip

Then install it in WordPress:

1. In WordPress admin, open Plugins > Add New Plugin.
2. Click Upload Plugin and choose the downloaded ZIP file.
3. Click Install Now, then Activate Plugin.
4. Open WooCommerce > Settings > Payments > MakePay.

If WooCommerce is not active, WordPress will show a notice and the gateway will not be available at checkout.

Connect your store

Use Connect MakePay for normal setup. It links this WooCommerce store to the MakeCrypto company you choose and can be disconnected later without changing store code.

1. In WooCommerce > Settings > Payments > MakePay, keep Authentication set to the default connected mode.
2. Keep MakePay portal URL set to https://www.makecrypto.io unless MakePay support asks you to use a different URL.
3. Click Connect MakePay.
4. Sign in to MakeCrypto if prompted, choose the company you prepared, and approve the requested access.
5. After you return to WordPress, confirm that the MakePay settings page says the store is connected and shows the configured webhook secret ending.
6. Enable MakePay payments and click Save changes.

During connection, the plugin automatically registers the store webhook endpoint with MakePay:

https://your-store.example/?wc-api=makecrypto_makepay

Keep this endpoint reachable from the public internet. Security plugins, firewalls, and caching rules should allow POST requests to that URL.

How the connection works

The Connect MakePay button opens MakeCrypto in a browser tab. You sign in, choose the company that should receive payments, review the requested access, and return to WordPress after approval. The plugin then saves the connection, registers the webhook URL, and uses that company for checkout orders.

No shared app secret or developer app setup is required for WooCommerce.

Gateway settings

Review these settings on WooCommerce > Settings > Payments > MakePay.

Setting	What it does
Enable/Disable	Turns the MakePay payment method on or off at checkout.
Title	The payment method name customers see, for example Crypto payment.
Description	The helper text shown under the payment method during checkout.
MakePay portal URL	The MakePay environment. Use https://www.makecrypto.io for production.
Checkout experience	Use Hosted redirect for the most reliable flow, or Embedded checkout page to show MakePay in a secure iframe page with a hosted-link fallback.
Authentication	Use the default connected mode for normal installs. Manual API key fallback is for advanced recovery or support-led setups.
Company ID	Only required for manual API-key mode.
API key ID	Only required for manual API-key mode.
API key secret	Only required for manual API-key mode. Store it carefully because it authorizes API access.
Settlement currency symbol	The preferred settlement symbol for WooCommerce orders, such as USDT. MakePay resolves the chain from your company default when possible.
Payment link expiration	How long the hosted checkout link stays payable. Available options are 15 minutes, 1 hour, 12 hours, 24 hours, and 72 hours.

The settlement currency symbol should match the destination asset you configured in MakeCrypto. If the same symbol is available on multiple chains, MakePay uses your company default chain when it can resolve one.

Test checkout

Run a live checkout test before announcing the new payment method.

1. In WooCommerce, create a small test product or use an existing low-value item.
2. Place an order from the storefront and choose the MakePay payment method.
3. Confirm that WooCommerce opens the selected checkout experience.
4. Complete or cancel the payment.
5. Open the WooCommerce order and check the order notes for MakeCrypto webhook activity.
6. In MakeCrypto, open Merchant > Payments to review the generated payment link and status.

When a payment is created, WooCommerce marks the order as pending with the note Awaiting MakePay payment. Paid or confirmed MakePay statuses mark the order paid. Failed or expired payments mark the order failed. Canceled payments mark the order canceled. Other in-progress webhook updates place the order on hold.

Security and permissions

The WordPress connection requests:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

It cannot send wallet funds or create legacy API keys.

Webhook updates are signed by MakePay and verified by the plugin before any WooCommerce order is changed. Store administrators can revoke the connection in MakeCrypto under Integrations > Connected apps, or disconnect it from the WooCommerce MakePay settings page.

Manual API-key fallback

Use manual API-key mode only if Connect MakePay is unavailable or MakeCrypto support asks you to use it.

1. In MakeCrypto, open Integrations > API Integrations.
2. Create or choose a MakePay API key for the same company that receives store payments.
3. Copy the company ID, API key ID, and API key secret.
4. In WordPress, open WooCommerce > Settings > Payments > MakePay.
5. Set Authentication to Manual API key fallback.
6. Paste the company ID, API key ID, and API key secret, then save changes.

Keep API key secrets out of theme files, client-side scripts, and public support tickets. Connect MakePay is still preferred for normal store operation.

Troubleshooting

If Connect MakePay fails, confirm that your WordPress admin URL uses HTTPS, your store can make outbound HTTPS requests to https://www.makecrypto.io, and your admin session has permission to manage WooCommerce.

If the gateway does not appear at checkout, confirm that the plugin is active, WooCommerce is active, MakePay payments is enabled, and the store is connected to MakePay or has valid manual API-key credentials.

If checkout shows a settlement or onboarding error, return to MakeCrypto and complete Wallet > Balances > Set up settlement for the company connected to the store.

If orders do not update after payment, check Integrations > Webhook requests in MakeCrypto for delivery attempts. The WordPress endpoint should return a 2xx response. Also check that security plugins or hosting firewalls are not blocking POST requests to /?wc-api=makecrypto_makepay.

If you change the store domain, WordPress admin URL, or move the site to a new environment, disconnect and reconnect MakeCrypto so the connection callback and webhook URL match the current store.