WooCommerce Plugin Documentation
Version 1.0.44 Released: Jan 20, 2026

Overview

New to Nexzoneo Pay? Start by creating a merchant account at payment.nexzoneo.com to get your API credentials.

The Nexzoneo Pay WooCommerce plugin seamlessly integrates secure payment processing into your WordPress store, allowing you to accept credit cards, debit cards, and cryptocurrency payments.

Secure & Compliant

PCI-DSS compliant payment processing with enterprise-grade security.

Fast Setup

Get started in minutes with our simple installation and configuration process.

Multiple Payment Methods

Accept credit/debit cards and cryptocurrency in one unified solution.

Features

Payment Features

  • Credit & debit card processing
  • Cryptocurrency payments (Bitcoin, Ethereum, USDT, etc.)
  • Automatic payment status updates
  • Refund support through WooCommerce
  • Real-time transaction notifications
  • Multi-currency support

Technical Features

  • WooCommerce Blocks compatible
  • HPOS (High-Performance Order Storage) support
  • WordPress Site Health integration
  • Comprehensive debug logging
  • Webhook integration for real-time updates
  • Secure API key management
New in v1.0.44: Removed WooCommerce.com dependency. Plugin settings now accessible for all merchants without requiring connection to WooCommerce.com.

Requirements

Server Requirements
PHP Version: 7.4 or higher (8.1+ recommended)
WordPress: 5.8 or higher
WooCommerce: 5.0 or higher (tested up to 10.1.2)
SSL Certificate: Required (HTTPS)
Account Requirements
  • Active Nexzoneo merchant account
  • Site Key, Security Token, and Webhook Secret
  • Webhook URL configured
  • Valid business documentation (for live mode)
Don't have an account? Sign up here

Installation

Before you begin: Ensure you have a backup of your site and have met all the requirements listed above.

Method 1: Upload via WordPress Admin (Recommended)

1
Download the Plugin

Visit the plugin download page and download the latest version (.zip file).

Current Version: woocommerce-gateway-nexzoneo-1.0.44.zip
2
Upload to WordPress
  1. Log in to your WordPress admin panel
  2. Navigate to Plugins → Add New
  3. Click Upload Plugin button at the top
  4. Click Choose File and select the downloaded .zip file
  5. Click Install Now
Upload Plugin
3
Activate the Plugin

Once the installation is complete, click Activate Plugin.

The plugin is now installed and ready to be configured!

Method 2: Manual FTP Installation

1
Extract the Plugin

Extract the downloaded .zip file on your computer.

2
Upload via FTP

Upload the extracted folder to /wp-content/plugins/ directory on your server.

wp-content/
└── plugins/
    └── woocommerce-gateway-nexzoneo/
        ├── class-nexzoneo-api.php
        ├── class-nexzoneo-gateway.php
        └── woocommerce-gateway-nexzoneo.php
3
Activate in WordPress

Go to Plugins → Installed Plugins and activate "WooCommerce Gateway Nexzoneo Pay".

Configuration

After activation, configure the plugin to connect with your Nexzoneo merchant account.

1
Navigate to Payment Settings

Go to WooCommerce → Settings → Payments

WooCommerce Payments
2
Enable Nexzoneo Pay

Find "Nexzoneo Pay" in the list of payment methods and toggle it to Enabled.

3
Configure Settings

Click Manage or Set up to access the configuration page.

Setting Description Required
Enable/Disable Enable Nexzoneo Pay as a payment method Yes
Title Payment method name shown to customers (e.g., "Credit Card" or "Pay with Card") Yes
Description Message shown to customers during checkout Optional
Site Key Your Nexzoneo site key (starts with site_) Yes
Security Token Your Nexzoneo security token (starts with sec_) Yes
Test Mode Enable for testing, disable for live transactions Optional
Debug Mode Enable detailed logging for troubleshooting Optional
Tip: Use descriptive titles like "Credit/Debit Card" or "Secure Payment" to build trust with your customers.
4
Save Changes

Click Save changes to apply your configuration.

Configuration complete! Your store is ready to accept payments.

Getting Your API Credentials

Security Note: Never share your security token or commit it to version control. Keep it secure!

To get your API credentials from your Nexzoneo merchant account:

1
Log In to Merchant Portal

Visit payment.nexzoneo.com and log in to your merchant account.

2
Navigate to Sites Page

Go to Sites in your merchant dashboard.

3
Create or Select a Site

If you haven't created a site yet, click "Add Site" and configure it with your WooCommerce store URLs.

Important: You need to configure your site URLs before the WooCommerce plugin will work properly.
Site Configuration:
Field Value Description
Site Name My WooCommerce Store Your store's display name
Domain yourstore.com Your store's domain (without https://)
Callback URL https://yourstore.com/wc-api/nexzoneo Required Webhook endpoint for payment notifications
Return URL https://yourstore.com/?wc-api=nexzoneo_return Recommended Customer redirect after payment
Cancel URL Leave empty Optional WooCommerce handles cancellations automatically
Test Mode ✓ Enabled Enable for testing, disable for production
Critical: Replace yourstore.com with your actual store domain. Do NOT use payment.nexzoneo.com or localhost.
Example Configuration: 
Site Name: My Online Store
Domain: shop.example.com

Callback URL: https://shop.example.com/wc-api/nexzoneo
Return URL: https://shop.example.com/?wc-api=nexzoneo_return
Cancel URL: [Leave empty]

☑ Test Mode (for testing)
4
Get Your Credentials

After creating your site, click on your site name to view its credentials.

5
Copy Your Credentials

You'll see three credentials for your site:

Site Key

Site identifier for API requests

site_xxxxxxxxxxxxxxxx ✓ Starts with site_
Security Token

Private authentication token

sec_xxxxxxxxxxxxxxxx ⚠️ Starts with sec_ - Keep secret!
Webhook Secret

Webhook signature validation

whsec_xxxxxxxxxxxxxxxx ⚠️ Starts with whsec_ - For WooCommerce plugin
Test vs Live Mode
Test Mode
  • Enable "Test Mode" in your merchant settings
  • Use during development and testing
  • No real money processed
  • Can use test card numbers
Live Mode
  • Disable "Test Mode" for production
  • Use for production/real transactions
  • Real money is processed
  • Requires account verification

Testing Your Integration

Always test before going live! Use test mode to ensure everything works correctly without processing real payments.

Enable Test Mode

  1. Go to WooCommerce → Settings → Payments → Nexzoneo Pay
  2. Check the "Test Mode" checkbox
  3. Use your test site credentials (Site Key, Security Token, and Webhook Secret)
  4. Save changes

Test Payments

When test mode is enabled, no real charges are processed. Your customers will be redirected to a test payment page where they can complete test transactions safely.

Test Mode Protection: When your site is in test mode, all payment sessions are marked as test transactions. These transactions will not create real charges, will not credit merchant balances, and will not trigger real payouts.
Need Test Card Numbers? Test card availability varies by payment configuration. For specific test card numbers and testing instructions, please contact Nexzoneo IT support at support@nexzoneo.com.
Testing Best Practices:
  • Always enable test mode in your site settings before testing
  • Complete full payment flows to verify webhook delivery
  • Check WooCommerce logs to confirm order status updates
  • Test both successful and failed payment scenarios
  • Disable test mode only when ready for live transactions

What to Test

Success Scenarios
  • ✓ Complete a successful payment
  • ✓ Order status updates correctly
  • ✓ Customer receives order confirmation
  • ✓ Payment appears in Nexzoneo dashboard
  • ✓ Process a refund through WooCommerce
Failure Scenarios
  • ✓ Declined card shows error message
  • ✓ Cart items are restored on failure
  • ✓ Customer can retry payment
  • ✓ Order marked as failed
  • ✓ Stock is not reduced on failed payment
Debug Mode: Enable "Debug Mode" in the plugin settings to see detailed logs in WooCommerce → Status → Logs. Look for logs with "nexzoneo" in the filename.

Going Live

Ready to accept real payments? Follow this checklist to ensure a smooth launch.

Pre-Launch Checklist

Switch to Live Mode

1
Update API Credentials

Go to WooCommerce → Settings → Payments → Nexzoneo Pay

  • Replace test credentials with live credentials
  • Site Key: site_xxxxxxxxxxxxxxxx
  • Security Token: sec_xxxxxxxxxxxxxxxx
  • Webhook Secret: whsec_xxxxxxxxxxxxxxxx
2
Disable Test Mode

Uncheck the "Test Mode" checkbox.

3
Disable Debug Mode (Optional)

For production, you may want to disable debug logging to improve performance.

However, keeping debug mode on for the first few days can help quickly identify any issues.
4
Save and Test

Save your changes and make a small test purchase with a real card to ensure everything works.

Congratulations! Your store is now accepting live payments!
Need Help? Contact our support team at support.nexzoneo.com if you encounter any issues during the launch.

Webhook Configuration (Callback URL)

Webhooks allow Nexzoneo to notify your WooCommerce store about payment events in real-time, ensuring order statuses are always up-to-date.

What are webhooks? They're automatic notifications sent from Nexzoneo to your store when payment events occur (successful payment, refund, chargeback, etc.). In the Nexzoneo dashboard, this is configured via the Callback URL field in your site settings.

Your Webhook URL

Your webhook URL follows this format:

https://your-store.com/?wc-api=wc_gateway_nexzoneo
Replace your-store.com with your actual WooCommerce store domain.
Example: If your store is shop.example.com, use: https://shop.example.com/?wc-api=wc_gateway_nexzoneo
Important: Use your actual WooCommerce store URL, not payment.nexzoneo.com. The webhook must point to where your WooCommerce installation is hosted.

Setup Instructions

1
Log in to Nexzoneo Merchant Portal

Visit payment.nexzoneo.com and log in.

2
Navigate to Site Settings
  1. Go to Sites in your merchant dashboard
  2. Click on your site name to expand the site details
  3. Click the Settings button
3
Configure Callback URL

In the site settings form, enter your webhook URL in the Callback URL field.

Note: The Callback URL is where Nexzoneo sends payment notifications. All payment events (succeeded, failed, refunded, disputed) are automatically sent to this URL.
4
Test the Webhook

To verify the webhook is working correctly:

  1. Enable Test Mode in your site settings
  2. Create a test payment session using your API credentials
  3. Complete the test payment
  4. Check your WooCommerce logs to verify the webhook was received
If successful, your WooCommerce order status will update automatically and you'll see webhook logs in WooCommerce → Status → Logs (look for logs starting with "nexzoneo-").

Webhook Events

Event Description Order Status
payment.succeeded Payment processed successfully Processing/Completed
payment.failed Payment failed or declined Failed
payment.pending Payment is being processed (crypto) Pending
payment.refunded Refund has been processed Refunded
payment.disputed Chargeback/dispute filed On Hold
Security: Webhooks are verified using HMAC signatures. The plugin automatically validates all incoming webhooks to ensure they're from Nexzoneo.

Troubleshooting

Having issues? Here are solutions to common problems:

Possible causes:
  • Plugin is not activated
  • Nexzoneo Pay is disabled in WooCommerce settings
  • API credentials are missing or invalid
  • SSL certificate is not installed
Solution:
  1. Go to Plugins and ensure plugin is active
  2. Go to WooCommerce → Settings → Payments
  3. Verify Nexzoneo Pay is Enabled
  4. Check that API credentials are correctly entered
  5. Ensure your site uses HTTPS

Solution:
  1. Verify you're using the correct keys (test vs live)
  2. Check for extra spaces before/after the keys
  3. Ensure Site Key starts with site_ and Security Token starts with sec_
  4. Regenerate keys in your Nexzoneo dashboard if needed
  5. Contact support if keys continue to be rejected

Likely cause:

Webhooks are not configured or not reaching your site.

Solution:
  1. Check webhook configuration
  2. Verify Callback URL is set correctly in your site settings (Sites → Site Name → Settings)
  3. Create a test payment to verify webhook delivery
  4. Check WooCommerce logs for webhook errors (WooCommerce → Status → Logs)
  5. Ensure your server's firewall allows incoming webhooks

Possible causes:
  • Merchant account not approved for live transactions
  • Using test credentials instead of live credentials
  • Business verification pending
Solution:
  1. Check your merchant account status in Nexzoneo dashboard
  2. Complete any pending verification steps
  3. Verify you're using live credentials from a live site in your merchant dashboard
  4. Contact support if account should be approved but isn't working

View logs:
  1. Enable Debug Mode in plugin settings
  2. Go to WooCommerce → Status → Logs
  3. Look for log files with "nexzoneo" in the filename
  4. Click to view detailed payment processing logs
Logs include API requests, responses, webhook data, and error messages.

Cause:

Customer took too long to complete payment (session timeout is typically 15-30 minutes).

Solution:
  • Customer can simply retry checkout
  • Cart items are automatically restored in v1.0.37+ (UX enhancement feature)
  • No action needed from merchant
Still need help? Check our FAQ section or contact support.

Frequently Asked Questions

Nexzoneo Pay supports:
  • Credit Cards: Visa, Mastercard, American Express, Discover
  • Debit Cards: All major debit cards
  • Cryptocurrency: Bitcoin, Ethereum, USDT, and 50+ other cryptocurrencies
The specific payment methods available depend on your merchant account configuration and the payment providers enabled.

Transaction fees vary based on:
  • Your merchant account type
  • Transaction volume
  • Payment method used (card vs crypto)
  • Geographic location
Contact the Nexzoneo sales team for specific pricing information or check your merchant dashboard for your current rates.

Refunds can be processed directly from WooCommerce:

  1. Go to the order in WooCommerce
  2. Click the "Refund" button
  3. Enter the refund amount
  4. Check "Refund via Nexzoneo Pay"
  5. Click "Refund" to process

Processing time: Refunds typically appear in customers' accounts within 5-10 business days.

Good news: Nexzoneo handles PCI compliance for you!

Payment card data never touches your server. Customers are redirected to Nexzoneo's secure payment page, which is fully PCI-DSS Level 1 compliant. This means:

  • You don't need to be PCI certified
  • Reduced security burden on your business
  • Lower compliance costs

Nexzoneo Pay supports merchants and customers globally, with a focus on:

  • United States
  • Canada
  • United Kingdom
  • European Union countries
  • Australia & New Zealand
  • Many other countries worldwide

Contact sales to confirm support for specific countries.

The plugin offers several customization options:

  • Payment Method Title: Customize the name shown at checkout
  • Description: Add custom instructions or messaging
  • Branding: Some merchants can add custom branding (contact support)

The Nexzoneo payment page itself maintains consistent security and UX standards.

Yes! The Nexzoneo Pay plugin is designed to work with all standard WooCommerce themes and follows WooCommerce best practices.

Compatibility includes:

  • Classic WooCommerce checkout
  • WooCommerce Blocks checkout
  • Popular themes (Storefront, Astra, OceanWP, etc.)
  • Custom themes that follow WooCommerce standards

If you experience theme-specific issues, contact our support team.

Test Mode: Instant! You can start testing immediately after signing up.

Live Mode: Approval typically takes 1-3 business days, depending on:

  • Business type and documentation
  • Industry (high-risk industries may take longer)
  • Completeness of application

Ensure all required documents are submitted to speed up the process.

Support & Resources

Technical Support

Get help with integration, troubleshooting, and technical questions.

Open Support Ticket
Sales & Account

Questions about pricing, account setup, or features?

Contact Sales
Merchant Dashboard

Manage your account, view transactions, and configure settings.

Go to Dashboard
Additional Resources