WooCommerce Plugin Documentation

Everything you need to integrate Nexzoneo Pay with your WooCommerce store - from installation to going live.

Get Started Download Plugin Get Support
Current Version

1.0.37

Released: Dec 31, 2025

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.37: Enhanced user experience with native WooCommerce error handling and automatic cart restoration for failed payments.

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
  • API credentials (Public & Secret keys)
  • 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.37.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
API Public Key Your Nexzoneo public API key (starts with pk_) Yes
API Secret Key Your Nexzoneo secret API key (starts with sk_) 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 Keys

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

To get your API keys 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 API Settings

Go to Settings → API Keys or Developer → API Credentials.

3
Copy Your Keys

You'll see two types of keys:

Public Key

Used for client-side operations

pk_live_xxxxxxxxxxxxxxxx pk_test_xxxxxxxxxxxxxxxx ✓ Safe to expose in frontend code
Secret Key

Used for server-side operations

sk_live_xxxxxxxxxxxxxxxx sk_test_xxxxxxxxxxxxxxxx ⚠️ Keep this secret and secure!
Test vs Live Keys
Test Mode Keys (pk_test_ / sk_test_)
  • Use during development and testing
  • No real money processed
  • Can use test card numbers
Live Mode Keys (pk_live_ / sk_live_)
  • 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 API keys (pk_test_ and sk_test_)
  4. Save changes

Test Card Numbers

Use these test card numbers to simulate different payment scenarios:

Card Number Scenario Expected Result
4242 4242 4242 4242 Successful payment Payment Complete
4000 0000 0000 0002 Card declined Payment Failed
4000 0000 0000 9995 Insufficient funds Declined
Additional test details:
  • Use any future expiry date (e.g., 12/28)
  • Use any 3-digit CVV (e.g., 123)
  • Use any billing ZIP code

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 Keys

Go to WooCommerce → Settings → Payments → Nexzoneo Pay

  • Replace test keys with live keys
  • Public Key: pk_live_xxxxxxxxxxxxxxxx
  • Secret Key: sk_live_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

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

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 Webhook Settings

Go to Settings → Webhooks or Developer → Webhook Configuration.

3
Add Webhook URL

Enter your webhook URL and select the events you want to receive:

  • payment.succeeded - Payment completed successfully
  • payment.failed - Payment failed
  • payment.refunded - Refund processed
  • payment.disputed - Chargeback initiated
4
Test the Webhook

Use the "Send Test" button in your Nexzoneo dashboard to verify the webhook is working.

If successful, you'll see a 200 OK response.

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 keys 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 keys 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 keys start with pk_ (public) and sk_ (secret)
  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 webhook URL in Nexzoneo dashboard
  3. Test webhook using "Send Test" button
  4. Check WooCommerce logs for webhook errors
  5. Ensure your server's firewall allows incoming webhooks

Possible causes:
  • Merchant account not approved for live transactions
  • Using test API keys instead of live keys
  • 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 API keys (pk_live_ / sk_live_)
  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+
  • 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