Skip to main content
This guide will walk you through installing the CeyPay WordPress plugin, configuring your credentials, and verifying your setup. You’ll be ready to accept crypto payments in under 10 minutes.

​
What You’ll Need

WordPress 5.8+

With admin access

WooCommerce 7.0+

Installed and active

CeyPay Account

Merchant credentials

​
Installation

Download the latest version of the CeyPay WooCommerce plugin or install directly from WordPress. Choose one of the following methods to install the CeyPay Payment Gateway plugin.
The easiest way to install CeyPay is directly from your WordPress admin panel.
1

Navigate to Plugins

Log in to your WordPress admin dashboard and go to Plugins > Add New.
2

Search for CeyPay

In the search box, type “CeyPay Payment Gateway” and press Enter.
3

Install the Plugin

Click Install Now on the CeyPay Payment Gateway plugin card.
4

Activate

Once installed, click Activate to enable the plugin.

​
Initial Configuration

After activation, you’ll see an admin notice prompting you to complete the setup. This only takes a few minutes!

Access Payment Settings

Navigate to WooCommerce → Settings → Payments in your WordPress admin dashboard.

Enable CeyPay

Find CeyPay in the list of available payment methods. Toggle the switch to enable it, then click Manage or click the gateway name.

Enter Your Credentials

Fill in the required fields:
​
Merchant ID
string
required
Your unique merchant identifier from the CeyPay dashboard. Example: MERCH-123456
​
Webhook Secret
string
required
The secret key used to verify webhook signatures. Found in your CeyPay dashboard under Settings → API Settings. Keep this secure!

Save Changes

Click Save changes at the bottom of the page to apply your configuration.
Success! Once configured, CeyPay will appear as a payment option on your checkout page. Customers can now pay with Bybit, Binance Pay, or KuCoin.

​
Get Your API Credentials

Don’t have a CeyPay account yet? You can apply for a merchant account in minutes and get instant access to test mode credentials.

Create a CeyPay Account

Visit merchant.ceypay.io and sign up for a merchant account. You’ll receive test credentials immediately.

Complete Verification

Complete the merchant verification process to unlock production access and real payment processing.

Access API Settings

In your CeyPay dashboard, navigate to Settings → API Settings or Integration section.

Copy Credentials

Copy your Merchant ID and Webhook Secret. Keep these secure—they’re used to authenticate API requests.
Your webhook secret should be treated like a password. Never share it publicly or commit it to version control.

​
Verify Your Setup

Always test your integration before going live. Test mode lets you simulate the complete payment flow without processing real transactions.

Enable Test Mode

In the CeyPay settings (WooCommerce → Settings → Payments → CeyPay), check Enable Test Mode. This allows you to test without real transactions.

Place a Test Order

Add a product to your cart and proceed to checkout. Select CeyPay as the payment method.

Complete the Flow

After clicking “Place Order”, the payment modal should appear with QR codes for Bybit, Binance Pay, and KuCoin. In test mode, you’ll see a “Simulate Success” button.

Verify Order Status

Click the simulate button and confirm the order is marked as “Processing” or “Completed” in WooCommerce → Orders.
Remember to disable Test Mode before accepting real payments! Test Mode is only visible to administrators and prevents actual payment processing.
Check that:
  • JavaScript is enabled in your browser
  • Your theme is not blocking modal overlays
  • There are no JavaScript errors in the browser console (F12 → Console)
  • The plugin is activated and WooCommerce is working properly
Test mode simulates the payment flow without requiring real wallets. To test with actual Bybit, Binance Pay, or KuCoin accounts, disable test mode and use small amounts. Make sure you’re in a test environment before processing real payments.
A successful test confirms that:
  • The plugin is installed and activated correctly
  • Your API credentials are valid
  • Webhooks are configured properly (if using real mode)
  • WooCommerce can process orders through CeyPay
You’re ready to accept real crypto payments!

​
You’re All Set! 🎉

Congratulations! You’ve successfully installed and configured the CeyPay WordPress plugin. Your store is now ready to accept cryptocurrency payments from Bybit, Binance Pay, and KuCoin.

​
Next Steps

Configuration

Explore all available settings and customize the checkout experience.

Testing Guide

Learn how to thoroughly test your integration before going live.

Webhooks

Understand how webhooks work and verify they’re configured correctly.

Troubleshooting

Common issues and solutions to keep your integration running smoothly.

​
Need Help?

Contact Support

Our support team is here to help with any questions.

Join Community

Connect with other merchants on Telegram.