Configuration

Access CeyPay settings by navigating to WooCommerce > Settings > Payments > CeyPay in your WordPress admin.

General Settings

Enable/Disable

checkbox

default:"enabled"

Controls whether CeyPay appears as a payment option at checkout. When disabled, customers will not see CeyPay as a payment method.

Description

textarea

default:"Pay securely using your preferred platform."

The text displayed to customers when they select CeyPay at checkout. Use this to explain the payment process or highlight benefits.Example descriptions:

“Pay with crypto using Bybit, Binance Pay, or KuCoin”
“Secure cryptocurrency payment - no fees for customers”

API Credentials

These credentials connect your WooCommerce store to the CeyPay payment network. Both fields are required for the gateway to function.

Merchant ID

text

required

Your unique merchant identifier provided by CeyPay. This ID links transactions to your merchant account.Where to find it: Log in to your CeyPay Dashboard and navigate to Settings > API Credentials.

Webhook Secret

password

required

A secret key used to verify that incoming webhook notifications are genuinely from CeyPay. This prevents fraudulent payment confirmations.Security Note: Keep this value secret. Never share it publicly or commit it to version control.

If either Merchant ID or Webhook Secret is missing, an “Action Needed” badge will appear next to CeyPay in the payment methods list, and an admin notice will prompt you to complete the configuration.

Test Mode

Test Mode allows you to verify your integration without processing real transactions.

Enable Test Mode

checkbox

default:"disabled"

When enabled, CeyPay uses a test API endpoint instead of the production server. This allows you to simulate the entire payment flow.

Test Mode Behavior

When Test Mode is active:

Feature	Behavior
API Endpoint	Connects to the CeyPay test server
Visibility	Only administrators can see CeyPay at checkout
Simulation	A “Simulate Success” button appears in the payment modal
Logging	Debug information is written to WooCommerce logs

Test Mode uses a predefined webhook secret (mock_secret_key) for signature verification, so you don’t need to configure separate test credentials.

Supported Providers

CeyPay supports the following cryptocurrency payment providers:

Customers select their preferred provider in the payment modal after clicking “Place Order”. Each provider generates a unique QR code that can be scanned with the corresponding wallet app.

Checkout Experience

Classic Checkout

On the traditional WooCommerce checkout page, CeyPay displays:

Gateway Title - Shown as a logo for better brand recognition
Description - Your configured description text
Provider Selection - Presented in a modal after order placement

WooCommerce Blocks Checkout

CeyPay fully supports the modern WooCommerce Blocks checkout:

Seamless integration with the block-based checkout editor
Same modal-based provider selection flow
Full support for the Checkout Block and Cart Block

If using WooCommerce Blocks, ensure your theme and other plugins are compatible with the Blocks checkout for the best experience.

Order Processing

Payment Flow

Order Statuses

Status	When Applied
Pending Payment	Order created, awaiting provider selection
Processing	Payment confirmed via webhook or polling
Completed	Order fulfilled (depends on your WooCommerce settings)
Failed	Payment expired or was declined

Webhook URL

CeyPay sends payment notifications to your store’s webhook endpoint. This URL is automatically configured and follows the pattern:

https://yoursite.com/?wc-api=WC_Gateway_CeyPay

You don’t need to manually configure this URL. WooCommerce handles it automatically. Just ensure your site is accessible from the internet.

Getting Started

Integrations

Resources

General Settings

API Credentials